迁移项目

迁移项目的本质是复制项目 + 数据同步。Zeabur 提供了复制项目功能，可以将整个项目（包含服务配置、环境变量、硬盘数据）一键复制到其他区域。搭配备份与还原功能，你可以在不同区域甚至不同账号之间完成完整的项目迁移。

跨区域迁移

若要将项目从一个区域迁移到另一个区域（例如从东京搬到旧金山），最简单的方式是使用复制项目功能：

1. 进入你要迁移的项目，打开项目设置。
2. 找到「复制项目」按钮，选择目标区域。
3. 等待复制完成（无硬盘项目可做到零停机，有硬盘项目依数据量而定）。
4. 复制完成后，为新项目重新绑定自定义域名。
5. 确认新项目运作正常后，删除旧项目。

详细步骤请参考复制项目文档。

跨账号迁移

若要将项目迁移到另一个 Zeabur 账号（例如从个人账号移至团队账号），目前需要手动操作：

1. 导出项目配置 — 使用导出项目功能，将项目的 YAML 配置下载到本机。
2. 备份数据 — 为所有有状态服务创建备份：
   • 数据库：使用备份与还原的线上备份功能。
   • 持久存储：使用离线备份或通过文件管理手动下载。
3. 在目标账号创建新项目 — 登录目标账号，在目标区域创建新项目。
4. 重新部署服务 — 依据导出的 YAML 配置，在新项目中创建对应的服务。
5. 还原数据 — 将步骤 2 的备份还原至新服务中。
6. 切换 DNS — 将自定义域名的 DNS 记录指向新项目的服务域名。
7. 验证 — 确认所有服务运作正常后，清理旧账号的资源。

注意事项

• DNS 切换 — 迁移完成前，建议先降低 DNS TTL 值，以加速 DNS 切换的生效时间。
• 环境变量 — 复制项目会自动带入环境变量；跨账号迁移则需手动重新设置，特别注意包含密钥的变量。
• 数据备份 — 迁移前务必确认所有数据库和持久存储都已完成备份。建议在迁移期间暂停对旧项目的写入操作，避免数据不一致。
• Git 集成 — 若服务连接了 GitHub 仓库，跨账号迁移后需在新账号重新设置 GitHub 集成。