快速開始

本文帶你接入一台伺服器，並從 GitHub 部署一個應用。

1. 建立帳號

在 zenavo.app 用電子郵件、GitHub 或 Google 註冊。

用電子郵件和密碼註冊的話，請先開啟 Zenavo 發給你的郵件裡的連結：電子郵件驗證之前，你不能新增伺服器，也不能部署。

2. 新增伺服器

你需要一台有公開 IP 的 Linux 伺服器，至少 1 核 CPU、2 GB 記憶體。詳見伺服器需求。

1. 在控制台開啟 伺服器 → 新增伺服器。
2. 填寫伺服器的 IP 位址、SSH 連接埠和使用者（例如 root，大多數雲端映像檔上是 ubuntu）。
3. 選擇 密碼 或 私鑰。可以上傳金鑰檔案（例如 ~/.ssh/id_ed25519，或雲端服務供應商提供的 .pem 檔案），也可以直接貼上。
4. 點選 連線並初始化。Zenavo 會檢查伺服器，安裝 K3s 和 cert-manager，並在伺服器的 狀態 分頁顯示進度。初始化需要幾分鐘。

3. 建立專案

1. 開啟 專案 → 新建專案。
2. 選擇伺服器。專案名稱可以不填，留空會自動生成一個。
3. 點選 建立專案。專案開啟時是空的。

4. 新增服務

1. 點選 新增服務（或按 ⌘ K）。
2. 選擇 GitHub。第一次使用時，點選 連線 GitHub，選擇 Zenavo 可以讀取的儲存庫。
3. 選擇儲存庫，再選擇分支。
4. 在 設定建置計劃 中檢查服務名稱和根目錄，如果應用需要環境變數就在這裡新增。點選 下一步。
5. 建置計劃預覽 顯示 Zenavo 識別出的內容，例如 Go 1.26。點選 部署。

服務會依次顯示 等待中、建置中、部署中、啟動中，最後是 執行中。開啟 日誌 可以檢視建置過程。

5. 繫結網域

開啟服務的 網路 分頁，點選 繫結自己的網域。把網域的 A 記錄指向伺服器的 IP 位址；解析生效後會自動簽發 HTTPS 憑證。詳見網域與 HTTPS。