6.4 KiB
| title | description | menu | ||||||
|---|---|---|---|---|---|---|---|---|
| 迁移到新机器 | 将你的 Mastodon 站点无损复制到新服务器。 |
|
出于各种原因，你可能希望将 Mastodon 实例从一台服务器迁移到另一台。幸运的是，这个过程并不太困难，尽管可能会导致一些停机时间。
{{< hint style="info" >}} 本指南主要针对 Ubuntu Server 编写；对于其他配置环境，你的实际体验可能有所不同。 {{< /hint >}}
基本步骤
- 使用[生产环境配置指南]({{< relref "install" >}})设置新的 Mastodon 服务器（但不要运行
mastodon:setup，只保持PostgreSQL服务运行）。 - 停止旧服务器上的 Mastodon 服务（例如
systemctl stop 'mastodon-*.service'）。 - 使用下面的说明导出和加载 PostgreSQL 数据库。
- 使用下面的说明复制
system/文件。（注意：如果你使用 S3，可以跳过此步骤。） - 复制
.env.production文件。 - 保存 Redis 数据库，停止新旧机器上的 Redis 服务，并将 Redis 数据库从
/var/lib/redis/复制到新服务器。 - 运行
RAILS_ENV=production bundle exec rails assets:precompile编译 Mastodon。 - 在新服务器上启动 Mastodon 和 Redis。
- 运行
RAILS_ENV=production ./bin/tootctl feeds build为每个用户重建主时间线。 - 运行
RAILS_ENV=production ./bin/tootctl search deploy重建 Elasticsearch 索引（注意：如果你不使用 Elasticsearch，可以跳过此步骤。） - 更新 DNS 设置，指向新服务器。
- 更新或复制 Nginx 配置，并根据需要重新运行 LetsEncrypt。
- 享受你的新服务器！
详细步骤
停止 Mastodon 服务
systemctl stop 'mastodon-*.service'
需要迁移哪些数据
总体而言，你需要复制以下内容：
~/live/public/system目录，该目录包含用户上传的图片和视频（如果使用 S3，则不需要）- PostgreSQL 数据库（使用 pg_dump）
~/live/.env.production文件，其中包含服务器配置和密钥/var/lib/redis/目录中的 Redis 数据库，其中包含未处理的 Sidekiq 任务。
以下内容不太重要，但为方便起见，你可能仍然想要复制：
- nginx 配置（位于
/etc/nginx/sites-available/mastodon） - 域名的 SSL 证书（若使用 LetsEncrypt，应位于
/etc/letsencrypt/live/） - systemd 配置文件（
/etc/systemd/system/mastodon-*.service），其中可能包含你的服务器调整和自定义 /etc/pgbouncer下的 PgBouncer 配置（如果你使用它）
导出与导入 PostgreSQL
我们不运行 mastodon:setup，而是使用 template0 数据库创建一个空的 PostgreSQL 数据库（这在还原 PostgreSQL 转储文件时很有用，如 pg_dump 文档所述）。
如果你的 PostgreSQL 用户使用密码，为方便起见，你可能希望在新系统上配置 mastodon 用户使用与旧系统相同的密码：
sudo -u postgres psql
ALTER USER mastodon WITH PASSWORD 'YOUR_PASSWORD';
\q
在旧系统上以 mastodon 用户身份运行：
pg_dump -Fc mastodon_production -f backup.dump
使用 rsync 或 scp 复制 backup.dump 文件。然后在新系统上，以 mastodon 用户身份创建一个空数据库：
createdb -T template0 mastodon_production
然后导入它（将 -j# 中的 # 替换为系统中的 CPU 数量以提高还原性能）：
pg_restore -Fc -j# -U mastodon -n public --no-owner --role=mastodon \
-d mastodon_production backup.dump
（请注意，如果新服务器上的用户名不是 mastodon，你应该更改上面的 -U 和 --role 值。两个服务器之间可以使用不同的用户名。）
复制文件
这可能需要一些时间，为避免不必要的重复复制，建议使用 rsync。在旧机器上，以 mastodon 用户身份运行：
rsync -avz ~/live/public/system/ mastodon@example.com:~/live/public/system/
如果旧服务器上的任何文件发生更改，你需要重新运行此命令。
你还应该复制 .env.production 文件，其中包含密钥。
在新机器上，确保 Redis 未运行，否则它可能会覆盖你尝试还原的转储文件。以 root 用户身份运行：
systemctl stop redis-server.service
现在复制你的 Redis 数据库（根据需要调整 Redis 数据库的位置）。在旧机器上，以 root 用户身份运行：
redis-cli SAVE
systemctl stop redis-server.service
rsync -avz /var/lib/redis/ root@example.com:/var/lib/redis
作为可选操作，你可以复制 nginx、systemd 和 PgBouncer 配置文件，或者从头重写它们。
迁移期间
你可以编辑旧机器上的 ~/live/public/500.html 页面，以显示一条友好的错误消息，让现有用户知道迁移正在进行中。
你可能还想在提前一天将 DNS TTL 设置为较小的值（30-60分钟），这样一旦你将其指向新 IP 地址，DNS 就可以快速传播。
迁移后
以mastodon用户身份运行以下命令：
RAILS_ENV=production bundle exec rails assets:precompile
现在以 root 用户身份运行以下命令：
systemctl daemon-reload
systemctl start redis-server
systemctl enable --now mastodon-web mastodon-sidekiq mastodon-streaming
systemctl restart nginx
一旦服务器重新上线，你可以为用户重建主页时间线（这可能需要很长时间，取决于用户数量。）
RAILS_ENV=production ./bin/tootctl feeds build
如果你使用 Elasticsearch，请运行以下命令重建索引（这可能需要很长时间，取决于你拥有的状态数量。）
RAILS_ENV=production ./bin/tootctl search deploy
你可以查看 whatsmydns.net 以了解 DNS 传播的进度。要加速这个过程，你可以编辑自己的 /etc/hosts 文件，指向新服务器，这样你就可以提前开始使用它。
{{< translation-status-zh-cn raw_title="Migrating to a new machine" raw_link="/admin/migrating/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}