网络抽象与传输内核
本文说明当前网络原语及其目标边界。目标角色为 gateway、loginServer、baseServer、worldServer、cell、database、machined;World 管理 Space/Cell,cell 执行模拟与 Instance,长期资料与存储分别归 Base 和 database。库原语测试通过,不等于完整玩法、跨服恢复或不停机发布已经完成。
执行摘要
游戏逻辑通过明确的消息、关联 ID 和执行边界使用网络。传输到达、业务受理、模拟执行和持久确认分别表达。进程间沿用 M1 链路与契约路由,不增加平行的业务总线;客户端连接由 Gateway 持有。
1. 当前实现
| 部件 | 位置 | 已有能力与边界 |
|---|---|---|
| TCP 底座 | modules/net/tcp | socket、reactor 和相关消息原语 |
| M1 链路 | modules/net/link | 握手、心跳、seq/ack、路由分发、水位、重连与对端重启事件 |
| RPC | modules/net/linkrpc | 请求关联、响应、超时;不能代替业务去重 |
| 会话门面 | modules/net/gameconnection | 四通道、优先级、投递队列和恢复窗口;仍需与实际业务会话链路验收 |
| 契约编码 | modules/net/contract_wire | 按生成路由表编码/解码字段 |
| 应用编码 | modules/protocol | 当前部分应用仍使用 MessageCodec,M1 入口存在契约与应用帧转换 |
| 出站 HTTP | modules/net/http | CMake 必需 libcurl 并设置 APOLLO_HAS_CURL=1;不等于全部业务已接出 |
| 客户端接入 | apps/gateway | TCP 入口、准入、路由查询与 World 意图出口原型 |
契约 XML/XSD、生成器及 .proto 产物已经存在。protobuf/zstd 是否进入真实玩法路径,必须另行验证,不能从依赖或产物推断。
2. 游戏逻辑接口
GameConnection 门面提供 send、subscribe、state、close。发送结果区分 kAccepted、kTrimmedLow 和 kBackPressured。入队成功不等于对方执行成功。
应用按契约校验身份、参数、会话及玩家权威代次,不向客户端开放任意实体写入或任意服务器寻址。Gateway 与 World 的现役业务链路仍需完成完整副本结果和状态下行接线。
3. 分层与线程
- L0 负责传输,不决定玩法准入和奖励。
- L1 负责帧、契约编码与分发。
- L2 负责会话、序号、恢复窗口和有界队列。
- L3 面向逻辑层提供消息接口。
IO 与后台线程只交接意图或完成结果;Scene/Instance 的模拟写入归所属逻辑线程。WorldApp 使用有界 AcceptanceQueue,在 gameLoop 的固定位置执行意图。不能在负责泵送的线程上同步等待同一链路的 RPC。
GameConnection 库的入站队列目前具有丢旧统计;它不能据此宣称业务可靠投递。业务入口须明确过载失败与回执策略,避免将低层丢弃行为用于不可丢的结算或权威切换。
4. QoS 与背压
4.1 四通道
| 通道 | 规则 |
|---|---|
| movement | 易弃,同消息 ID 保留最新输入/状态 |
| attributes | 有序可靠;低优先级状态允许按声明裁剪 |
| events | 不可任意丢弃的事件;容量不足需要背压 |
| control | 独立小预算,避免被大流量挤占 |
客户端通道策略与进程间链路策略不能混同。链路只识别 Control、Reliable、Droppable 分类,不根据玩法重要性擅自删除已排队的可靠业务消息。
4.2 四级水位
默认链路容量为 4 MiB,控制预算为 16 KiB;占用阈值为 soft 50%、hard 75%、cut 95%。soft 起拒绝新的 Droppable;cut 起拒绝新的 Reliable,控制帧仍受独立预算约束。cut 持续时间超过上限后关闭链路。
发送方必须处理背压,不能无限重试、无限缓存或阻塞模拟。属性预算决定本拍发多少,传输水位决定还能否入队,两者分别生效。
4.3 上行校验
准入、消息长度、速率和参数校验必须在进入模拟前完成。限流与风控原语存在不代表每条应用入口都已接通;玩法验收需覆盖未认证输入、伪造玩家、迟到代次和过载。
5. 机制采用边界
5.1 传输与业务结果
TCP 与链路确认不能替代模拟回执或持久化确认。跨重连序号去重也不能保证跨进程重启后的业务恰好执行一次。
5.2 有界投递
使用显式发送结果和有界队列,调用方决定降级或重试。队列项需要关联 ID;重试仍使用原业务幂等键。
5.3 技术路线
当前进程间通信使用现有 M1 自研内核。Aeron 等外部设计可提供机制参考,不作为额外部署总线或已集成依赖。
5.4 跨线程交接
后台结果携带请求标识回到逻辑线程,在边界点验证目标对象、会话和权威代次后执行。对象销毁后到达的结果必须拒绝或取消。
5.5 帧处理
压缩、加密和校验属于帧处理机制,其配置必须与连接版本一致。当前原语或依赖存在,不等于全部客户端链路已启用;protobuf/zstd 的业务接线仍按需求触发。
5.6 演进与容量
优化限定在清晰的层内接口中,通过基准验证后引入。完成模型、共享内存和其他传输不改变业务权威,也不能以优化为由建立第二套协议事实源。
5.7 InterServerLink
握手包含进程身份、route_version 和 authority_epoch。受理版本为本代与 compat_route_versions;APOLLO_ROUTE_COMPAT 配置窗口,窗外版本仍断开。握手放行不提供业务报文双版本解码。对端代次变化触发重启事件,由上层重建状态;同代次的断线恢复与进程重启必须区分。
Reliable 使用发送队列、接收去重与累积 ACK;Droppable 不保证重传。链接对象和它的状态由所属泵顺序推进。业务迁移还需要持久权威记录和提交结果对账。
5.8 传输模型
当前内核提供 TCP 传输及可测试传输接口。就绪模型与完成模型属于 L0 实现选择,不能据接口形式宣称某平台或某内核已支持。Windows 的编译垫片也不能作为真实网络验收。
5.9 客户端安全
鉴权和权威校验属于业务入口。密码、票据和安全传输须在部署前完成明确接线;原型测试账号、非空票据容忍或默认路由都不能作为生产鉴权方案。配置了 Login 准入链路时,服务不可达或应答无效应拒绝准入。
5.10 出站 HTTP
当前 HTTP 目标使用 libcurl,CMake 不再选择 Drogon 替代分支。同步 HTTP 不得从模拟线程直接调用;异步结果回到未来的逻辑边界,不能反向改写已完成判定。
脚本或业务发起出站请求须限制目标与超时。是否使用 curl_multi 执行层、如何取消以及如何与脚本协程交接,仍需按真实消费者接线验证;已有 poll 事件循环不等于已经接入 curl_multi。
6. 当前有效规则
复用 M1 和契约路由;保留应用帧转换的现状说明;分别验收客户端会话、进程间链路和业务结果。禁止用历史实现清单推导当前能力,禁止把外部引擎角色变成 Apollo 新进程。
7. 编队、恢复与更新
machined 提供本机监督重启。World 崩溃后,活动 Instance 不会自动迁移到另一进程。未经验证的活动状态按失败处理,保留已确认的资料与结算;跨机热备和自动接管不是当前能力。
Gateway 排空、World 排空、跨 Gateway 会话恢复、跨 World 权威交接、协议兼容窗口及发布回滚分别验收。持续接入、免重新登录、TCP 连接连续和活动副本连续不能互相替代。
跨服场景使用World 管理、cell 执行及 Space/Cell/Instance 模型,不要求无缝地图。任务仅维护在根目录 todo.md。
