零基础管理员指南

本页假定你没有使用过命令行、Git、Node.js、IIS 或服务器。先完整阅读本页，再按链接进入具体章节。不要跳过“预演”和“验收”；看到不一致时停止操作并保存屏幕截图。

先认识五个概念

名称	通俗解释	本项目中的例子
本地开发机	写代码、编译、发起部署的电脑	C:\D2113server 所在电脑
正式服务器	玩家真正连接的电脑	109 主机、113/Web 主机
源码	人可以修改的程序文本	d2109/admin-ui/src
构建产物	源码经过编译生成的可运行文件	dist、.exe、静态网页
服务	Windows 后台持续运行的程序	D2Admin109、D2109Api、D2GS

“109”和“113”必须当成两个项目。当前正式服只启动 109 免费国度和 109 VIP 国度；113 的后台、API 和论坛可以更新，但 113 游戏服务必须保持停止。

鼠标操作与命令行

1. 按键盘 Win 键。
2. 输入 PowerShell。
3. 日常检查可打开普通 PowerShell；安装软件、服务或防火墙规则时，右键选择“以管理员身份运行”。
4. 黑色或蓝色窗口中的 PS C:\...> 是提示符，不要把它一起复制。
5. 一次只执行文档中的一条命令，等待它结束并阅读结果，再执行下一条。

路径中的反斜杠 \ 用于 Windows，例如 C:\D2113server；正斜杠 / 常用于网址和 Linux。文件夹名、空格和标点必须原样输入。

第一次检查开发机

# 显示当前所在目录；结果应为 C:\D2113server。
Get-Location
# 进入项目根目录；后续命令都从这里执行。
Set-Location C:\D2113server
# 显示 Git 版本；能看到版本号表示 Git 已安装。
git --version
# 显示 Python 版本；应为 3.11 或更高版本。
python --version
# 显示 Node.js 版本；开发环境建议使用 22 LTS。
node --version
# 显示 npm 版本；它随 Node.js 安装。
npm.cmd --version
# 查看工作区是否存在未提交修改；有输出时不要随意删除文件。
git status --short
# 只读校验部署清单和关键文件；不会连接或修改正式服务器。
python .\scripts\d2ctl.py validate
# 只读显示当前主机、版本、服务、端口和目录放置关系。
python .\scripts\d2ctl.py list

缺少 Git、Python 或 Node.js 时，按安装开发环境逐项安装。不要从不明网盘下载运行库。

选择你要做的事

目标	阅读顺序
修改管理后台页面	开发环境 → Vue 调试与编译 → 手工部署
部署一台新 Windows 服务器	Windows OpenSSH → IIS → Windows 部署
修改服务器地址、端口或论坛 URL	环境变量 → 目录与版本边界
重新安装受污染的正式机	备份与恢复 → 干净重装
日常发布	交互式向导 → 发布验收
出现 404、登录失败或连接中	故障排查

所有部署都遵守的顺序

1. 确认玩家数据和数据库备份可读。
2. 运行 git status --short，确认哪些修改将被发布。
3. 运行 d2ctl validate。
4. 先运行不带 --apply 的预演命令。
5. 核对版本、主机、目录、服务和组件。
6. 再运行带 --apply 的正式命令。
7. 检查 Windows 服务、端口、网页、API 和真实游戏登录。
8. 验收成功后才清理本次临时回滚包。

绝对不要做

• 不要双击陌生 .exe、.bat 或 .cmd。
• 不要在玩家在线时直接修改角色存档。
• 不要把 109 文件复制到 113 目录，反之亦然。
• 不要把密码、Token、数据库口令写进 Git、截图或在线文档。
• 不要让历史 Web 服务或 IIS 默认站点占用正式入口的 80 端口。
• 不要删除 D:\pvpgn\var、D:\mysql、论坛上传目录或当前 run-*.cmd。
• 不要因为目录名带 backup 就自动认定它可删除；先确认是否是唯一数据备份。

如何判断成功

命令退出码为 0 通常表示程序执行完成，但不等于业务一定正确。正式验收至少包括：109 免费玩家可登录免费国度；VIP 玩家可登录 VIP 国度；非 VIP 能看见但不能进入 VIP 国度；GM109.ZHIYESHI.CN 与 GM113.ZHIYESHI.CN 可分别登录；AH.ZHIYESHI.CN 的论坛及 109/113 页面可打开；113 游戏服务仍为停止状态。