從零開始，把你的專案
部署到 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 月改版後共有四個訂閱方案，從個人到團隊各有對應。先看一眼定位：
- 可管理 1 台伺服器
- 建置機器 2C4G、日誌保留 48 小時
- 適合熟悉介面、學習部署流程
- 部署仍需另外購買伺服器
- 前 14 天免費試用
- 可管理 3 台伺服器
- Zeabur Agent（AI 助手）
- 日誌保留 7 天
- 網域購買、Email 系統
- 前 14 天免費試用
- 可管理 10 台伺服器
- 建置機器 4C8G
- 日誌保留 30 天、進階日誌搜尋
- 含 3 個席位，每多 1 席 +$24/月
- 伺服器數量不限
- 角色權限管理、團隊協作
- 日誌保留 90 天、優先支援
計費邏輯：訂閱方案＋伺服器月租
共享叢集已停用：Zeabur 原本免費的「共享叢集（Shared Cluster）」自 2026 年 4 月 1 日起不再接受新專案與新服務（官方公告），現在部署一律要使用伺服器（Server）。
現在在 Zeabur 上線一個網站，費用分成兩部分：
| 項目 | 說明 | 計費 |
|---|---|---|
| 訂閱方案 Plan | 決定能管理幾台伺服器、日誌保留多久、能不能用 AI 與買網域等功能 | Free $0、Dev $5、Pro $19、Team $79 起（月費） |
| 伺服器 Server | 實際執行網站與資料庫的機器，可在 Zeabur 直接購買，或連接自己的主機 | 固定月租，依地區與規格而定（以官網價格頁為準） |
訂閱費和伺服器月租是分開計算的：Free 方案本身不收費，但沒有伺服器就無法部署服務。
新手建議
正式上線：用 Free 方案＋購買一台最小規格的伺服器就能部署；需要 AI 助手、買網域或管理多台伺服器時，再升級到 Dev 或 Pro。
只想免費練習部署流程：可以改用 Render 或 Vercel 搭配 Neon 資料庫，做法請看〈零基礎AI輔助程式設計：其他免費平台〉。
建立專案
專案（Project）是一切的容器，所有服務都放在裡面。
在 Zeabur 的結構中：一個 專案（Project） 裡可以包含多個 服務（Service），例如一個專案同時放「前端網站 + 後端 API + 資料庫」。同一專案內的服務可以走內網互相溝通。
進入控制台點擊 Create Project
在 Dashboard 點選 建立專案 / Create Project 按鈕。
命名專案
幫專案取個好辨識的名字，例如 my-blog 或 side-project。
選擇部署的伺服器
選擇你已購買或已連接的伺服器。購買伺服器時請選離使用者最近的地區（如 Tokyo / Hong Kong），可降低延遲。建立後就能開始加入服務。
伺服器所在地區會影響網路延遲。台灣的使用者通常選東京、香港等亞洲機房體驗較佳。
部署服務
三種把程式碼送上 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。