迁出 Zeabur：把这份指南交给你的 Coding Agent
我们把 Zeabur 的底层架构，以及过去替你做掉的事，整理成一份给 agent 读的文档。你的 agent 会读懂你现在的服务，和你一起决定要迁到哪里。
Zeabur Team本文亦提供 English、繁體中文、日本語、Español和Bahasa Indonesia。
TL;DR： 打开 Claude Code、Codex 这类 coding agent，粘贴这句话。没有 coding agent 的话，请通过 Zeabur Support 提交工单，附上你的服务和到期日，我们会协助你迁移。
读 https://zeabur.com/blogs/migrate-from-zeabur.md，帮我把服务从 Zeabur 迁出去。agent 会先盘点你的服务，问清楚你的需求，再推荐方案，带你一步步迁完。每一个会改动东西的步骤，它都会先征求你的同意。想知道 agent 读到了什么，可以切换到页面下方的 AGENT 视图。
这份指南会随着停止运营的进度和大家反馈的问题陆续更新。开始迁移前，请让 agent 重新读取一次最新版本。
根据 停止运营公告：专用服务器从 12 月 1 日起按各自的到期日陆续关闭；共享集群从 12 月 1 日起暂停所有服务，你仍可手动恢复运行来备份数据；12 月 31 日所有服务停止。请按自己的到期日安排时间，不要等到最后一天。
为什么交给 agent？
每个人的项目、熟悉程度和预算都不一样。有人只想让网站继续运行，有人想完全掌控服务器，也有人想找一个延续 Zeabur「推上去就部署好」的做法。一份固定的教程没办法同时照顾到所有人。
你的 agent 能直接读你的代码、登录你的服务器，看到的远比我们在文章里能假设的多。我们把它自己推断不出来的部分写成了文档：
- 你的服务在 Zeabur 底层是哪些 Kubernetes 对象，数据、镜像、变量放在哪里
- Zeabur 过去替你做掉、迁移后需要有人接手的事
- 迁移时常出错的地方
要迁到哪里、用什么工具，由 agent 根据你的情况给出建议，最后由你决定。
你是哪一种用户？
| 类型 | 机器之后会怎样 | agent 怎么读取现状 |
|---|---|---|
| 在 Zeabur 租用的专用服务器 | 属于 Zeabur 的云账号，到期后会被删除，磁盘数据不会保留 | SSH 登录服务器，直接读取上面的 k3s |
| 自己的服务器（绑定到 Zeabur） | 留在你手上，但 Zeabur 装在上面的组件会失效 | SSH 登录服务器，直接读取上面的 k3s |
| 共享集群 | 服务会被暂停，之后停止 | 没有 SSH，通过 Zeabur CLI 与控制台 |
专用服务器的 root 密码在购买时发送到你的邮箱，忘记的话可以在控制台重置，也可以用 npx zeabur@latest server ssh 登录。
Zeabur 替你做了哪些事？
迁移之后，下面每一项都要有新的负责方。agent 规划时会逐项说明：
| Zeabur 替你做的事 | Zeabur 停止运营后 |
|---|---|
| 从 Git 源码自动构建镜像 | 需要 Dockerfile 或新平台的构建功能 |
| 镜像存放在 Zeabur 的镜像仓库 | 拉取不到了，服务一重启就起不来 |
| push 自动部署、部署记录、一键回滚 | 需要 CI/CD 或具备这些功能的平台 |
*.zeabur.app 域名 | 失效，要换成自己的域名 |
| HTTPS 证书自动申请与续期 | 需要反向代理或平台的证书功能 |
服务之间用 .zeabur.internal 互连 | 需要换成新环境的连接方式 |
| 同项目服务的变量自动注入 | 要把实际的值带走 |
| 每日自动备份数据库 | 备份会一起消失，要先导出并建立自己的备份 |
| 日志、监控图表、崩溃与资源告警 | 需要自己的日志、监控与告警 |
| 团队成员与权限 | 在新平台重新设置 |
最容易出问题的是镜像和自动注入的变量。前者在 Zeabur 停止运营之后才会爆发；后者在迁移当下就会让应用连不上数据库。
开始之前
- 一个 coding agent，例如 Claude Code 或 Codex
- 电脑上装有 Node.js，并用拥有项目的账号登录 Zeabur CLI：
npx zeabur@latest auth login - 专用服务器：能 SSH 登录服务器
- 能修改域名 DNS 的权限；域名是在 Zeabur 购买的话，到 Dashboard 转出
- 你的到期日，以及可以接受停机的时段
让 agent 使用你电脑上已经登录的 CLI 就好。Zeabur 的访问令牌拥有整个账号的权限，粘贴到对话里等于把账号交出去。
迁移会怎么进行？
- 盘点：agent 列出每个服务的来源、域名、数据量，以及镜像能不能导出。
- 选方案：agent 根据你的熟悉程度、预算和在意的功能，比较两到三个方向，例如 Railway 这类托管平台、Coolify 这类自建平台、k3s 或 Docker Compose。
- 规划与试运行：在新环境建好服务、迁移一次数据、测试主要功能，并实际还原一次备份。
- 正式切换：经你同意后，暂停 Zeabur 上的应用、同步最后一次数据、由你修改 DNS。
- 交接：agent 告诉你新环境怎么部署、备份、回滚。
我们拿一个正式上线中的 Django 网站（PostgreSQL、Redis、应用程序、nginx）实际迁移过一次：28 张数据表的行数全部一致，正式切换停机约 6 分钟，其中约 3 分钟在等待证书签发。
遇到问题怎么办？
先请 agent 整理当前的状态和错误信息，再通过 Zeabur Support 告诉我们，并附上到期日，方便我们判断紧急程度。