DNF 台服服务架构深度解析:端口拓扑、服务职责与 Docker/K8s 部署实践
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,本文会在此基础上结合仓库内的部署清单对每个组件做纵深展开。
从整体上看,这套架构的通信核心围绕几个固定端口展开: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):
- K8s 不支持同一个 Service 中同时暴露同一端口的 TCP 与 UDP,因此必须拆成 tcp/udp 两个 Service;
- 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_* 系列变量用于连接主大区数据库完成跨区账户数据交换。
七、基于架构的排障要点
掌握架构图后,常见故障可以快速定位到对应组件:
- 灰频道/无法进入频道:检查 channel(7001) 与 game 频道端口的 TCP/UDP 是否在防火墙与云厂商安全组放行、PUBLIC_IP 是否可达——对应架构中 channel→bridge→game 的信息链路;
- 连接频道时网络中断:大概率是 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");); - P2P 组队失败:优先排查 stun(2N11-2N13/udp) 与 relay(7N00 tcp/udp) 的暴露情况;
- 服务启动确认: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。
