DNF 台服服务架构深度解析:端口拓扑、服务职责与 Docker/K8s 部署实践

原创2026-10-13 12:18:361,830 阅读
文章标签:游戏开发运维后端

DNF 台服服务架构深度解析:端口拓扑、服务职责与 Docker/K8s 部署实践

本篇以仓库 doc/ArchitectureDiagram.md 为核心骨架,系统梳理《地下城与勇士》台服(DOF)服务端的全部服务组件——从可跨大区共用的 relay/stun/channel/bridge 到各大区独立部署的 auction/point/monitor/guild/game 及三类 DB 中间件 dbmw——并逐一解读其职责边界、TCP/UDP 端口流向与数据库依赖。读完本文,你将掌握台服服务端完整架构图谱、端口到进程的映射关系,并能将架构知识直接对应到仓库中的 docker-compose 部署文件 与 k8s 部署清单,理解每个端口在容器编排里是如何暴露与联通的。

一、文档背景与架构总览

doc/ArchitectureDiagram.md 是项目的"服务功能说明",它从运维与组网视角把台服服务端拆成两大族群:

  • 可共用服务:不绑定具体大区,一套服务可服务多个大区,包括 relay、stun、channel、bridge、community、coserver、manager;
  • 大区独立配置服务:每个大区(如卡恩 cain、狄瑞吉 diregie、希洛克 siroco)各自运行一套,包括 auction、point、monitor、guild、statics、game 以及 3 个 DB 中间件 dbmw_guild / dbmw_mnt / dbmw_stat。

架构原文还附带了一份官方二进制服务说明文档 台服dnf服务架构.docx 和一张端口流向流程图 process.png,本文会在此基础上结合仓库内的部署清单对每个组件做纵深展开。

DNF 台服服务架构端口流向流程图

从整体上看,这套架构的通信核心围绕几个固定端口展开:monitor:30303 是服务器组的监控汇聚点,几乎所有大区服务(auction/point/game/monitor 自身)都会向它上报;bridge:7000 负责形成分流(频道)情报档案并下发给 channel:7001;channel 再向客户端广播分流信息;而 relay:7200 与 stun:2311-2313 则是 P2P 组队链路的两条保障通路。

二、可共用服务:一套服务支撑多个大区

以下服务不区分大区,一套进程即可被所有大区共用,均需要独立执行(supervisor 管理下的独立进程)。

2.1 relay(中继服务)

relay 需要暴露外网,其职责是:当客户端之间无法建立 P2P 直连时,作为中继转发数据,保证组队/决斗等实时链路不因 NAT 打洞失败而中断。

relay:

    7200/tcp/udp
    ---->monitor:30303[将7200端口通知monitor]
  • 端口:7200/tcp + 7200/udp;
  • 上行:启动后把自己的 7200 端口上报给 monitor:30303,便于监控统一管理各组网元。

部署印证:在 basic/docker-compose.yaml 中对应端口映射为 7300:7300/tcp 与 7300:7300/udp(注释明确 df_relay_r),这是因为默认部署的希洛克大区(SERVER_GROUP=3)按大区编号规则把 relay 端口定义为 7N00(N=3 即 7300),详见下文"大区端口编号规律"。

2.2 stun(NAT 穿越服务)

stun 需要暴露外网 UDP,是 P2P 组队的关键服务:它帮助处于不同 NAT 后且相互堵塞的对等点之间建立 P2P 通讯,即经典的 UDP Hole punching(UDP 打洞) 技术。独立执行。

stun:

    2311/udp
    2312/udp
    2313/udp
  • 端口:2311/udp、2312/udp、2313/udp 三个 UDP 端口。
  • 大区编号 N 的通用规律为 2N11-2N13(如卡恩 2111-2113、狄瑞吉 2211-2213、希洛克 2311-2313),详见 doc/OtherDeploy.md。

部署印证:basic compose 中 2311-2313:2311-2313/udp(注释 df_stun_r);k8s 清单 05-dnf-server-new.yaml 中同样以 3 个独立 containerPort 暴露 2311/2312/2313(UDP)。

2.3 channel(分流信息分发服务)

channel 需要暴露外网,职责链路为:从分流中继服务器(bridge)确认分流情报,再把分流信息传送给客户端——即玩家登录后看到"哪些频道开着、各频道在线人数"的信息来源。

