交互式部署向导

d2ctl 是管理员的统一入口。直接运行且终端可交互时会进入向导；原有非交互命令仍可用于发布流水线。主机拓扑读取 deploy/realms/catalog.json，109/113 运行配置分别读取 d2109/deploy/runtime.json 与 d2113/deploy/runtime.json。

启动向导

# 进入项目根目录，确保向导能找到 deploy/realms 配置和各部署脚本。
Set-Location C:\D2113server
# 启动交互式部署向导；该步骤本身不会连接服务器。
python .\scripts\d2ctl.py

也可以显式使用 wizard：

# 显式启动同一个交互式向导，适合写入管理员桌面快捷方式。
python .\scripts\d2ctl.py wizard

可选模式

模式	实际范围	是否影响游戏
只读校验	清单、API 环境、论坛入口、通知配置和部署文件	否
游戏核心	PvPGN、D2CS、D2DBS 和主 GS	会按安装器记录停止并恢复相关服务
GS 实例	109/113 的免费、VIP 或两者	仅所选 GS；部署器会备份并验收
Realm API	109、113 或两者	不迁移角色，不主动切换国度
论坛	两版独立 PHP 目录和通知配置	否
管理后台	Vue 静态资源和 Node 网关	否
在线文档	/docs/ 静态站和对应 IIS 应用配置	否
完整 Web	当前活动版 API、两个独立后台、论坛和 80 入口	不停止或切换游戏核心
组合部署	按管理员选择组合上述组件	取决于是否包含游戏核心或 GS
正式版本切换	109 与 113 活动服务集合	是

双重确认

向导先打印完整命令但不执行。核对版本、主机、实例和组件后，只有准确输入大写 APPLY 才会连接正式服务器。直接回车、输入其他内容或按 Ctrl+C 都会取消。

非交互模式

# 只打印 109 免费与 VIP GS 的部署计划，不连接远端。
python .\scripts\d2ctl.py deploy 109b --component gs --instance all
# 正式部署 109 免费与 VIP GS；执行前必须先核对上一条计划。
python .\scripts\d2ctl.py deploy 109b --component gs --instance all --apply
# 只打印当前 109 API 和在线文档的组合部署计划；不会部署 113 游戏服务。
python .\scripts\d2ctl.py deploy 109b --component api --component docs
# 正式执行当前 109 API 和在线文档组合部署；109 API 会同时维护 VIP 系统 Agent。
python .\scripts\d2ctl.py deploy 109b --component api --component docs --apply

WARNING

web 聚合组件已经删除。API 和后台必须指定 109 或 113；论坛与文档单独发布。当前只运行 109 游戏，维护 113 后台时不得发布或切换 113 游戏服务。