Nakama Server, 二进制安装

2021-05-27 19:10:10 浏览数 (1)

要开始使用 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 命令变得容易。

代码语言:javascript复制
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。

  1. 下载二进制文件并解压缩下载的文件。
    1. https://github.com/heroiclabs/nakama/releases/latest
  2. 打开 Powershell 终端并导航到您下载的 Nakama 所在的文件夹。
  3. 迁移数据库架构,然后启动 Nakama
代码语言:javascript复制
# 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 命令变得很容易。

代码语言:javascript复制
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 守护进程读取

代码语言:javascript复制
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/,持续更新中……

0 人点赞