Windows的Nakama二进制 #

本教程将向您展示如何在Windows上设置和运行Nakama二进制文件及其前提条件。

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

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

前提条件 #

运行系统 #

继续之前，确保您使用64位Windows 8或更高版本运行CockroachDB，或使用64位Windows 7或更高版本运行PostgreSQL。

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

CockroachDB #

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

按照官方指南说明，在Windows上安装CockroachDB。

PostgreSQL #

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

从官方网站下载并运行PostgreSQL Windows安装程序：

只有“PostgreSQL服务器”和“命令行工具”为必需组件，其余为可选组件。

PostgreSQL组件
PostgreSQL组件

为数据库超级用户提供密码。请注意您在此处提供的密码，稍后在配置Nakama连接到数据库服务器时需要使用该密码。

在安装过程中对其他选项使用默认值。

下载Nakama #

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

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

正在运行Nakama #

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

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

CockroachDB #

运行CockroachDB的最简单的方法是将其作为启用了非安全模式的单节点服务器，使其只能在您本地主机（127.0.0.1）上访问。有关访问和安全控制的更多信息，请查阅CockroachDB文档。

  1. 打开一个shell（命令提示符，Powershell，Bash等）并导航至您的CockroachDB目录。
  2. 要启动CockroachDB，运行以下内容：

命令提示符

1

cockroach.exe start-single-node --insecure --listen-addr=127.0.0.1

Powershell或Bash

1

./cockroach.exe start-single-node --insecure --listen-addr=127.0.0.1

成功运行CockroachDB的输出应类似于以下屏幕截图：

正在运行CockroachDB
正在运行CockroachDB

可以将CockroachDB配置为作为Windows启动应用程序或服务运行，以便在后面跳过这一步。

错误：无法加载命名时区

CockroachDB的一些版本需要Go时区.zip压缩文件，以便从其中加载时区信息。

您可以通过下载并安装最新的Go版本获得兼容的zoneinfo文件。zoneinfo.zip文件位于您的Go安装文件夹的lib/time/zoneinfo.zip。

运行CockroachDB前，可以在同一shell会话中将ZONEINFO环境变量设置为您的zoneinfo.zip文件的完整路径：

命令提示符

1

set ZONEINFO="C:\Program Files\Go\lib\time\zoneinfo.zip"

Powershell

1

$env:ZONEINFO="C:\Program Files\Go\lib\time\zoneinfo.zip"

Bash

1

export ZONEINFO="c/Program Files/Go/lib/time/zoneinfo.zip"

或者，也可以通过Windows设置来设置环境变量。

PostgreSQL #

安装后，PostgresSQL应自动在后台运行，您可以继续运行Nakama迁移或Nakama服务器。

您可以使用PostgreSQL命令行工具或GUI应用程序（如pgAdmin）来创建在特定应用程序内具有受限权限的用户。

Nakama迁移 #

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

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

CockroachDB

命令提示符

1

nakama.exe migrate up

Powershell或Bash

1

./nakama.exe migrate up

针对CockroachDB的Nakama迁移
针对CockroachDB的Nakama迁移

PostgreSQL

如果您正在使用PosgreSQL，则需要提供您的数据库服务器地址、用户和密码。除非您创建了自定义用户，否则这将是默认的超级用户postgres和您在安装过程中提供的主密码：

命令提示符

1

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

Powershell或Bash

1

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

针对PostgreSQL的Nakama迁移
针对PostgreSQL的Nakama迁移

Nakama服务器 #

要使用CockroachDB或PostgreSQL启动Nakama服务器，运行以下内容：

CockroachDB

命令提示符

1

nakama.exe

Powershell或Bash

1

./nakama.exe

PostgreSQL

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

命令提示符

1

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

Powershell或Bash

1

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

如果收到Windows安全警报，请勾选“私人网络…”方框，允许Nakama通过您的网络进行通信，并点击“允许访问”确认安全权限。

Nakama防火墙
Nakama防火墙

现在将运行Nakama服务器，并应显示类似的日志输出，其中包含警告和有用信息，例如：

  • Nakama数据目录
  • Nakama和数据库版本
  • 各种服务的端口

Nakama与CockroachDB

使用CockroachDB运行Nakama
使用CockroachDB运行Nakama

Nakama与PostgreSQL

使用PostgreSQL运行Nakama
使用PostgreSQL运行Nakama

Nakama控制台 #

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

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

Nakama控制台
Nakama控制台

配置文件 #

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

后续步骤 #

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

Related Pages