channel:
    7001/tcp/udp
    ----> bridge:7000
  • 端口:7001/tcp + 7001/udp;
  • 下行依赖:向 bridge:7000 拉取分流档案。

部署印证:basic compose 中 7001:7001/tcp 与 7001:7001/udp(注释 df_channel_r)。注意 README 的 2.1.7 升级说明:旧版 7200 端口在引入多大区后调整为了 7300,而 channel 的 7001 始终不变。

2.4 bridge(分流情报中心)

bridge 是整个分流体系的数据枢纽,主要职责:

  • 分流信息档案(分流开/关、在线人数)的形成和传送;
  • 从游戏服务器端收集分流资讯(分流开/关、在线人数);
  • 收集外挂玩家物品概率等资讯;
  • 死亡之塔内的排名作业;
  • 在网页上储值的 D 币变更套用。
bridge:
    7000/tcp/udp
    db:
    d_channel
  • 端口:7000/tcp + 7000/udp;
  • 数据库依赖:d_channel(分流/频道信息库)。

部署印证:虽然 basic compose 未直接映射 7000,但 cain.yaml(多大区主服)映射了 7000-7001:7000-7001/tcp|udp,注释 df_bridge_r, df_channel_r,说明 bridge 与 channel 是固定一对(7000/7001)部署的。

2.5 community(决斗场服务器)

community 是决斗场相关服务器,负责决斗场的登录、注销历史记录。

community:
    31100/tcp/udp
  • 端口:31100/tcp + 31100/udp。

2.6 coserver(防重复连接服务)

coserver 用于阻止重复连线,覆盖全部 GAME SERVER 组,独立执行。它是游戏进程侧的准入校验服务,防止同一账号/会话被多个频道重复建立连接。

coserver:
    30703/tcp/udp
  • 端口:30703/tcp + 30703/udp;
  • 在 game 的依赖清单中,game ----> coserver:30703,即每个频道进程启动时都要向 coserver 注册并接受去重约束。

2.7 manager(跨组消息服务)

manager 是管理监控程序,负责:

  • 游戏服务器邀请整个组传播消息(组播);
  • 服务器组之间传递消息(即文档所述的"纳米项目"组间通信);
  • 在团体(服务器组)中组织集体活动。
manager:
    40403/tcp/udp
  • 端口:40403/tcp + 40403/udp;
  • monitor 会向 manager:40403 上报,实现组间消息路由。

三、大区独立配置服务:每个大区一套

下列服务属于大区专属配置:在多大区部署时,每个大区独立运行一套、端口按大区编号偏移,共享的可共用服务(relay 等)除外。

3.1 auction(拍卖场服务器)

  • 游戏内以拍卖场服务器启动资讯项目时,从 db 平台带过来初始化;
  • 拍卖场服务器将得标的物品寄出,通过监控服务器(monitor)传送内容;
  • 游戏服务器结束时,收到传送的广播信号后,就会终止拍卖场的作用;
  • 游戏服务器被启动的话,拍卖场会自动运行;
  • 程序下线时,拍卖场流标的信息可能会被损毁(运维上需要注意停机时序);
  • 在网页上储值的 D 币变更套用。
auction:
    30803/tcp/udp
    db:
    taiwan_cain_2nd
    taiwan_cain_auction_gold
    ---->monitor:30303
  • 端口:30803/tcp + 30803/udp;
  • 数据库:taiwan_cain_2nd(角色/账户数据)、taiwan_cain_auction_gold(金币拍卖库);
  • 上行:向 monitor:30303 上报。

3.2 point(点券商城服务器)

point 与 auction 功能一致,区别是使用现金(D 币/CERA)进行交易,而非游戏内金币。

point:
    30603/tcp/udp
    ---->monitor:30303
    db:
    taiwan_cain_2nd
    taiwan_cain_auction_cera
  • 端口:30603/tcp + 30603/udp;
  • 数据库:taiwan_cain_2nd、taiwan_cain_auction_cera(点券拍卖库);
  • 上行:向 monitor:30303 上报。

3.3 monitor(监控与账号服务)

