部署总览

新的 Ubuntu 多版本/多国度部署请使用 Rust 网关 Docker 部署包。8.137.127.175 已部署双版本后台和全新论坛，见 Ubuntu 后台与新论坛；GameAgent 和游戏栈尚未部署。下文 Windows 安装入口保留供旧环境维护。

第一次部署请使用图形化离线部署工具。管理员只需要把完整部署 ZIP 和对应版本客户端上传到目标服务器，完整解压后以管理员身份运行 CNBN-D2-Deployment-GUI.exe。服务器不需要预装 Python、Node.js 或 PHP。

推荐入口

操作场景	阅读顺序
空白 Windows 服务器	零基础管理员指南 → 图形化离线部署 → IIS 安装与使用
更新已有国度	图形化离线部署 → 发布、回滚与验收
中心服务与多台 GS	图形化离线部署 → 手工部署与多 GS
服务器残留多个历史版本	正式服务器干净重装 → 图形化离线部署
Linux 测试或灾备	Linux / Docker

标准原则

• 一台主机只部署它实际承载的组件；多主机部署时，每台主机分别运行 GUI，再通过网络参数连接。
• 每个国度必须使用独立实例 ID、安装目录、监听端口、配置和备份目录。
• 109 与 113 的 API、后台、论坛执行文件、消息模板和运行时必须分开，不能引用公共 API 或公共 PHP 文件。
• D2GS 必须使用与所选版本一致的客户端和组件包。不同存档格式不能通过删除版本检查强行兼容。
• 第一次部署和每次更新都先执行预检、导出计划，再正式部署。
• 密码、API 写令牌、论坛内部令牌和 D2GS 管理密码只保存在实例配置或受保护环境中，不写进源码和教程。

离线包支持范围

GUI 可描述 1.09b 至 1.14d 的常见版本。标准离线包内置当前项目已经验证的 109b 与 113c 成品；其他版本需要另行提供带精确版本清单的组件包。缺少组件、客户端或运行时会在预检阶段停止，不会带病复制。

旧命令行工具

d2ctl 仅保留给开发人员、自动化流水线和历史恢复，不再作为运营人员的默认部署入口。日常部署不需要安装 Python，也不需要输入 d2ctl 命令。历史脚本说明见旧版命令行向导。

发布单位

BNetD、D2CS、D2DBS 与 D2GS 的协议和连接参数必须成组核对。API 可以独立更新；论坛和后台也可以分开更新，但新接口上线时应按“API、论坛、后台”的顺序部署并逐项验收。

当前正式环境若仍执行“只运行 109 免费和 VIP 国度、113 只更新不启动”的运营规则，部署工具不会替管理员猜测该规则。保存正式配置时必须只勾选需要更新的 113 Web 组件，不得勾选或启动 113 游戏组件。