從零開始，把你的專案
部署到 Zeabur
一份手把手的完整流程指南：選方案、建專案、上傳程式碼、設定環境變數、綁定網域，一次搞懂。
開始之前
先認識 Zeabur 是什麼，並完成帳號註冊。
Zeabur 是一個雲端應用部署平台（PaaS）。你不需要自己架伺服器、設定環境或處理複雜的運維，只要把程式碼交給它，它就會自動偵測語言、建置並上線。支援 Node.js、Python、Go、PHP、Java、Rust、Docker、靜態網頁等幾乎所有主流技術。
適合誰？
想快速上線個人專案、Side Project、Discord Bot、API 服務、部落格或作品集網站的開發者，特別是不想碰繁雜伺服器設定的人。
註冊帳號
前往官網註冊
打開 zeabur.com，點擊右上角 Sign Up / 登入。
選擇註冊方式
建議直接用 GitHub 帳號 登入註冊，後續部署 GitHub 專案最順暢。也可以用 Email 註冊。
進入 Dashboard 控制台
註冊完成後會進入控制台，這裡是你管理所有專案與服務的地方。
用 Email 註冊的人，之後仍可在 控制台 › 設定 › 整合 綁定 GitHub。一個 GitHub 帳號只能綁定一個 Zeabur 帳號。
方案選擇
免費與付費方案怎麼選？先搞懂計費邏輯再決定。
Zeabur 在 2026 年 4 月改版後共有四個訂閱方案，從個人到團隊各有對應。先看一眼定位：
- 免信用卡，註冊即用
- 共享叢集免費區域部署
- 適合試玩、學習部署流程
- 不含專用伺服器額度
- 14 天免費試用
- 每月含 US$5 免付費額度
- 解鎖 Zeabur AI
- 自動資料庫備份
- 網域購買、Zeabur Email
- 更高資源上限
- 完整 Observability 監控
- 完整 AI 能力
- 填補 Dev 與 Team 之間的需求
- 多席位支援
- 權限管理
- 更高資源額度
- 團隊協作功能
計費邏輯：按量計費
Zeabur 採用 按量計費（usage-based），你只為服務「實際使用」的資源付費，沒用到的不收錢。要先分清楚兩種伺服器類型：
| 類型 | 說明 | 計費 |
|---|---|---|
| 共享叢集 Shared Cluster | 多人共用的運算資源，最快上手 | 依記憶體、流量、儲存空間按量計費 |
| 專用伺服器 Dedicated Server | 整台機器專屬於你 | 固定月租，不收使用費 |
Dev 方案每月內含 US$5 免付費額度：若當月共享叢集用量沒超過 $5，就不會額外收費；超過的部分才依費率計算。這個額度只適用共享叢集資源，不含專用伺服器租金。
訂閱費（如 Dev $5/月）主要解鎖「自動備份、AI、買網域」等加值功能；而專用伺服器的月租是另外計算的固定費用，兩者不要搞混。
新手建議
先用 Free 方案 跑通整個部署流程。當你需要自動備份、買自訂網域、或用量會超過免費額度時，再升級到 Dev（$5） 即可，CP 值最高。
建立專案
專案（Project）是一切的容器，所有服務都放在裡面。
在 Zeabur 的結構中：一個 專案（Project） 裡可以包含多個 服務（Service），例如一個專案同時放「前端網站 + 後端 API + 資料庫」。同一專案內的服務可以走內網互相溝通。
進入控制台點擊 Create Project
在 Dashboard 點選 建立專案 / Create Project 按鈕。
命名專案
幫專案取個好辨識的名字，例如 my-blog 或 side-project。
選擇部署區域
選擇離你的使用者最近的機房（如 Hong Kong / Tokyo），可降低延遲。建立後就能開始加入服務。
區域影響網路延遲與可用機房。亞洲使用者通常選香港或東京節點體驗較佳。
部署服務
三種把程式碼送上 Zeabur 的方式：GitHub、本地端、模板。
進入專案後，點擊 Deploy Service / 部署服務，會看到幾種來源選項。以下逐一說明。
方式 A — 從 GitHub 部署（最推薦）
用 GitHub 部署可享 開箱即用的 CI/CD：未來只要推送程式碼到 GitHub，Zeabur 就會自動重新部署。
綁定 GitHub 帳號
若用 Email 註冊，先到 控制台 › 設定 › 整合 綁定 GitHub。用 GitHub 註冊的可跳過。
安裝 Zeabur App 到 GitHub
建立服務時選擇 GitHub 類型，點 Configure GitHub，會跳到 GitHub 的 App 安裝頁。依提示選擇安裝在個人帳號或特定組織下，並授權要開放的儲存庫。
選擇並匯入儲存庫
回到 Zeabur，搜尋你的 repo，點 匯入 / Import。
自動偵測並部署
Zeabur 會自動分析語言與框架、安裝依賴、建置並上線，全程不用寫設定檔。
部署完成後，之後每次 git push 都會觸發自動重新部署，這就是 CI/CD 的威力。
方式 B — 從本地端上傳（Zeabur CLI）
沒有把程式碼放上 GitHub？可以用 Zeabur CLI 直接從本地資料夾上傳原始碼。先確認電腦已安裝 Node.js，然後在專案根目錄執行：
# 進入你的專案資料夾後執行
npx zeabur登入授權
首次執行會引導你在瀏覽器登入 Zeabur 並授權 CLI。
選擇部署目標
CLI 會以互動方式詢問要部署到哪一個專案，也可以選擇建立新專案。
上傳並部署
確認後，CLI 會打包當前資料夾的原始碼上傳，Zeabur 自動建置上線。
本地上傳不含 CI/CD，每次改完都要再跑一次 npx zeabur。長期維護仍建議用 GitHub 方式。
方式 C — 從模板 / Docker Image（補充）
想快速架現成服務（如資料庫、n8n、WordPress）？可從 模板目錄（Templates） 一鍵部署，或直接填入 Docker Image 名稱（如 nginx:latest）部署任意容器。
環境變數
把 API 金鑰、資料庫連線字串等機密設定交給環境變數管理。
環境變數（Environment Variables）讓你在不改動程式碼的情況下，注入設定值與機密資訊。絕對不要把金鑰寫死在程式碼裡。
進入服務的「環境變數」分頁
點開你要設定的服務，找到 環境變數 / Variables 區塊。
新增變數
以 Key = Value 形式新增，例如 DATABASE_URL、API_KEY、PORT。
儲存並重新部署
儲存後通常需要 重新部署 / Redeploy，新變數才會生效。
DATABASE_URL=postgresql://user:pass@host:5432/db
API_KEY=sk-xxxxxxxxxxxxxxxx
NODE_ENV=productionZeabur 支援 特殊變數，可引用其他服務的值。例如部署資料庫後，可用變數參照自動帶入連線資訊到後端服務，不用手動複製貼上。
某些語言（如 PHP）Zeabur 會帶入預設變數（如 APP_ENV）。你可以在環境變數區塊手動覆蓋這些預設值。
建立網域
讓服務能從公開網路被存取，免費網域或綁定自己的網域都行。
網域是服務對外的唯一識別。Zeabur 提供兩種選擇，都在服務頁面的 網域 / Domains 分頁操作。
選項一：產生免費網域（最快）
打開服務的「網域」分頁
進入服務頁，展開 網域 區塊。
點擊「產生網域」
輸入想要的前綴，Zeabur 會給你一個免費的 你的名稱.zeabur.app 網址，立即生效並自動配置 HTTPS。
免費 .zeabur.app 網域自動附帶 SSL 憑證，適合測試或個人專案，零設定就能 HTTPS 上線。
選項二：綁定自訂網域
想用自己的網域（如 www.mysite.com）？在網域分頁選 自訂網域 / Custom Domain，Zeabur 會給你一筆 CNAME 記錄，到你的 DNS 服務商設定即可。
輸入你的網域
在自訂網域欄位填入要綁定的網域名稱。
複製 Zeabur 給的 CNAME
Zeabur 會提供一個 CNAME 目標，類似 hkg1.clusters.zeabur.com。
到 DNS 服務商新增記錄
到 Cloudflare、GoDaddy、Gandi 等服務商，新增一筆 CNAME 記錄指向該目標。等待 DNS 生效（通常數分鐘到數小時）。
根網域（如 mysite.com 不含 www）無法用 CNAME？ 部分 DNS 商不支援根網域 CNAME。此時把 Zeabur 給的主機名（如 hkg1.clusters.zeabur.com）丟到 Google Admin Toolbox – Dig 查出對應的 A 記錄 IP，再以 A 記錄 方式填入。
用 A 記錄（IP）綁定的風險：Zeabur 可能會更新 CNAME 指向的 IP。若收到 IP 即將變更的通知，你需要手動更新這筆 DNS 記錄，否則網站會無法存取。能用 CNAME 就盡量用 CNAME。
部署後管理
上線只是開始，這些日常維運功能讓你掌握服務狀態。
| 功能 | 用途 |
|---|---|
| 日誌與串流 Logs | 即時查看執行紀錄，除錯第一站 |
| 監控指標 Metrics | 觀察 CPU、記憶體、流量使用狀況 |
| 版本還原 Rollback | 新版本出包時，一鍵回到上一個正常版本 |
| 暫停服務 Suspend | 暫時停用服務以節省資源費用 |
| 備份與還原 Backup | 資料庫自動備份（Dev 方案以上） |
| 專案預算 Budget | 設定用量上限，避免帳單超支 |
擔心費用爆掉？善用 專案預算 設定上限，並在 使用量分析 中追蹤每個服務的花費。學習階段也可在不用時 暫停服務。
恭喜你完成整個流程！ 你已經學會：選方案 → 建專案 → 部署服務 → 設定環境變數 → 綁定網域 → 維運管理。接下來就動手把你自己的專案部署上去吧。
常見問題
npx zeabur。改環境變數後也記得 Redeploy。