monitor 是大区服务器的监控中枢,职责最多:

  • 服务器组间阻止重复登入;
  • 和朋友、同伴的聊天(好友聊天路由);
  • 登陆黑名单 / 朋友、成员、公会会员黑名单确认;
  • 将连线中的球员踢下线;
  • 邮件发送时的通知功能;
  • 服务器认证;
  • 游戏结束时,DB 处理期间禁止连线;
  • 套用 burning time 活动等各种活动(游戏服务器消耗再启动);
  • 收集外挂玩家物品概率等资讯;
  • 死亡之塔内排名作业;
  • 在网页上储值的 D 币变更套用。
monitor:
    30303/udp
    ----->dbmw_mnt:20203
    ----->manager:40403
    ----->relay:7200
  • 端口:30303/udp(注意是纯 UDP);
  • 下行依赖三条:DB 中间件 dbmw_mnt:20203、组间消息 manager:40403、中继 relay:7200。

可以看到 monitor 是架构中连接面最广的服务——几乎所有独立服务(auction/point/game)都向它注册,它也同时向下游打通了数据库中间件、组间消息和中继链路。

3.4 guild(公会服务器)

guild 负责公会创立、加入、退出、解散时跨越公会服务器的套用(即公会操作的服务器端权威处理)。

guild:
    30403/tcp/udp
    ---->dbmw_guild:20403/tcp/udp
  • 端口:30403/tcp + 30403/udp;
  • 下行依赖:DB 中间件 dbmw_guild:20403/tcp|udp。

3.5 statics(统计服务器)

statics:
    30503/udp
  • 端口:30503/udp(纯 UDP),用于上报游戏内统计/外挂物品概率类数据。

3.6 game(游戏频道服务器)

game 即玩家实际进入的频道进程,职责:

  • 在 Web 认证账号后,在游戏服务器上处理 Login/Logout;
  • 地下城等级和地下城内游戏进行处理(副本逻辑);
  • 现金购买处理;
  • 创角、等级处理;
  • 出租物品处理。
game:
    用户自定义频道端口/tcp
    用户自定义频道端口/udp
    ---->monitor:30303
    ---->coserver:30703
    ---->statics:30503
    ---->guild:30403
    ---->channel:7000
    ---->auction:30803
    ---->point:30603
    ---->relay:7200
    db:
    d_taiwan
  • 端口:用户自定义频道端口(TCP+UDP,按频道编号规则生成,见下文);
  • 下行依赖多达 7 个服务:monitor(30303)、coserver(30703)、statics(30503)、guild(30403)、channel(7000)、auction(30803)、point(30603)、relay(7200);
  • 数据库:d_taiwan(游戏主库)。

部署印证:basic compose 中 30011:30011/tcp(ch.11)与 30052:30052/tcp(ch.52)即 game 频道端口,注释 df_game_r[ch.11] / df_game_r[ch.52];README 的启动日志确认进程名为 ./df_game_r siroco11 start、./df_game_r siroco52 start,一个 game 进程对应一个频道。

3.7 dbmw_guild / dbmw_mnt / dbmw_stat(三类 DB 中间件)

三个 DB 中间件职责一致,只是对接的服务器不同:

  • DB 中间件作用执行(承接上层服务与数据库之间的读写);
  • 随着 CFG 变更,分为 3 种的 DBMW(guild / monitor / statics 各配一个);
  • 服务器认证;
  • 游戏结束时,DB 处理期间禁止连线;
  • 套用 burning time 活动等各种活动(游戏服务器消耗再启动)。
dbmw_guild:
    20403/tcp/udp
    db:
    d_taiwan

dbmw_mnt:
    20203/tcp/udp
    db:
    d_taiwan

dbmw_stat:
    20303/tcp/udp
    db:
    d_taiwan
  • 端口:dbmw_guild:20403、dbmw_mnt:20203、dbmw_stat:20303(均为 TCP+UDP);
  • 数据库:三者都指向 d_taiwan,但由不同 CFG 区分各自职责范围。

至此可以画出完整的服务-端口-数据库对照表:

