跳到主要内容

技术选型总览

位置: docs/11_技术选型/技术选型总览.md 版本: v1.0 日期: 2026-07-08 关联: AGENTS.md 技术合规铁律、docs/开发规范/技术栈合规清单.md

1. 选型原则

所有技术必须开源可商用或已获合法授权。 详见 docs/00_项目概述/开发规范/技术栈合规清单.md

原则	说明
开源优先	优先选择 MIT/Apache-2.0/BSD 协议的开源技术
商用授权	闭源技术必须有商用授权协议
社区活跃	选择社区活跃、维护良好的技术，避免技术债务
团队熟悉	优先选择团队有使用经验的技术，降低学习成本

2. 技术栈总览

2.1 客户端

技术	版本	用途	协议
Cocos Creator	3.8.8	游戏引擎	免费版（商用许可）
TypeScript	5.x	客户端脚本语言	Apache-2.0

2.2 服务端

技术	版本	用途	协议
Go	1.22+	服务端语言	BSD-3
Nakama	3.x	游戏服务端框架	Apache-2.0
PostgreSQL	16+	关系型数据库	PostgreSQL License
Valkey	8+	缓存/会话存储	BSD-3

2.3 基础设施

技术	版本	用途	协议
Docker	latest	容器化	Apache-2.0
Nacos	2.x	配置中心/服务发现	Apache-2.0
Nginx	1.25+	反向代理/负载均衡	BSD-2
Prometheus	2.x	监控	Apache-2.0
Grafana	10.x	可视化监控	AGPL（前端）/ Apache-2.0（服务端）
Protobuf	3.x	序列化协议	BSD-3

3. 架构概览

┌─────────────────────────────────────────────┐
│              客户端 (Cocos Creator)           │
│  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │ UI 层   │  │ 系统层  │  │ 网络层      │  │
│  │ scenes  │  │ systems │  │ NetworkMgr  │  │
│  └─────────┘  └─────────┘  └─────────────┘  │
└──────────────────┬──────────────────────────┘
                   │ WebSocket / gRPC
┌──────────────────┴──────────────────────────┐
│              Nakama 游戏服务端                │
│  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │ RPC     │  │ Match   │  │ Middleware  │  │
│  │ 业务逻辑 │  │ 实时对战 │  │ 认证/限流   │  │
│  └─────────┘  └─────────┘  └─────────────┘  │
└──────────────────┬──────────────────────────┘
                   │ SQL / Redis 协议
        ┌──────────┴──────────┐
        ▼                     ▼
┌───────────────┐    ┌─────────────────┐
│  PostgreSQL   │    │    Valkey       │
│  玩家数据     │    │  缓存/会话/排行  │
└───────────────┘    └─────────────────┘

4. 详细技术文档

详细的技术设计文档（TDD）将在进入开发阶段后编写。当前处于设计阶段，技术类内容仅限于选型概览。

主题	状态	说明
服务端整体架构	待编写	进入开发阶段后补充 TDD
客户端热更新方案	待编写	进入开发阶段后补充 TDD
数据库表结构设计	待编写	进入开发阶段后补充 TDD
API 接口设计	待编写	进入开发阶段后补充 TDD
反作弊与安全设计	待编写	进入开发阶段后补充 TDD
实时位置同步	待编写	进入开发阶段后补充 TDD

5. 版本记录

v1.0（2026-07-08）: 初始版本，汇总技术选型，标记详细 TDD 待开发阶段补充

1. 选型原则
2. 技术栈总览
3. 架构概览
4. 详细技术文档
5. 版本记录