入門最佳實踐

最佳實踐

依循以下實用建議,讓你在 Zeabur 上的部署既穩定又節省成本。

用環境變數管理設定

把所有設定值 — API 金鑰、資料庫連線字串、功能旗標 — 都存放在環境變數裡。絕對不要在原始碼或 Docker 映像檔中寫死任何機密。

⚠️

被 commit 進 Git 的機密會永久留在版本歷史中。請務必使用 Zeabur 的環境變數管理功能。

Zeabur 支援服務間的變數參照(例如 ${MYSQL_HOST}),可以讓連線資訊自動同步。

謹慎使用持久儲存空間

持久儲存空間對資料庫和檔案儲存來說不可或缺,但有個取捨:掛載 Volume 的服務無法執行零停機滾動部署。

⚠️

只在真正需要持久化資料的服務(資料庫、上傳檔案)掛載 Volume。無狀態的應用伺服器不應使用 Volume。

靜態資源和建置產出物建議改用物件儲存或 CDN。

設定資源上限以控制成本

為每個服務設定 CPU 和記憶體上限,避免費用失控。一個設定不當的服務可能消耗遠超應用實際所需的資源。

使用預先打包的資料庫範本

與其自己跑資料庫容器,不如使用 Zeabur 的一鍵資料庫範本。這些範本已預先設定好、會自動注入連線變數,並針對平台做過最佳化。

常用選項包括 PostgreSQL、MySQL、MongoDB 和 Redis — 全部一鍵即可部署。

合理規劃專案結構

用清晰的專案結構組織你的工作負載:

  • 一個應用對應一個專案 — 把相關服務(API、前端、資料庫)放在同一個專案裡。
  • 分離環境 — 為正式環境、測試環境和開發環境建立不同的專案。
  • 命名慣例 — 使用具描述性的專案和服務名稱,方便團隊在 Dashboard 中快速找到目標。

使用 Git 部署

連結你的 GitHub 或 GitLab 儲存庫,每次推送即可自動部署。你會獲得:

  • 無需額外工具的完整 CI/CD 自動化。
  • 透過還原 commit 即可自動回滾版本。
  • 基於分支的預覽環境用於 pull request 測試。

如果專案不在 Git 儲存庫中,也可以透過 CLI 或 Docker 映像檔部署。

啟用自訂網域與 HTTPS

Zeabur 會為所有自訂網域自動簽發 TLS 憑證。只要把 DNS 指向 Zeabur,HTTPS 就會零設定自動啟用 — 詳細設定請參閱自訂網域

正式服務建議使用自己的網域,維持專業形象,避免共用預設的 *.zeabur.app 子網域。

監控用量並最佳化成本

定期查看帳單儀表板,了解你的支出狀況:

  • 找出記憶體用量過高的服務並適當調整資源配置。
  • 移除不再使用的服務和專案 — 閒置資源仍會產生費用(Free Plan 會自動休眠除外)。
  • 透過訂閱管理追蹤額度與帳單。

使用預覽環境做測試

啟用預覽部署,讓每個 pull request 都有獨立的隔離環境。這讓你的團隊可以在合併前在類正式環境中測試變更。

當分支被刪除或 PR 關閉時,預覽環境會自動清理。

定期備份重要資料

雖然 Zeabur 在基礎設施層提供可靠性,你仍應為關鍵資料維護自己的備份:

  • 使用備份與還原功能建立資料庫快照。
  • 透過設定檔管理匯出重要設定。
  • 將備份存放到外部儲存空間(例如物件儲存)以備災難復原之需。

將這些做法與 Zeabur 內建功能搭配 — 例如高可用性 — 就能為正式工作負載打下穩固的基礎。