服务 端口 (TCP/UDP) 数据库 关键上下游
relay 7200 tcp/udp — → monitor:30303
stun 2311-2313 udp — P2P 打洞
channel 7001 tcp/udp — → bridge:7000
bridge 7000 tcp/udp d_channel ← channel:7001
community 31100 tcp/udp — 决斗场
coserver 30703 tcp/udp — 防重复连
manager 40403 tcp/udp — ← monitor:30303
auction 30803 tcp/udp taiwan_cain_2nd、taiwan_cain_auction_gold → monitor:30303
point 30603 tcp/udp taiwan_cain_2nd、taiwan_cain_auction_cera → monitor:30303
monitor 30303 udp — → dbmw_mnt:20203、manager:40403、relay:7200
guild 30403 tcp/udp — → dbmw_guild:20403
statics 30503 udp — —
game 自定义频道端口 tcp/udp d_taiwan → monitor/coserver/statics/guild/channel/auction/point/relay
dbmw_guild 20403 tcp/udp d_taiwan ← guild
dbmw_mnt 20203 tcp/udp d_taiwan ← monitor
dbmw_stat 20303 tcp/udp d_taiwan ← statics

四、数据库层:架构图的另一张"底图"

架构文档反复出现的库名,正是部署时初始化脚本要创建的对象:

  • d_channel:bridge 使用,存放分流/频道开关与在线人数情报;
  • d_taiwan:game 与三类 dbmw 共用,是游戏业务主库(角色、物品、频道数据);
  • taiwan_cain_2nd / taiwan_cain_auction_gold / taiwan_cain_auction_cera:auction 与 point 使用,分别承载角色辅助数据、金币拍卖与点券拍卖数据。

结合 doc/OtherDeploy.md 的大区代号映射表,taiwan_cain_* 属于 1 号大区卡恩(cain),而 SERVER_GROUP_DB=cain 正是为了让 GM 工具等默认连接 cain 库而引入的环境变量(README 2.1.7 升级说明中明确要求新增该变量)。大区与数据库对应关系为:1=cain/taiwan_cain、2=diregie/taiwan_diregie、3=siroco/taiwan_siroco、4=prey/taiwan_prey、5=casillas/taiwan_casillas、6=hilder/taiwan_hilder。

由于当前主流 PVF 仅开放希洛克大区,项目默认 SERVER_GROUP=3;同时多数 GM 工具连接 cain 库,因此实践中常组合使用 SERVER_GROUP=3 + SERVER_GROUP_DB=cain,这在 basic/docker-compose.yaml 的注释中亦有体现("兼容GM工具使用cain数据库")。

五、从架构图到编排:端口暴露与容器映射实战

架构文档给出的是服务间"逻辑端口",而容器编排要做的是把这些端口通过宿主机暴露出去。以 basic/docker-compose.yaml 为例,其端口映射与本文架构的对应关系如下:

ports:
  - 2000:180/tcp              # supervisor web(进程管理页)
  - 3000:3306/tcp             # mysql(对外数据库)
  - 7600:7600/tcp             # 统一登陆器
  - 881:881/tcp               # 统一网关
  - 7001:7001/tcp             # df_channel_r   ← channel:7001
  - 7001:7001/udp             # df_channel_r
  - 7300:7300/tcp             # df_relay_r     ← relay:7N00 (N=3)
  - 7300:7300/udp             # df_relay_r
  - 30011:30011/tcp           # df_game_r[ch.11]  ← game 频道
  - 31011:31011/udp           # df_game_r[ch.11]
  - 30052:30052/tcp           # df_game_r[ch.52]
  - 31052:31052/udp           # df_game_r[ch.52]
  - 2311-2313:2311-2313/udp   # df_stun_r      ← stun:2311-2313

K8s 场景则把上述端口声明为 Deployment 的 containerPort(05-dnf-server-new.yaml),再用 NodePort Service 暴露(TCP 见 06-1-dnf-service-tcp-new.yaml,UDP 见 06-2-dnf-service-udp-new.yaml)。需注意两点(详见 00-2开始一定要看注意事项.md):

  1. K8s 不支持同一个 Service 中同时暴露同一端口的 TCP 与 UDP,因此必须拆成 tcp/udp 两个 Service;
  2. NodePort 会分配随机端口,需要用 Nginx 流式反代把随机端口还原成客户端需要的标准端口,参考 nginx-proxy-k8s-svc.conf。

外网 IP 与端口还原:容器内的服务使用"逻辑端口"互相通信,但对外公告的 PUBLIC_IP 与端口需要与架构保持一致。客户端连接的是 channel(7001)、game 频道端口、relay(7N00)、stun(2N11-2N13) 等,因此无论 Docker 还是 K8s 部署,这些端口都必须原样暴露,这也是 README 中 docker run 大段 -p 参数存在的根本原因。

