Linux的Nakama二进制

本教程将介绍如何在Linux上设置和运行Nakama二进制文件及其前提条件。

二进制设置允许您在没有Docker的情况下安装和管理Nakama，但它需要额外的步骤来设置和管理：

  • 安装CockroachDB或PostgreSQL
  • 手动应用数据库迁移
  • 手动将Nakama及其数据库升级到较新版本
  • 配置服务或手动启动Nakama及其数据库

前提条件 #

运行系统 #

继续之前，确保您正在运行X86_64 (64bit) Linux发行版。

接下来，安装受支持的数据库引擎。

CockroachDB #

Nakama官方支持CockroachDB v20.0或更高版本，并为其存储引擎优化了查询。

通过官方支持的方法安装CockroachDB：

  • 二进制
  • 从源代码安装

PostgreSQL #

Nakama仅在开发环境中非官方支持PostgreSQL 9.6或更高版本。

通过以下安装PostgreSQL：

  • Debian、Red Hat/CentOS、Suse和Ubuntu的官方软件包
  • 从源代码安装

下载Nakama #

获取适用于的Nakama服务器的最新二进制版本：

  1. 在Nakama GitHub repo版本页面下载一个版本。
  2. 提取归档文件，可选择重命名文件夹并将其移动到合适的位置。

正在运行Nakama #

启动Nakama服务器之前，您需要运行：

  1. 您选中的数据库，即CockroachDB或PostgreSQL。
  2. 如果这是您第一次运行Nakama或您已升级Nakama版本，应迁移Nakama数据库。

Nakama迁移 #

如果这是您第一次运行Nakama或您已升级Nakama版本，应运行Nakama数据库迁移。如果您不确定，可以重新运行迁移。

如果您在默认配置下运行CockroachDB，则运行迁移非常简单，无需其他选项。

如果您正在使用PosgreSQL，则需要提供您的数据库服务器地址、用户和密码。

要运行Nakama迁移，导航至您的Nakama目录并运行以下内容：

CockroachDB

1

./nakama migrate up

PostgreSQL

1

./nakama migrate up --database.address postgres:password@127.0.0.1:5432

Nakama服务器 #

要使用CockroachDB或PostgreSQL启动Nakama服务器，导航至您的Nakama目录并运行以下内容：

CockroachDB

1

./nakama

PostgreSQL

1

./nakama --database.address postgres:password@127.0.0.1:5432

您需要提供与用于运行Nakama PostgreSQL数据库迁移相同的database.address值：

systemd #

如果您偏好将Nakama作为服务运行，并且您正在运行使用systemd的发行版，则可以选择使用以下脚本。 您需要在systemd配置中使用您的Nakama路径。

创建包含以下内容的服务文件/usr/lib/systemd/system/nakama.service：

nakama.service

1
2
3
4
5
6
7
8
9

[Unit]
Description=Nakama server

[Service]
ExecStart=/path/to/nakama --config /path/to/nakama/config.yml
KillMode=process

[Install]
WantedBy=multi-user.target

更新文件权限，使其可以在systemd守护进程中读取：

1

sudo chmod 644 /usr/lib/systemd/system/nakama.service

启用并运行服务：

1
2

sudo systemctl enable nakama
sudo systemctl start nakama

Nakama控制台 #

您可以通过将浏览器导航到127.0.0.1:7351来访问Nakama控制台。

Nakama控制台
Nakama控制台

提示登录时，默认凭据为admin:password 。可以通过配置文件或命令行标志更改凭据。

配置文件 #

您可为Nakama服务器自定义许多配置选项。

后续步骤 #

现在您的Nakama服务器已经启动并运行了所需的配置，您可以使用首选的客户端SDK开始进行操作。

Related Pages