logo

搬出 Zeabur:把這份指南交給你的 Coding Agent

我們把 Zeabur 的底層架構,以及過去替你做掉的事,整理成一份給 agent 讀的文件。你的 agent 會讀懂你現在的服務,和你一起決定要搬去哪裡。

Zeabur TeamZeabur Team

本文亦提供 English、简体中文、日本語、Español和Bahasa Indonesia。

TL;DR: 打開 Claude Code、Codex 這類 coding agent,貼上這句話。沒有 coding agent 的話,請透過 Zeabur Support 開工單,附上你的服務和到期日,我們會協助你搬遷。

text
讀 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 轉出
  • 你的到期日,以及可以接受停機的時段
不要把 Zeabur 權杖貼進對話

讓 agent 使用你電腦上已經登入的 CLI 就好。Zeabur 的存取權杖擁有整個帳號的權限,貼進對話等於把帳號交出去。


搬遷會怎麼進行?

  1. 盤點:agent 列出每個服務的來源、網域、資料量,以及映像能不能匯出。
  2. 選方案:agent 依你的熟悉程度、預算和在意的功能,比較兩到三個方向,例如 Railway 這類託管平台、Coolify 這類自架平台、k3s 或 Docker Compose。
  3. 規劃與試跑:在新環境建好服務、搬一次資料、測試主要功能,並實際還原一次備份。
  4. 正式切換:你同意後,暫停 Zeabur 上的應用、同步最後一次資料、由你修改 DNS。
  5. 交接:agent 告訴你新環境怎麼部署、備份、回滾。

我們拿一個正式上線中的 Django 網站(PostgreSQL、Redis、應用程式、nginx)實際搬過一次:28 張資料表筆數全部一致,正式切換停機約 6 分鐘,其中約 3 分鐘在等憑證申請。


遇到問題怎麼辦?

先請 agent 整理目前的狀態和錯誤訊息,再透過 Zeabur Support 告訴我們,並附上到期日,讓我們判斷急迫程度。