六、多大区部署:端口编号规律与隔离实践

理解"大区独立配置服务"后,多大区部署就非常直观:每个大区一套独立服务,端口按大区编号 N 整体偏移。doc/OtherDeploy.md 给出了三条可验证的端口规律:

  • Relay:N 号大区用 7N00(如 1=7100、2=7200、3=7300);
  • Stun:N 号大区用 2N11-2N13(如 1=2111-2113、2=2211-2213、3=2311-2313);
  • 频道端口:N 号大区 6 频道 N0006/N1006、7 频道 N0007/N1007、11-39 频道 N0011-N0039/N1011-N1039、52-56 频道 N0052-N0056/N1052-N1056(TCP/UDP 分列)。

仓库提供的多大区编排直接体现了这一规律:

  • 多台云服务器分别跑大区:卡恩 cain.yaml(SERVER_GROUP=1,relay 7100、频道 10011/11011、stun 2111-2113)、狄瑞吉 diregie.yaml(SERVER_GROUP=2,relay 7200、频道 20011/21011)、希洛克 siroco.yaml(SERVER_GROUP=3,relay 7300、频道 30011/31011);
  • 单台机器同时开三区:合并版 combine_server_group.yaml 通过三个独立 dnf 服务(dnf-cain/dnf-diregie/dnf-siroco)+ 三个独立 MySQL(3001/3002/3003)实现。

主大区/副大区配置:副大区需要知道主大区的 bridge 地址,通过 MAIN_BRIDGE_IP 指定;每个大区独立使用自己的 MYSQL_HOST/MYSQL_PORT/MYSQL_GAME_ALLOW_IP,同时 MAIN_MYSQL_* 系列变量用于连接主大区数据库完成跨区账户数据交换。

七、基于架构的排障要点

掌握架构图后,常见故障可以快速定位到对应组件:

  1. 灰频道/无法进入频道:检查 channel(7001) 与 game 频道端口的 TCP/UDP 是否在防火墙与云厂商安全组放行、PUBLIC_IP 是否可达——对应架构中 channel→bridge→game 的信息链路;
  2. 连接频道时网络中断:大概率是 GEO 拦截,日志形如 [Taiwan, GeoIP] Fail Account:18000000, IP:192.168.48.1, CountryCode:,需要按 doc/OtherDeploy.md 的指引把该 IP 插入 d_taiwan.geo_allow 白名单表后重启(insert into d_taiwan.geo_allow values ('192.168.48.1', "*", "2016-04-09 23:53:04"););
  3. P2P 组队失败:优先排查 stun(2N11-2N13/udp) 与 relay(7N00 tcp/udp) 的暴露情况;
  4. 服务启动确认:README 给出的方法是查看 /home/neople/game/log 下各频道的 Log$(date +%Y%m%d).init 文件是否出现"四国"初始化日志(GeoIP Allow Country Code : CN/HK/KR/MO/TW(CN))以及 [!] Connect To Guild Server ...、[!] Connect To Monitor Server ... 字样——这正是架构中 game→guild(30403) 与 game→monitor(30303) 两条连接的成功印证;随后用 ps -ef | grep df_game 确认 df_game_r 进程存在,或访问 supervisor 管理页(默认 PUBLIC_IP:2000)查看 dnf:game_siroco11 等进程状态。

八、结语

doc/ArchitectureDiagram.md 用一张表格勾勒出台服 DNF 服务端完整的进程拓扑:可共用的 7 个基础服务负责组网、中继、分流与决斗场;大区独立的 9 类服务负责拍卖、点券、监控、公会、统计、游戏频道与数据访问;而 3 个 dbmw 中间件把上层服务与 d_taiwan 等业务库解耦。将这张逻辑拓扑对照仓库的 docker-compose / k8s 清单,即可在部署、扩容、排障时精确回答"这个端口是谁、它在跟谁通信、挂了影响什么"。

更深入的部署细节(大区代号映射表、外网 IP 的五级配置优先级、站库分离、K8s 部署)可继续阅读 doc/OtherDeploy.md、doc/Kubernetes.md 与 README.md。

登录后查看全文
dnf