Nakama Server， 二进制安装

要开始使用 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。

对于生产设置，应将 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. 然后提取二进制文件：

# 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

# migrate schema
nakama migrate up
# start the server
nakama

在 Windows 上安装 Nakama

Nakama 也可以作为 Windows 二进制文件使用。但是，推荐使用 Docker 在 Windows 上安装 CockroachDB 和 Nakama。

1. 下载二进制文件并解压缩下载的文件。
   

1. https://github.com/heroiclabs/nakama/releases/latest
   

2. 打开 Powershell 终端并导航到您下载的 Nakama 所在的文件夹。
   
3. 迁移数据库架构，然后启动 Nakama
4. 
   

# 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. 然后提取二进制：

# 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

# migrate schema
nakama migrate up
# start the server
nakama

您可能会遇到权限错误。如果您愿意以 root 权限执行操作，请在命令前加 sudo。

systemd

如果您喜欢将 Nakama 作为一个服务来运行，并且您正在运行一个使用 systemd 的发行版，那么您可以选择使用以下脚本。

您需要更新 systemd 配置中的路径。

1. 创建服务文件：/usr/lib/systemd/system/nakama.service

"nakama.service"

[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. 启用并运行服务

sudo systemctl enable nakama
sudo systemctl start nakama