要开始使用 Nakama 进行开发,您首先需要将其安装在开发计算机上。简单明了,只需几分钟。在本指南中,我们将重点介绍使用二进制可执行文件安装 Nakama 开发实例。
"推荐方法":Docker 是下载并开始使用 Nakama 进行开发的最快方法。对于生产环境设置,我们建议您以二进制形式安装 Nakama,以确保 Nakama 可以使用所有系统资源。
需求
在安装 Nakama 之前,您需要了解或必须掌握以下几点:
- 操作系统:Windows 7 64 位或以上,MacOS 10.9 或以上,或现代 Linux。
- 架构:X86_64(64位)处理器架构
- 依赖软件:Nakama 依赖 CockroachDB。
安装 CockroachDB
Nakama 依靠 CockroachDB 作为主要和唯一的数据库。Nakama 使用 CockroachDB 存储服务器配置、用户数据、聊天消息和更持久的数据。
首先需要安装 CockroachDB。在安装 Nakama 之前,请按照本指南在机器上安装 CockroachDB。
"CockroachDB 替代":对于没有 CockroachDB 的环境,Nakama 非官方支持 PostgreSQL。
代码语言:javascript复制对于生产设置,应将 Nakama 与 CockroachDB 一起使用,因为查询已针对磁盘上的数据存储方式进行了优化。
在 MacOS 上安装 Nakama
你需要运行 MacOS 10.9 (Mavericks) 或更高版本才能运行Nakama。
没有 Homebrew
直接安装二进制文件而不是通过 Homebrew 安装二进制文件,使您可以灵活地将服务器放置在首选工作区中。但是,通过 Homebrew 进行安装是最简单,最容易的-包括更新-因为所有事情都是使用 Homebrew 工作流程进行处理的。
1. 下载适用于 MacOS 的最新 Nakama tarball。https://github.com/heroiclabs/nakama/releases/latest
2. 然后提取二进制文件:
代码语言:javascript复制# replace the X.X.X with the version number you have downloaded
tar xfz nakama-X.X.X-darwin-amd64.tar.gz
3. 将包含二进制文件的目录添加到 PATH
。这使得从终端执行 Nakama 命令变得容易。
cp -i nakama /usr/local/bin
您可能会遇到权限错误。如果您愿意以 root 权限执行操作,请在命令前加上 sudo
。
4. 迁移数据库架构,然后启动 Nakama
代码语言:javascript复制# migrate schema
nakama migrate up
# start the server
nakama
在 Windows 上安装 Nakama
Nakama 也可以作为 Windows 二进制文件使用。但是,推荐使用 Docker 在 Windows 上安装 CockroachDB 和 Nakama。
- 下载二进制文件并解压缩下载的文件。
- https://github.com/heroiclabs/nakama/releases/latest
- 打开 Powershell 终端并导航到您下载的 Nakama 所在的文件夹。
- 迁移数据库架构,然后启动 Nakama
# migrate schema
nakama.exe migrate up
# start the server
nakama.exe
在 Linux 上安装 Nakama
使用 Docker - 这是推荐的方法。我们很快将为各种 Linux 软件包管理器提供软件包,以简化安装过程。让我们知道您是否需要特定的软件包管理器。
首先,您需要创建一个合适的目录来安装 Nakama。在某种程度上,它的位置取决于您对 Linux 的特殊偏好和您自己的偏好。
1. 下载二进制文件并解压下载的文件https://github.com/heroiclabs/nakama/releases/latest
2. 然后提取二进制:
代码语言:javascript复制# replace the X.X.X with the version number you have downloaded
tar xfz nakama-X.X.X-linux-amd64.tar.gz
3. 添加包含二进制文件的目录到您的 PATH
。这使得从终端执行 Nakama 命令变得很容易。
cp -i nakama /usr/local/bin
4. 迁移数据库架构,然后启动 Nakama
代码语言:javascript复制# migrate schema
nakama migrate up
# start the server
nakama
您可能会遇到权限错误。如果您愿意以 root 权限执行操作,请在命令前加 sudo
。
systemd
如果您喜欢将 Nakama 作为一个服务来运行,并且您正在运行一个使用 systemd 的发行版,那么您可以选择使用以下脚本。
您需要更新 systemd 配置中的路径。
1. 创建服务文件:/usr/lib/systemd/system/nakama.service
"nakama.service"
代码语言:javascript复制[Unit]
Description=Nakama server
[Service]
ExecStart=/path/to/nakama --config /path/to/nakama/config.yml
KillMode=process
[Install]
WantedBy=multi-user.target
2. 更新文件权限,使其可被 systemd
守护进程读取
sudo chmod 644 /usr/lib/systemd/system/nakama.service
3. 启用并运行服务
代码语言:javascript复制sudo systemctl enable nakama
sudo systemctl start nakama
谢谢点赞支持???!
中文在线文档:
- https://nakama-docs.hacker-linner.com/,持续更新中……