部署專案管理搬遷專案

搬遷專案

搬遷專案的本質是複製專案 + 資料同步。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 整合

搬遷過程中如遇問題,請到 社群論壇 聯絡我們。