# macOS Binary

**URL:** https://heroiclabs.com/docs/zh/nakama/getting-started/install/macos/
**Summary:** 如何在任何macOS上设置和运行Nakama二进制文件及其前提条件。二进制设置允许您在没有Docker的情况下安装和管理Nakama。

---


# 为 macOS 安装 Nakama 二进制

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

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

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

## 前提条件

### 运行系统

继续之前，应确保运行 macOS 10.9（Mavericks）或 X86_64（64 位）处理器架构中的更高版本。

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

### CockroachDB

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

通过[官方支持的方法](https://www.cockroachlabs.com/docs/stable/install-cockroachdb.html)安装 CockroachDB：

- Homebrew
- 二进制
- 从源代码安装

### PostgreSQL

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

通过以下安装 PostgreSQL：

- [PostgreSQL macOS 官方包](https://www.postgresql.org/download/macosx/)
- [Postgres.app](https://postgresapp.com/)
- [Homebrew](https://wiki.postgresql.org/wiki/Homebrew)

## 下载 Nakama

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

1. 在 Nakama GitHub repo[版本页面](https://github.com/heroiclabs/nakama/releases)下载一个版本
2. 提取归档文件，可选择重命名文件夹并将其移动到合适的位置

## 正在运行 Nakama

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

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

### Nakama 迁移

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

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

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

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

**CockroachDB**

```sh
./nakama migrate up
```

**PostgreSQL**

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

### Nakama 服务器

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

**CockroachDB**

```sh
./nakama
```

**PostgreSQL**

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

您需要提供与用于运行[Nakama PostgreSQL 数据库迁移](#nakama-migrations)相同的`database.address`值。

## Nakama 控制台

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

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

## 配置文件

您可为您的 Nakama 服务器自定义许多[配置选项](../../configuration/)。

## 后续步骤

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