服务器架构文档
按实际部署结构描述:两个独立游戏区(A 区 / B 区)+ 一套两区共用的共享平台。 每个游戏区内自成一套完整进程,区内自注册、自控制;只有跨区与登录相关的能力才落到共享平台。
一、整体结构
客户端
├─ 进入 A 区 ────────────→ A 区 GatewayServer
├─ 进入 B 区 ────────────→ B 区 GatewayServer
└─ 登录 / 跨区重新登录 ──→ FLServer(共享平台)
- A 区、B 区:两个独立的游戏区,各自拥有 Gateway / Scenes / Bill / Session / Mini / Record / Super 全套进程,区内闭环,互不直连。
- 共享平台:RoleRegServer、RoleChangeServer、UserServer、FLServer、InfoServer、DBAccessServer 六个进程 + 共享迁移票据表,A、B 两区共用。
二、进程清单
2.1 区内进程(A 区、B 区各一套,结构完全对称)
| 服务器 | 职责 | 数量 | 端口 / 配置 |
|---|---|---|---|
| GatewayServer | 客户端接入,把客户端请求转发给区内各服务 | × N | extPort,由 SERVERLIST 表配置 |
| ScenesServer | 地图与角色逻辑 | × N | 动态分配(仅内网) |
| BillServer | 区内计费与交易 | 1 | 9967 |
| SessionServer | 区内全局业务 | 1 | 动态分配 |
| MiniServer | 小游戏 | 1 | 动态分配 |
| RecordServer | 角色档案 | 1 | 动态分配 |
| SuperServer | 区内注册与控制:区内各进程向它注册,由它统一管控 | 1 | 10000(仅内网) |
2.2 共享平台进程(A、B 两区共用)
| 服务器 | 职责 | 端口 / 配置 |
|---|---|---|
| RoleRegServer | 全区名字登记:角色名在 A/B 两区唯一 | 内网 |
| RoleChangeServer | 跨区角色中转:签发、撤销迁移票据并记录终态 | 内网 |
| UserServer | 点数与平台计费:查询、扣费、充值,对外提供 HTTP API | HTTP API 端口 |
| FLServer | 登录入口:登录、跨区重新登录、服务器列表下发 | 7000 登录 / 7001 内部 / 7002 ping |
| InfoServer | 统计与 GM | 内网 |
| DBAccessServer | 账号认证与资料(external 认证模式) | 内网 |
| 共享迁移票据表 | 跨区票据落库,签发后由登录侧校验并消费 | 数据库表 |
三、连接拓扑
3.1 单个游戏区内部(A 区、B 区结构一致)
实线是业务调用,虚线是向本区 SuperServer 注册。区内的链路到此为止,不出现其他区的进程。
3.2 两区与共享平台
图中 A 区、B 区只列 SuperServer,其余区内进程见 3.1。区内进程与共享平台的交互都经本区 SuperServer 发起,唯一例外是 BillServer 直接向 UserServer 查点数、扣费(见 4.5)。
四、连接关系说明
4.1 区内(以 A 区为例,B 区同构)
GatewayServer是区内唯一入口:向下连 ScenesServer、SessionServer、MiniServer、RecordServer、BillServer,同时向本区 SuperServer 注册。ScenesServer依赖 SessionServer(全局业务)、MiniServer(小游戏)、RecordServer(档案),并向 SuperServer 注册。SessionServer → RecordServer:全局业务读写角色档案。- SuperServer 只是区内的注册与控制中心:Gateway、Scenes、Session、Mini、Record、Bill 全部向本区 SuperServer 注册,由它统一下发控制指令。A 区进程不会直连 B 区进程。
4.2 客户端侧
- 客户端按区选入口:
进入 A 区连 A 区 GatewayServer,进入 B 区连 B 区 GatewayServer。 - 登录与跨区后的重新登录走共享的
FLServer(登录端口 7000)。
4.3 登录链路
- 客户端连
FLServer:7000登录,FLServer以 external 认证模式调用DBAccessServer完成账号认证与资料校验。 - 登录成功后
FLServer下发服务器列表,客户端据此连对应区的 GatewayServer。
4.4 跨区链路
- 角色跨区由
RoleChangeServer中转:签发迁移票据写入共享迁移票据表,角色从原区迁出、在目标区迁入。 - 客户端跨区后重新登录,
FLServer校验并消费该票据,完成落地。 RoleChangeServer把迁移终态记录到InfoServer;RoleRegServer负责全区名字登记,保证角色名在两区之间唯一。- 两个区的 SuperServer 分别与 RoleReg、RoleChange 交互,区内不感知对方的内部进程。
4.5 计费与统计
BillServer只负责区内计费与交易;点数余额这类跨区资产由UserServer统一持有,BillServer 向它查询点数并扣费。UserServer的统计数据上报InfoServer,该上报可通过配置关闭。
五、与旧版文档的差异
| 旧版描述 | 实际结构 |
|---|---|
| SuperServer 是全局中心节点 | SuperServer 只是区内注册与控制中心,A/B 两区各一个 |
| 共 9 个服务器 | 区内 7 类进程 × 2 个区 + 共享平台 6 个进程 + 共享迁移票据表 |
| 没有 RoleReg / RoleChange / DBAccess / Info | 这四个属于共享平台,是跨区与登录的关键链路 |
| 缺少两区划分 | 两个独立游戏区,只有共享平台与票据表共用 |
| FLServer 连 SuperServer | 方向相反:区内 SuperServer 向 FLServer 注册,客户端登录直连 FLServer |