DNF私服是如何运行的?llnut/dnf服务端架构深度解析:game、bridge、monitor等15个服务协作原理
DNF私服是如何运行的?llnut/dnf服务端架构深度解析:game、bridge、monitor等15个服务协作原理
想搞懂 DNF 私服是怎么跑起来的吗?本文以开源项目 llnut/dnf(DNF 容器版服务端,基于清风-1031 版本)为例,带你用大白话看懂 DNF 服务端架构:game、bridge、monitor 等 15 个服务各自负责什么、如何互相协作,以及玩家一次登录背后的完整链路,最后附最小部署步骤和排查清单,帮助你快速上手 DNF 私服服务端。
一、先建立全局认知:DNF 私服不是一两个进程
很多新手以为"开服"就是启动一个 game 进程,实际上 DNF 服务端是一个服务集群。llnut/dnf 项目把整集群封装进一个 Docker 镜像(支持 Debian 13 / Alma 9 / Ubuntu 26 / CentOS 7 四种基础镜像),用容器内的 s6 服务管理器统一拉起、监控和自动重启所有服务。
整个集群可以分成两类:
- 可共用服务:relay、stun、channel、bridge、community、coserver、manager,多个大区可以共享;
- 大区独立服务:game、monitor、guild、statics、auction、point 以及 3 个 dbmw 数据库中间件,每个大区(如卡恩 cain、希洛克 siroco)各自一套。
完整的端口与依赖关系,官方整理在 doc/ArchitectureDiagram.md 和 台服dnf服务架构.docx 中。下图就是 DNF 私服各服务的协作关系:
从图里能直观看到:玩家客户端只接触最外层的 4 类服务(stun、relay、channel、game),而 game 向下又依赖 monitor、guild、auction、dbmw 等一整片服务,最底层统一落到 DBMS(MySQL)。
二、15个服务职责一览:谁管登录、谁管聊天、谁管拍卖
| # | 服务 | 进程名 | 默认端口 | 职责一句话 |
|---|---|---|---|---|
| 1 | game | df_game_r |
30011/31011… | 游戏本体:创角、副本、战斗、物品 |
| 2 | bridge | df_bridge_r |
7000 | 分流中枢:汇总各频道在线状态、D币变更、排名 |
| 3 | channel | df_channel_r |
7001 | 分流入口:把"哪个频道有空"告诉客户端 |
| 4 | monitor | df_monitor_r |
30303 | 大区总管:防重复登录、跨服聊天、邮件通知、服务器认证 |
| 5 | guild | df_guild_r |
30403 | 公会创建、加入、解散的跨服套用 |
| 6 | statics | df_statics_r |
30503 | 统计类数据服务 |
| 7 | community | df_community_r |
31100 | 决斗场登录、注销与历史记录 |
| 8 | coserver | df_coserver_r |
30703 | 全组防重复上线检查 |
| 9 | auction | df_auction_r |
30803 | 金币拍卖行,随 game 自动启停 |
| 10 | point | df_point_r |
30603 | 点券寄售(现金交易,区别于金币拍卖) |
| 11 | relay | df_relay_r |
7300 | P2P 中继:客户端连不上时的中转站 |
| 12 | stun | df_stun_r |
2311-2313 | P2P 打洞:组队时的 UDP 穿透服务 |
| 13 | manager | df_manager_r |
40403 | 服务器组间消息传递(跨服喊话等) |
| 14 | dbmw | dbmw_mnt / dbmw_stat / dbmw_guild | 20203/20303/20403 | DB 中间件×3:替对应服务操作 MySQL |
| 15 | dnf-gate-server | dnf-gate-server |
5505 | 登录网关:账号注册/登录/Web 认证(本项目新增) |
💡 端口规律很好记:大区 N 的 relay 是
7N00,stun 是2N11-2N13,频道 TCP 是N0011、UDP 是N1011。完整对照表见 doc/OtherDeploy.md 的"各大区端口"章节。
三、核心服务详解:抓住这条主线就懂了
1️⃣ game:真正的"游戏世界"
每个频道对应一个 df_game_r 进程(如 df_game_r siroco11)。Web 认证通过后,创角、等级、副本、现金购买、物品出租全在它这里处理。它启动后会主动"拉群":连接 monitor(30303)、coserver(30703)、statics(30503)、guild(30403)、auction(30803)、point(30603)、relay(7300),并读写主数据库 d_taiwan。
2️⃣ bridge + channel:分流"双子星"
- bridge 定期从各 game 收集"分流开/关、在线人数",形成分流档案,还负责 D币变更套用和死亡之塔排名;
- channel 对外只干一件事:客户端来问"去哪个频道",它找 bridge(7000) 拿最新分流情报再回复客户端(7001)。
这就是为什么进游戏前要先连 7001 端口——先问路,再上车。
3️⃣ monitor:大区的"总管"
monitor 是职能最多的服务:服务器组间阻止重复登录、跨服聊天、黑名单确认、踢人下线、邮件通知、服务器认证,以及"游戏维护时禁止连线"。它向下连 dbmw_mnt(20203) 操作数据库,横向连 manager 和 relay。
4️⃣ relay + stun:P2P 组队的双保险
玩家组队走 P2P 直连。stun 负责 UDP 打洞(hole punching),连不通时 relay 兜底中转。这两个服务都独立运行、需要暴露外网 UDP。
5️⃣ dbmw:数据库前的"守门员"
3 个 dbmw 实例分别服务 monitor、statics、guild。游戏结束时 DB 处理期间禁止连线、活动套用等逻辑都在这一层,让服务不直接裸连 MySQL。
6️⃣ dnf-gate-server:本项目新增的登录网关
区别于原版,llnut/dnf 内置了 Rust 编写的登录网关,监听 5505(可选 HTTPS 5504),负责账号注册、登录认证和公私钥安全校验。它启动时会为服务端生成全新的游戏公私钥,安全性更高(详见 README.md 常见问题 19)。
四、一次登录的完整链路:从点击登录到进入频道
把 15 个服务串起来,玩家一次登录是这样跑的:
- 登录器 → 网关:客户端请求
http://IP:5505,dnf-gate-server 校验 AES 密钥并认证账号(查主库d_taiwan); - 网关 → 频道:认证成功后,客户端连接 channel(7001) 获取分流信息;
- channel → bridge:channel 从 bridge(7000) 拉取各频道状态,挑一个合适的频道回复客户端;
- 客户端 → game:客户端直连目标频道的
df_game_r(如 30011),正式进入游戏; - game 拉群协作:副本、公会、拍卖、聊天等请求由 game 转发给 guild、auction、monitor 等对应服务,最终经 dbmw 落库 MySQL。
五、如何快速部署:一条命令跑起 DNF 私服
llnut/dnf 采用单容器一体化部署,游戏服务端 + MySQL 全在容器里,官方推荐 1 核 1G 起步(--shm-size 不可省):
docker run -d -e PUBLIC_IP=x.x.x.x \
-e DNF_DB_ROOT_PASSWORD=88888888 \
-e GATE_AES_KEY=<64位hex密钥> \
-p 5505:5505/tcp -p 7001:7001/tcp -p 7001:7001/udp \
-p 30011:30011/tcp -p 31011:31011/udp \
--cpus=1 --memory=1g --shm-size=1g --name=dnf \
llnut/dnf:debian13-qf1031-latest
完整参数、Docker 29 的 seccomp 兼容规则(否则报 Could not create a UDP socket : 38)都在 README.md 和 doc/PrepareLinux.md 里。也可以直接套用现成的 compose 文件,比如 deploy/dnf/docker-compose/basic/docker-compose.yaml。
服务端启动约 1 分钟,看到所有开启频道的就绪日志即成功:
s6-rc: info: service game_siroco11 successfully started
s6-rc: info: service game_siroco52 successfully started
六、DNF服务端启动失败排查清单 ⚠️
| 症状 | 常见原因与解法 |
|---|---|
卡在 Init DataManager 循环 |
内存/swap 不足,把 --shm-size 调到 2g 或 10g |
| 大量服务频繁重启,报 UDP socket : 38 | Docker 29 seccomp 变更,按 doc/PrepareLinux.md 配置兼容 profile |
长时间没有 game_sirocoXX 日志 |
docker exec dnf s6-rc -a list 看服务状态,tail -f /data/log/game_siroco11/current 看频道日志 |
| 点登录没反应 | 登录器服务器地址(IP:5505)与 AES 密钥必须和服务端一致 |
| 进频道时网络中断 | 多半是 geo 白名单拦截,把被拦 IP 加入 d_taiwan.geo_allow(本项目已内置定时自动更新) |
| 服务被 OOM 杀死 | docker restart dnf;单服务可用 docker exec dnf s6-svc -r /run/service/<服务名> 重启 |
七、进阶部署:多频道、多大区、端库分离
- 多频道:设置
OPEN_CHANNEL='1-11,12,22-25'即可在同一容器开多个频道,参考 deploy/dnf/docker-compose/multi_channel/; - 多大区:一台或多台机器同时跑卡恩/狄瑞吉/希洛克,各大区服务独立、relay/stun 端口按大区编号区分,示例见 multi_server_group 下的 cain.yaml、siroco.yaml 等;
- 端库分离:游戏服务端与 MySQL 拆成两个容器,便于数据库独立备份扩容;
- Kubernetes:提供 StatefulSet、Service、nginx 代理等全套清单,入口文档是 deploy/dnf/k8s-deploy/00-1开始一定要看前期准备.md。
所有部署模式与环境变量总表(SERVER_GROUP、CLIENT_POOL_SIZE、性能自调优等)都汇总在 doc/OtherDeploy.md。
写在最后
看懂 DNF 私服的关键,就是抓住"channel 问路 → game 承载 → monitor 协调 → dbmw 落库"这条主线:bridge/channel 负责分流,game 承载游戏世界,monitor/guild/auction 等各司其职,stun/relay 兜底 P2P,最后统一交给 MySQL。llnut/dnf 把这些原本分散的服务打包成一个容器,环境变量即配置,这也是它相比传统部署最大的便利。建议配合 doc/ArchitectureDiagram.md 的端口依赖图和上文的协作流程图对照阅读,15 个服务的分工就再也不会混淆了。
