Zeabur 上自己寫的 Node.js、Next.js、Python 程式,可以分五步搬走:先把程式碼和環境變數拿回來,再匯出資料庫和上傳過的檔案,接著在新主機部署、用預設網址測過,最後才改網域的 DNS,上線前把登入、表單、Webhook 走一遍。Zeabur 官方建議 11 月 30 日前搬完,12 月 31 日所有服務停止、資料一起刪除,現在開始動手,時間還來得及。
這篇是動手版,用 RoamerHost 的 Vibe Coding 主機當新家示範,指令和要注意的地方換到別的平台大多也用得上。Zeabur 發生了什麼事、退款和求償怎麼申請、n8n 與 WordPress 怎麼搬,整理在Zeabur 替代方案與搬家指南,這裡不再重複。
Zeabur 的時程、CLI 指令與平台行為,整理自 Zeabur 10 月 20 日的遷移指南與 10 月 22 日的搬家公告,2026 年 11 月 11 日查證。之後若有更新,以 Zeabur 官方為準。
動手之前:先列出你的專案用了 Zeabur 哪些東西
搬家最常出錯的,通常是那些在 Zeabur 上「自動就有」、平常不會注意到的東西。Zeabur 的遷移指南列得很清楚:*.zeabur.app 的網址會停止解析,服務之間用來互連的 .zeabur.internal 內部網址會失效,從 Git 建置出來的映像檔放在 Zeabur 自己的倉庫,平台關掉後就抓不到了;推送就部署、部署紀錄、一鍵回滾、Zeabur 替資料庫做的自動備份,也都要在新平台重新建立。
先登入 Zeabur CLI,把每個服務的設定記下來。用擁有這個專案的帳號登入,指令會在你自己的電腦上執行:
npx zeabur@latest auth login
npx zeabur@latest project export --id <projectID>
npx zeabur@latest service list --project-id <projectID>
npx zeabur@latest --json service get --id <serviceID>
npx zeabur@latest --json variable list --id <serviceID>
npx zeabur@latest domain list --id <serviceID>
projectID 是控制台網址裡 project- 後面那 24 個字元。service get 會列出原始 repo、分支、根目錄和你自訂過的建置、啟動指令,搬家時要照著設。project export 和 variable list 的輸出裡有密碼和金鑰,Zeabur 指南特別提醒要當成機密,只存在自己電腦上權限設成 600 的檔案裡,不要貼進聊天視窗,也不要放進版本控制。
如果你習慣用 Claude Code 或 Codex,Zeabur 也準備了一份給 AI 讀的遷移說明,在 AI 工具裡請它讀 https://zeabur.com/blogs/migrate-from-zeabur.md 再幫你盤點。讓 AI 用你電腦上已經登入的 CLI 操作就好,Zeabur 的權杖不要交給它。
第一步:把程式碼拿回來
服務是連 GitHub 部署的,程式碼本來就在 repo 裡,這一步最輕鬆。要對照的是 Zeabur 上的設定:根目錄是不是子資料夾、有沒有 zbpack.json 或 ZBPACK_ 開頭的變數改過建置和啟動指令。Zeabur 用開源的 zbpack 偵測專案,這些設定在新平台不會自動跟過去,要自己記下來重設。
當初是直接上傳程式碼部署、手上已經沒有原始碼的,Zeabur 指南的做法是從執行中的容器把檔案打包出來。用 service exec 在容器裡執行 tar,輸出轉成 base64 傳回本機再還原,指南裡有完整指令。要知道的是,拿回來的可能只是建置好的檔案,不是原始碼;靜態網站還能直接放,有後端的程式之後要改就麻煩了,能找回原始碼的話盡量找回來。
程式碼拿回來之後,先在 repo 裡找一次 zeabur.app 和 zeabur.internal。程式裡寫死的網址、OAuth 回呼網址、金流與 LINE 的 Webhook 設定,常常藏著舊網址,這些都要換。
第二步:環境變數要拿到真正的值
環境變數是 Zeabur 搬家最容易漏的地方,原因有兩個。第一,Zeabur 的變數可以用 ${VAR} 參照別的變數,variable list 和 project export 輸出的是還沒展開的寫法,例如 ${PASSWORD},真正的值要另外查。第二,程式很常透過「別的服務分享過來的變數」連資料庫,例如 POSTGRES_CONNECTION_STRING、REDIS_URI,這些放在 readonlyVariables,不會出現在這個服務自己的變數清單裡。最保險的做法,是在程式碼裡搜尋實際讀了哪些變數,一個一個確認新環境都有值。
Zeabur 自己注入的變數也要換掉。ZEABUR_WEB_URL 這類公開網址、<服務名稱>_HOST 這類其他服務的位址,搬家後都不存在了。連接埠也要看一下:Zeabur 從 Git 建置的服務,沒偵測到別的埠時預設聽 8080。Vibe Coding 主機要求程式監聽 0.0.0.0 和環境變數 PORT,程式裡如果把 8080 或 3000 寫死,改成讀 PORT。
最後一件事一定要做:Zeabur 今年兩次資安事件都外洩了環境變數,凡是放在 Zeabur 上、現在還有效的 API 金鑰、資料庫密碼、第三方服務的權杖,都重新產生一組再設進新環境,舊的直接作廢。在 Vibe Coding 主機上,環境變數在專案頁或透過你的 AI 設定,加密保存、寫入後不再顯示;上傳的 .env 檔不會被部署,只有 VITE_、NEXT_PUBLIC_ 這類本來就會打包進前端的公開變數,部署時會自動帶入建置。
第三步:匯出資料庫和上傳過的檔案
Zeabur 會替資料庫做自動備份,但平台關掉之後這些備份也跟著消失,控制台上的備份下載連結只有 15 分鐘效期,不要把它當成你的備份。自己用官方工具匯出一份,而且工具的主版本要跟來源資料庫一樣。
PostgreSQL 建議一個資料庫一個資料庫用 pg_dump 匯出純 SQL。Zeabur 指南提醒不要直接拿 pg_dumpall 的檔案還原,裡面的 ALTER ROLE … PASSWORD 會把新環境的密碼蓋成舊的,CREATE ROLE、CREATE DATABASE 也會跟新環境已經建好的帳號衝突。在 Zeabur 容器裡連資料庫要用 127.0.0.1,用 localhost 有時會卡住。
pg_dump -h 127.0.0.1 -U <user> -d <dbname> --no-owner --no-acl | gzip > app.sql.gz
mariadb-dump -h 127.0.0.1 -u <user> -p --single-transaction <dbname> | gzip > app.sql.gz
MySQL 或 MariaDB 用 mysqldump 或 mariadb-dump。Vibe Coding 主機的資料庫預設關閉,要用才開,可以選 PostgreSQL 16(內建 pgvector)或 MariaDB 11.4(相容 MySQL),連線資訊會放進 DATABASE_URL 等環境變數,程式直接讀就好。匯入有兩條路:讓你的 AI 透過 MCP 拿一次性網址上傳 .sql 或 .sql.gz,單次上限 95MB,或在後台上傳,上限 32MB;更大的檔案寫信到 [email protected],我們協助匯入。匯入前平台會先留一份快照。匯完逐張資料表比對筆數,Zeabur 指南也建議在切換前真的還原一次備份,有產生匯出檔不等於備份能用。
MongoDB 和 Redis 這裡不提供。程式如果靠它們存資料,要改寫成 PostgreSQL 或 MariaDB,或是另外找能提供這些資料庫的服務。Redis 只拿來當快取或存 Session 的話,比較簡單的做法是改存資料庫。
使用者上傳的圖片、附件,在 Zeabur 通常放在 Volume 裡。搬過來之後要放在 /data,這是長期保存的資料夾,部署換版不會被蓋掉;程式原本寫進 uploads 這類相對路徑的,可以設定成接到 /data,不用改程式。
第四步:在新主機部署 Next.js、Node.js、Python
Vibe Coding 主機不跑 Dockerfile,部署時用平台維護的執行環境,會自動偵測專案類型:有 package.json 是 Node.js(22、24),有 requirements.txt 是 Python(3.12、3.13),有 composer.json 是 PHP 8.4,只有 index.html 或 Vite 這類前端是靜態網站。專案裡留著 Dockerfile 沒關係,平台會直接看程式本身;但如果只有 Dockerfile、沒有上面這些檔案,就認不出來。
Next.js 用一般的 next build、next start 就可以,next start 本來就會讀 PORT;我們實測過 Next.js 16。Express、Fastify 這類 Node.js 伺服器,確認 listen 用的是 process.env.PORT、主機是 0.0.0.0。Python 的 FastAPI 啟動指令寫成 uvicorn main:app --host 0.0.0.0 --port $PORT,Flask、Django 改用 gunicorn 同理;Django 記得用環境變數設 SECRET_KEY、DEBUG=False。資料表結構變更(例如 npx prisma migrate deploy、python manage.py migrate)設成部署前指令,平台每次部署會先留快照再跑。
把程式放上去有三種方式。程式在 GitHub 的話,在專案頁連接 repo,之後推送到指定分支就自動部署,私有 repo 加一把只能讀的部署金鑰就好,這正好取代 Zeabur 的推送就部署,步驟寫在用 GitHub 自動部署的教學。用 Claude Code、Codex 或 Gemini CLI 的話,在專案頁建立權杖,把指令貼進 AI 工具,請它「照這份專案部署到 RoamerHost,失敗就看紀錄修好」。手上只有檔案的,壓成 ZIP 在後台上傳,node_modules、.venv 不用一起壓,部署時會依 lockfile 重新安裝。
新版本要先通過健康檢查才會上線,沒通過就繼續跑舊版,並告訴你哪裡出錯;平台保留最近 3 個成功版本,可以一鍵回去,但資料庫不會跟著還原。Zeabur 上的功能在這裡大致對得上,對照如下:
| 在 Zeabur 上 | 在 Vibe Coding 主機 |
|---|---|
| 連 GitHub 推送就部署 | GitHub 自動部署,一個專案綁一個 repo、一個分支,私有 repo 可以 |
| 部署紀錄、一鍵回滾 | 部署紀錄、保留最近 3 個成功版本可以回滾 |
| 資料庫自動備份 | 自動備份,另外可以自己留資料庫快照 |
| Volume | /data 長期保存資料夾 |
| 定時要跑的工作 | 排程:平台照時間呼叫程式裡的網址,最短每 5 分鐘,最多 5 個 |
*.zeabur.app 網址 | 名稱.roamerhost.com,SSL 自動,再綁一個自己的網域 |
| 同一專案裡多個服務、Redis、背景工作 | 不支援,一個方案放一個網站 |
第五步:換網域,改 DNS
先用平台給的預設網址 名稱.roamerhost.com 把網站完整測過,再動網域。正式切換前一兩天,可以先把網域 DNS 紀錄的 TTL 調短,切換和萬一要退回時都生效得比較快。
在專案頁或請你的 AI 綁定網域,平台會告訴你要到網域商設定哪幾筆 DNS 紀錄,設好後按驗證,成功就自動申請 SSL,之後也會自動續約。一個方案可以綁一個網域,根網域連同 www,或單一個子網域。原本在 Zeabur 用 app.example.com 和 api.example.com 分開放前後端的,這裡要各開一個方案,或把前後端合成一個專案,Next.js 本來就能前後端寫在一起。網域當初是在 Zeabur 買的,官方已經開放在控制台自助轉出,記得在 11 月 30 日前處理。
網址換了之後,外部服務也要跟著改:Google、GitHub 這類 OAuth 登入的回呼網址,金流、LINE 的 Webhook 網址,Supabase 的 Site URL 與 Redirect URLs。程式裡不要寫死網址,用請求的 Host 組網址,或自己設 APP_URL 環境變數。
上線前最後檢查
Zeabur 指南說得很直接:網頁回 200、HTTPS 正常,不代表搬完了。切換前用電腦和手機各走一次主要流程:註冊登入一次、表單送一次、付款或 Webhook 至少觸發一次、排程等它跑過一次、上傳一張圖片確認重新部署後還在。資料庫筆數再對一次,確認寄信功能正常,程式寄信請用寄信服務的 HTTPS API。
切換的順序是先暫停 Zeabur 上的應用程式、最後同步一次資料,再改 DNS。Zeabur 上的服務先暫停、不要刪,萬一新環境有問題,把 DNS 改回去、用 npx zeabur@latest service restart 恢復舊服務就能退回。這條退路只在你的 Zeabur 服務到期前有效,專用伺服器依各自的到期日關閉,可能比 12 月 31 日更早。新家穩定跑幾天後,記得到 GitHub 解除 Zeabur 的連結。
哪些程式不適合搬到 Vibe Coding 主機
先講清楚,免得搬到一半才發現卡住。Vibe Coding 主機只收用網址打開、透過 HTTP 服務的網站和 Web App,一個方案放一個網站。下面這些情況要找能做到的服務:同一個專案要跑好幾個服務、需要常駐的背景工作或佇列、程式一定要自帶 Redis 或 MongoDB、只跑排程或 Discord 這類沒有網頁的機器人、一定要用 Dockerfile 或自己的映像檔、用 Go、Rust、Java 這類其他語言、需要 GPU,或需要 root 權限、遠端執行指令。
反過來,如果你在 Zeabur 上跑的是一個 Next.js 網站、一個 Express 或 FastAPI 的 API 加 PostgreSQL、一個 Laravel 專案,或是 Lovable、Bolt 做的 React 加 Supabase 前端,都在支援範圍內。要的其實是形象網站、部落格或網路商店,不想再碰程式,直接看 WP × Roamer AI 會比較省事;主機的類型和分工差在哪,可以看虛擬主機、VPS、代管的差別。
怎麼選
如果你在 Zeabur 上跑的是自己寫的 Next.js、Node.js 或 Python 網站,已經會用 Claude Code、Codex 這類 AI 工具,想要有人顧主機、台幣付款開發票、中文客服:選 Vibe Coding 主機基本版,每月 NT$299 起(年繳 NT$3,588),用你自己的 AI 透過 MCP 部署。如果程式是別人寫的、你自己不太會改,希望搬過來之後能用對話請 AI 修改和加功能:選 Vibe Coding 主機進階版,平均每月 NT$999(年繳),另含 Roamer AI,搬來的程式 Roamer AI 盡力協助、不保證。兩個方案的完整內容寫在 Vibe Coding 主機方案與價格,每筆新購買付款起 30 天內可以全額退費。
要放的不只一個網站,或是需要多個服務、背景工作、Redis,就要找能做到的服務。時間不多的話,先把資料庫和環境變數的真實值匯出來存好,這兩樣最難補救。
常見問題
Q:Zeabur 上的 Next.js 要改程式才能搬嗎?
多半不用。一般的 Next.js 專案用 next build、next start 就能在 Vibe Coding 主機跑,next start 會讀平台給的 PORT。要改的通常是程式裡寫死的 zeabur.app 網址、靠 Zeabur 注入的變數,以及使用者上傳的檔案要改存 /data。
Q:Zeabur 的環境變數可以整包匯出嗎?
可以用 npx zeabur@latest --json variable list 和 project export 匯出,但輸出的是還沒展開的 ${VAR} 寫法,從別的服務分享過來的變數也要另外看 readonlyVariables。拿到之後,凡是金鑰和密碼都重新產生一組再設進新環境。
Q:資料庫很大,超過 95MB 怎麼辦?
先壓成 .sql.gz,通常會小很多。還是太大的話,寫信到 [email protected],我們協助你匯入。單一 INSERT 太大也可能失敗,匯出時讓每筆資料分開寫比較穩。
Q:搬家可以請你們幫忙嗎?
自己寫的程式由你自己或你的 AI 部署,平台負責讓程式跑起來,基本版不包含幫你改程式。部署過程卡住,可以問網站右下角的客服小浪,或寫信到 [email protected],我們會確認平台這邊是否正常;資料庫太大匯不進去,也可以請我們協助。
資料來源
- Zeabur:Moving off Zeabur 遷移指南(10 月 20 日)、給 AI 工具讀的遷移說明
- Zeabur:服務遷移、退款與資安事件求償說明(10 月 22 日)
- Zeabur:zbpack 原始碼(Zeabur 偵測與建置專案的工具)
- RoamerHost:Vibe Coding 主機支援範圍與限制