2 行
52 KiB
Markdown
2 行
52 KiB
Markdown
|
# TDD-01 服务端整体架构设计\n\n> 文档类型：技术设计文档（Technical Design Document）\n> 版本：1.0\n> 日期：2026-07-02\n> 关联文档：TDD-02《客户端热更新技术方案》、TDD-03《客户端架构设计》、TDD-04《数据库表结构设计》、TDD-05《API接口设计》、TDD-06《离线挂机结算系统设计》、TDD-07《反作弊与安全设计》、TDD-08《GM与运营后台设计》、TDD-09《推送与通知系统设计》、GDD-00~GDD-23 相关系统设计\n\n---\n\n## 1. 文档信息\n\n| 项目 | 说明 |\n|------|------|\n| 目标 | 为挂机手游《洪荒大陆》定义服务端整体架构，覆盖服务拓扑、水平扩展、消息队列、缓存策略、容灾故障转移、部署架构、监控告警、数据库连接池与读写分离等核心基础设施。 |\n| 读者 | 服务端开发、运维（SRE）、架构师、技术负责人 |\n| 技术栈 | Nakama 3.x + Go 插件 + PostgreSQL 16 + Valkey (Redis 兼容) + Nacos 2.x + Kafka 3.x + Cocos Creator 3.x |\n| 核心约束 | 无任务系统、无赛季重置、概率/机遇驱动、文字战报、ATB行动条、功法加持、能量体系（非体力） |\n| 境界体系 | 9大境界（炼气/筑基/金丹/元婴/化神/合体/大乘/渡劫/飞升），5层世界 |\n| 种族 | 19个可创角种族，3大阵营（天道/洪荒/幽冥）+ 混沌中立 |\n| 游戏时间 | 现实:游戏 = 1:3 |\n\n---\n\n## 2. 服务拓扑架构\n\n### 2.1 整体服务拓扑图\n\n```\n ┌─────────────────────────────────┐\n │ 客户端 (Cocos 3.x) │\n │ WSS / HTTPS / gRPC-Web │\n └──────────────┬──────────────────┘\n │\n ┌──────────────▼──────────────────┐\n │ 接入层 (OpenResty / Traefik) │\n │ TLS 终止 · 限流 · 路由 · 灰度 │\n │ 端口: 443(HTTPS) 8443(WSS) │\n └──────┬──────────┬───────────────┘\n │ │\n ┌───────────────▼──┐ ┌───▼──────────────────┐\n │ Nakama 集群 │ │ Gin HTTP API 网关 │\n │ (实时 + 游戏逻辑) │ │ (RESTful + gRPC-GW) │\n │ 端口: 7350/7351 │ │ 端口: 8080/8443 │\n └───┬──┬──┬────────┘ └──┬──┬──┬─────────────┘\n │ │ │ │ │ │\n ┌──────────────┘ │ └────────┐ │ │ └────────────┐\n ▼ ▼ ▼ ▼ ▼ ▼\n ┌──────────────┐ ┌──────────────┐ ┌────────────────┐ ┌──────────────┐\n │ 战斗模拟服务 │ │ 离线结算服务 │ │ 世界事件服务 │ │ GM/运营服务 │\n │ (Go gRPC) │ │ (Go gRPC) │ │ (Go gRPC) │ │ (Gin HTTP) │\n │ 端口: 9001 │ │ 端口: 9002 │ │ 端口: 9003 │ │ 端口: 9010 │\n └──────┬──────<E29480><E29480>
|
