# 更新

**URL:** https://heroiclabs.com/docs/zh/nakama/getting-started/upgrade/
**Summary:** 如何将您的Nakama服务器更新至新版本。

---


# 升级Nakama

将Nakama升级至新版本时，在运行新版本前，您需要完成三个操作：

- 检查[发行说明](../release-notes/)，查看该版本是否有具体的升级要求。
- 将您的数据迁移到Nakama新版本支持的格式。
- 确保您运行的客户端版本与部署的服务器兼容。

## Docker

出现可用的新版本Nakama或CockroachDB时可能需要升级。Docker允许您轻松升级，因为仅需要下载容器映像的新版本。升级至Nakama新版本时，`docker-compose.yml`中的流程会自动将您的数据迁移至新的数据库架构。

您可以提取最新的Nakama映像，并允许Docker Compose执行数据迁移。

```sh
docker-compose down # top and remove both the Nakama and CockroachDB containers
docker pull heroiclabs/nakama # download the latest Nakama image
docker-compose up # start the containers (both Nakama and CockroachDB) as fresh installs
```

CockroachDB容器的更新与之类似，具体方法如下：

```sh
docker pull cockroachdb/cockroach # download the latest CockroachDB image
```

如果需要显式运行数据库架构迁移，应发出以下命令：

```sh
docker run heroiclabs/nakama migrate up
```

## 手动升级

可以按照以下说明将一个节点或整个集群升级到最新的Nakama版本。

对于集群中的每个节点：

停止Nakama。如果在Linux安装程序上使用`systemd`，命令为：

```sh
sudo systemctl stop nakama
```

备份CockroachDB：

```sh
cockroach dump nakama > mydatabackup.sql --insecure
```

下载[最新版本](https://github.com/heroiclabs/nakama/releases/latest)并将`nakama`二进制文件替换为最新下载的版本。

使用以下命令升级数据库架构：

```sh
nakama migrate up
```

您可以遵循相同的过程降级Nakama，但需要将迁移命令替换为以下内容：

```sh
nakama migrate down --limit 1
```

启动Nakama并验证升级版本是否正在运行。

```sh
sudo systemctl start nakama
```