安装与更新

7DPanel 以 Mod 形式运行在七日杀专用服务器内。只有部署包包含已构建的前端（wwwroot/index.html）时，才能打开浏览器管理界面。用户指南是独立的静态站点，不属于 Mod 发布包。

安装前

• 使用受支持的 x86-64 专用服务器宿主机：Windows Server 2016+、Windows 10+ 或 Ubuntu 22.04+。
• 保持游戏自带的 0_TFP_Harmony Mod 启用。
• 获取经过验证、同时包含 ModInfo.xml、Mod 程序集和 wwwroot/index.html 的 7DPanel 发布包。

安装发布包

1. 将整个已验证的发布包复制到 <服务器根目录>/Mods/7DPanel/。不要只复制主 DLL。
2. 启动或重启专用服务器。首次启动时，7DPanel 会创建 Mods/7DPanel/data/config.json 和运行数据。
3. 若沿用默认监听设置，在浏览器打开 http://<服务器地址>:8088/。使用实际主机名或地址，不要使用 listenUrl 中表示通配监听的 +。
4. 在将端点开放给非可信网络前，先完成首次登录。

若页面无法打开，先检查服务器日志中 Mod 的启动错误，再查看故障排查。

更新现有安装

1. 独立备份已安装的 Mods/7DPanel/data/ 目录。这里包含凭据、机器密钥和应用数据。
2. 将新的已验证发布包部署到 Mod 程序文件位置，并保留原有 data/ 目录。
3. 重启游戏服务器以加载新程序集，然后登录并检查概览。

旧配置需要将 hostUrl 改名为 listenUrl 并保留地址，参见面板连接设置。当前内部开发版的商店数据库结构存在破坏性变更，未提供兼容迁移。升级现有安装前应确认数据库兼容性及该版本的迁移说明；仅保留备份不会让旧商店结构兼容。

自行构建发布包的服主可使用仓库中的发布与部署脚本。脚本要求明确指定部署目标，也不能代替对 data/ 的独立备份。