DNF90 极速一键部署与运维管理平台

一键安装入口

生产就绪

curl -sSL https://YOUR-HOST | bash

💡 在目标 Linux 服务器（Debian / Ubuntu / Rocky 等）root 终端中直接粘贴执行即可。脚本自动安装 Docker、初始化运行目录并引导配置。

专属服务管理控制台 (dnf90-admin.sh)

中文向导 · 15项集成运维

部署成功后，系统会在 /root/dnf90-admin.sh 和项目脚本目录下常驻可视化管理入口，直接运行即可打开专属向导面板：

/root/dnf90-admin.sh

==================================================

DNF90 服务管理控制台 (管理向导)

==================================================

【服务运行控制】

1) 启动服务（启动服务端与网关，开放登录）

2) 停止服务（暂停玩家登录与游戏服务）

3) 重启服务（重新加载容器环境与网关）

4) 查看状态（检查各容器实时运行状态）

【热更与版本升级】

5) 更新服务版本（自动备份数据，拉取新镜像并热更）

6) 仅拉取新镜像（预下载镜像，暂不重启服务）

7) 重载游戏资源（热更 Script.pvf / channel_info.etc） [NEW]

【数据库备份容灾】

8) 备份游戏数据（全量导出 .sql.gz 带 SHA-256）

9) 恢复游戏数据（从备份还原，带校验与安全保护）

【排错体检与维护】

10) 查看运行日志（实时跟随或翻查历史日志）

11) 全系统环境体检（配置、Docker、必要文件综合诊断）

12) 端口监听与网络诊断（检查对外端口与登录地址） [NEW]

13) GM 管理凭据同步（校验网关与服务端通信 Token） [NEW]

14) 查看版本与镜像 Tag

15) 清理历史过期日志（释放磁盘存储空间） [NEW]

0) 退出

==================================================

请选择 [4]: _

服务端平滑更新说明

无损升级 · 资产零丢失

服务端采用数据与容器彻底解耦的架构设计：玩家账号、游戏角色数据（runtime/database/）、密钥凭证以及 PVF 资源均持久化保存在宿主机。升级过程绝不影响游戏已有数据资产。

方案 A 再次执行一键命令（小白推荐，全自动识别环境）

当发布端发布新版本后，直接在服务器上再次运行初始一键指令：

curl -sSL https://YOUR-HOST | bash

智能检测识别：向导检测到已有安装时，会自动弹出选项：
[1] 保留现有安装并更新（默认推荐）：拉取最新镜像平滑重建容器，完整保留数据库、配置和 PVF；
[2] 备份后覆盖安装：自动先将当前数据库导出备份，随后清空重装；
[3] 退出。

方案 B 命令行精准热更新（运维推荐，支持指定版本）

通过 dnf90-admin.sh update 系列命令，享受秒级热更体验：

一键更新全部服务到最新版本（更新前自动执行数据库快照）：

/root/dnf90-admin.sh update all latest

仅热更网关组件（游戏服务端与数据库不重启，玩家不掉线）：

/root/dnf90-admin.sh update gateway latest

更新前自动全量快照

每次执行更新前，系统默认自动导出完整 SQL 压缩包并计算 SHA-256 哈希存至 backups/，出现任何意外均可一秒回滚。

原子版本替换机制

只有当新镜像成功拉取并且容器通过健康检查后，才会更新 .env 配置文件中的版本 Tag，避免故障镜像破坏环境。

版本快速回滚支持

若新版本镜像存在兼容问题，只需重新指定旧版本 Tag（如 update all v1.0.0），系统会自动重新部署历史稳定版。

游戏资源 (PVF) 与频道配置热更

日常热更

🎒 更新 Script.pvf 文件

更新客户端补丁、道具装备或技能模型时，将新的 Script.pvf 上传覆盖到宿主机路径：

/opt/dnf90/runtime/server/data/dnf/Script.pvf

上传后执行专属重载指令，服务端自动重新加载 PVF 资源并校验：

/root/dnf90-admin.sh reload-pvf

⚙️ 修改频道配置 channel_info.etc

用于配置频道名称、线路划分、公开 IP 与经验倍率：

/opt/dnf90/runtime/server/config/channel_info.etc

修改完成后执行热重载生效：

/root/dnf90-admin.sh reload-pvf

常用运维指令速查清单

CLI 命令速查

启动全部服务启动

启动 MariaDB、游戏服务端及网关容器

/root/dnf90-admin.sh start

停止全部服务停止

优雅停止各服务容器，安全落盘数据库

/root/dnf90-admin.sh stop

重启全部服务重启

按依赖顺序重启服务端和网关容器

/root/dnf90-admin.sh restart

查看运行状态状态

实时查看容器状态、健康自检及是否可登录

/root/dnf90-admin.sh status

热重载 PVF 与频道热更

无需停库，快速重启 server 容器重载资源

/root/dnf90-admin.sh reload-pvf

全组件版本更新升级

自动备份数据库后，拉取新镜像并热更重启

/root/dnf90-admin.sh update all latest

仅更新网关组件升级

单独更新网关，游戏服务和数据库不重启

/root/dnf90-admin.sh update gateway latest

预下载新版镜像预下载

提前在后台拉取镜像，完全不重启任何服务

/root/dnf90-admin.sh pull all latest

全量导出数据库备份

导出完整 .sql.gz 压缩备份并计算 SHA256

/root/dnf90-admin.sh backup

还原数据库备份恢复

恢复前自动备份当前库，校验哈希防损坏

/root/dnf90-admin.sh restore BACKUP.sql.gz

实时追踪服务端日志日志

实时查看服务端输出（按 Ctrl+C 退出）

/root/dnf90-admin.sh logs server -f

查看网关日志日志

翻查网关最新 200 行输出，定位鉴权与网络

/root/dnf90-admin.sh logs gateway --tail 200

一键全系统体检体检

检测配置完整度、Docker状态、磁盘及密码

/root/dnf90-admin.sh doctor

端口监听诊断网络

排查 7000/13306/18111 等关键网络端口

/root/dnf90-admin.sh ports

GM 管理口鉴权同步安全

校验并同步网关与服务端的内部 GM Token

/root/dnf90-admin.sh admin-sync

清理历史过期日志磁盘

安全清理超过 7 天的历史日志与压缩包

/root/dnf90-admin.sh clean-logs

主机配置建议

架构：Linux amd64 (x86_64)
推荐系统：Debian 12 / Ubuntu 22.04+ / Rocky Linux 9
硬件配置：建议 4 核 CPU / 8GB 内存以上（最低 2 核 4G）
网络模式：Host 网络模式（支持游戏动态端口分配与 UDP 组队中继）
安全架构：管理口绑定 127.0.0.1，不对公网开放，防扫描爆破

自动化处理流程

环境与依赖就绪

自动检测/安装 Docker & Compose，校验安装器完整性。

参数交互向导

自动探测公网 IP，交互生成网关管理密码与数据库凭证。

上传 PVF 启动

放入 Script.pvf 后一键启动服务端并完成健康检查。