Nakama 游戏后端服务器

Nakama 是什么

Nakama 是由 Heroic Labs 开源的分布式游戏后端服务器，使用 Go 语言编写，采用 Apache-2.0 协议。它把联网游戏常见的后端能力打包成一个可自托管的服务，让开发者不必从零实现账号、社交、匹配、排行榜等基础设施。

项目在 GitHub 上已获得超过 1.3 万 Star，被全球众多游戏工作室与 App 团队用于生产环境。

核心功能

• 用户系统：支持社交账号、邮箱、设备 ID 注册与登录。
• 存储：以集合形式保存用户记录、设置等对象数据。
• 社交：好友关系、群组，以及内置的社交图谱。
• 聊天：一对一、群组与全局聊天，可持久化历史消息。
• 多人对战：支持实时与回合制、主动与被动多种模式。
• 排行榜与锦标赛：动态、赛季制，可查询前列玩家或某玩家附近排名。
• 组队（Parties）：让玩家组队并队内通信。
• 内购校验：验证应用内购买与订阅。
• 应用内通知：向已连接客户端推送消息。
• 运行时扩展：用 Lua、TypeScript/JavaScript 或原生 Go 编写自定义服务端逻辑。

此外还提供匹配器、管理后台（Dashboard）与指标监控等能力。

技术架构

Nakama 需要 CockroachDB 或其他兼容 Postgres 协议的数据库作为存储层。服务端本身以单二进制形式分发，便于容器化部署。

客户端方面，官方为 Unity、Unreal、Godot、JavaScript/TypeScript、C#、C++、Lua 等提供 SDK，覆盖主流游戏引擎与平台。

快速开始

最省事的方式是使用 Docker：准备一份 docker-compose.yml，然后启动容器即可同时拉起服务端与数据库。

docker-compose -f ./docker-compose.yml up

如果使用原生二进制，则需要先启动数据库，再执行迁移并启动服务：

nakama migrate up --database.address "root@127.0.0.1:26257"
nakama --database.address "root@127.0.0.1:26257"

启动后终端会输出当前生效的配置信息，便于确认连接与运行参数。

适用与注意事项

Nakama 适合需要快速具备联网能力的独立团队与中小型工作室，尤其是实时对战、排行榜、公会社交等玩法。需要注意的是，它并非「零运维」方案，数据库部署、服务端逻辑调试与配置管理都需要一定学习成本，且中文资料相对有限。