DNF私服是如何运行的?llnut/dnf服务端架构深度解析:game、bridge、monitor等15个服务协作原理

原创2026-10-26 10:55:352,520 阅读
文章标签:游戏开发云原生DevOps运维

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 私服各服务的协作关系:

DNF私服服务端架构流程图:DNF服务端game、bridge、channel、monitor等15个服务之间的端口连接与协作关系

从图里能直观看到:玩家客户端只接触最外层的 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 个服务串起来,玩家一次登录是这样跑的:

  1. 登录器 → 网关:客户端请求 http://IP:5505,dnf-gate-server 校验 AES 密钥并认证账号(查主库 d_taiwan);
  2. 网关 → 频道:认证成功后,客户端连接 channel(7001) 获取分流信息;
  3. channel → bridge:channel 从 bridge(7000) 拉取各频道状态,挑一个合适的频道回复客户端;
  4. 客户端 → game:客户端直连目标频道的 df_game_r(如 30011),正式进入游戏;
  5. 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 个服务的分工就再也不会混淆了。

登录后查看全文
dnf