入門最佳實踐

最佳實踐

遵循以下實用建議,讓你在 Zeabur 上的部署更穩定、更省錢。

使用環境變數管理設定

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

⚠️

一旦把機密提交到 Git,就會永久留在版本歷史中。請務必使用 Zeabur 的環境變數管理功能。

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

謹慎使用持久儲存空間

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

⚠️

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

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

設定資源上限以控制成本

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

使用平台內建資料庫服務

與其自己跑資料庫容器,不如在建立服務時選擇「資料庫」類別,直接部署 Zeabur 提供的託管資料庫。它們已預先設定好,會自動注入連線變數,並針對平台做過最佳化。

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

合理規劃專案結構

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

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

使用 Git 部署

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

  • 無需額外工具的完整 CI/CD 自動化。
  • 透過還原 commit 即可自動還原版本。
  • 自動 CI/CD:推送程式碼後自動重新部署。

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

啟用自訂網域與 HTTPS

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

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

監控用量、最佳化成本

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

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

定期備份重要資料

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

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

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