加好友、排行榜、开黑,每个游戏都在重写一遍

你可能从没细想过：进游戏先登录，加个好友，看看排行榜上自己排第几，拉人组队开一局，在世界频道里吹两句。

这些功能几乎每个游戏都得有，做法也几乎一模一样。但绝大多数游戏，是从零把这套东西写了一遍又一遍。

排行榜塞进数据库，好友关系自己建表，实时对战找个库拼上，账号体系再单独做一套。功能是有了，可用户掉线重连、排行榜并发读写、对战服务器扩容这些事，全得自己扛。一个几十人的小团队，光这些外围就能耗掉大量时间。

Nakama 就是把这堆外围一次性做完的服务器。2017 年建仓，维护到现在，一万三千多 star，一百五十多个版本。

一套后端里都装了什么

README 里那张功能清单，翻成人话大概是这样：

• 账号：社交账号、邮箱、设备 ID 都能注册登录
• 存档：玩家的设置、进度、道具存成一条条记录
• 社交：好友和群组，还有一张能查「谁和谁认识」的关系图
• 聊天：一对一、群聊、世界频道，消息能留历史
• 实时对战：实时或者回合制都支持
• 排行榜：动态的、赛季制的，能取头部，也能取「我附近那几名」
• 锦标赛：拉一群人比，几个锦标赛串起来就是联赛
• 开黑：玩家能组队，队内通信也一并管了
• 内购校验：验证应用内购买和订阅
• 通知：给在线的客户端推消息
• 匹配：给对战找对手
• 运行时模块：用自己的代码写游戏逻辑，Lua、TypeScript 或者 Go 都行

这些功能单拎一个出来都不难。难的是它们得共用一套账号体系、一份在线状态，还得在同一个服务器里互相知道对方在干什么。玩家点「邀请好友开黑」，背后是好友关系、在线状态、匹配、对战房间同时生效。

Nakama 值钱的地方就在这儿。

它自带一个后台

服务器跑起来，浏览器打开就能进一个管理后台，默认在 7351 端口。不用另外装，它就编译在同一个二进制文件里。

后台首页看的是整体状态：此刻在线多少人、有多少局对战正在进行，下面再按节点拆开列。四台机器里哪台卡了，一眼就能看见。

玩家页面能按 ID、邮箱、社交账号、设备 ID 模糊搜。每个账号什么时候建的、什么时候动过，都在这儿。

后台能干的事不少：查各接口的数据、看服务的轻量指标、管玩家数据、直接改存储对象，还能给生产环境配权限档位，实时对战里的房间状态也能看。

玩法逻辑得自己写

Nakama 本身只提供通用的那层。真要做出你的游戏，还是得写代码，它给的做法是把逻辑做成「运行时模块」挂进去：Lua、TypeScript/JavaScript、原生 Go 三种写法都支持。

官方把这块看作核心。匹配规则、排行榜怎么算、锦标赛怎么开，最后都落在你自己写的模块里。

玩家的存档长什么样

这是存储对象页面。用「集合加键」定位一条记录，值是一段 JSON，读权限和写权限分开设。

图上这条，集合是 trophies，键是 emblems，值只有一行，写着某个徽章已解锁，权限设成公开可读、不可写。玩家身上那些零零散散的状态，基本都是这么存下来的。

接口不用自己写脚本试

后台里还有个 API Explorer。左边挑方法，填上参数点发送，右边就是把返回原样打出来。

图上左边挂着 GetAccount 和 JoinTournament 两个方法，发一次请求，返回的 JSON 直接摊在下面。调通了再写进代码，比对着文档猜参数快得多。

客户端这边

官方维护的客户端库覆盖得挺全：Unity、Unreal、Godot、Defold、.NET（C#）、JavaScript、Java（含 Android）、Swift（含 iOS）。

传输上给了两条路。请求响应走 gRPC，也可以退回 HTTP 加 JSON；实时通信用 WebSocket，或者更省流量的 rUDP。

跑起来

最快的路子是 Docker，仓库里就带着 compose 文件，拉镜像、起服务、连数据库一条命令搞定。

想用原生二进制也行，Releases 里有 Linux、macOS、Windows 的包。下下来先跑一次数据库迁移，再启动：

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

起来之后命令行会把它实际生效的一整套配置打出来，哪个参数是从哪读的，看日志就知道。

几个前提

它不是下载下来双击就能玩的东西。它需要一个 Postgres 协议兼容的数据库，官方推荐 CockroachDB，也就是说你得先把这个数据库跑起来。

生产部署上，官方建议 Nakama 和数据库分开部署到不同节点。数据库那部分的机器要求是数据库自己定的，比 Nakama 这边高不少。

另外这是个一直在动的项目，一百五十多个版本下来，配置项和接口细节都会变。升级前扫一眼 CHANGELOG 会稳一点。

仓库与协议

https://github.com/heroiclabs/nakama，Apache-2.0 协议。

你玩过的游戏里，有没有哪个功能一看就是「凑合做出来的」？评论区聊聊。