快速開始

Piora 是一套自託管的 PaaS 平台，讓你在自己的 VPS 上享有如同 Heroku、Railway 般的一鍵部署體驗。你只需要準備一台 VPS，Piora 會透過 SSH 自動安裝所有必要元件，包括 Docker、Traefik 反向代理，以及多種建置工具。

本指南將帶你從零開始，完成註冊、連接伺服器、到成功部署第一個應用程式的完整流程。

預估時間

整個設定過程大約需要 10-15 分鐘。

前置需求

在開始之前，請確認你已準備好以下項目：

• 一台 VPS 主機 — 支援 Ubuntu 18.04+ 或 Debian 10+ 作業系統
• 網路連線 — VPS 需開放 22（SSH）、80（HTTP）、443（HTTPS）連接埠
• 付款方式 — 支援信用卡或金融卡（透過 Stripe 處理）

VPS 供應商推薦

Piora 可搭配任何主流 VPS 供應商使用，例如 DigitalOcean、Linode、Vultr、Hetzner 等。建議選擇至少 1 vCPU / 1 GB RAM 的方案，2 vCPU / 2 GB RAM 以上為佳。

設定步驟

1. 註冊帳號

   前往 app.piora.dev/register 建立你的 Piora 帳號。你可以使用電子郵件註冊，或透過 GitHub / Google 第三方登入。

   註冊完成後，系統會引導你進入控制面板。

2. 選擇訂閱方案

   Piora 採用按月或按年訂閱制：

   項目	月繳	年繳（享 85 折）
   第一台伺服器	$4.50 / 月	$3.83 / 月
   額外伺服器	$3.50 / 月	$2.98 / 月

   選擇方案後，系統會導向 Stripe 安全結帳頁面完成付款。付款成功後即可開始設定伺服器。

   年繳更划算

   選擇年繳方案可享 15% 折扣，長期使用更加經濟實惠。

3. 產生 SSH 金鑰

   訂閱成功後，Piora 會自動為你的帳號產生一組專用的 SSH 金鑰對，金鑰名稱為 piora-cloud-ssh-key。

   你需要將公鑰加入到 VPS 的 ~/.ssh/authorized_keys 檔案中，讓 Piora 能夠透過 SSH 連線到你的伺服器。

   手動設定

   # 複製 Piora 控制面板中顯示的公鑰
   # 在你的 VPS 上執行：
   mkdir -p ~/.ssh
   echo "你的-piora-公鑰" >> ~/.ssh/authorized_keys
   chmod 600 ~/.ssh/authorized_keys

   VPS 供應商設定

   許多 VPS 供應商（如 DigitalOcean、Hetzner）允許你在建立主機時直接匯入 SSH 公鑰。你可以在建立新的 VPS 時，將 Piora 提供的公鑰貼入供應商的 SSH 金鑰設定欄位。

4. 連接 VPS

   在 Piora 控制面板中，點選「新增伺服器」並填入以下資訊：

   • 伺服器名稱 — 自訂名稱，方便你辨識（例如 production-server）
   • IP 位址 — 你的 VPS 公開 IP
   • SSH 連接埠 — 預設為 22
   • SSH 使用者 — 通常為 root

   填寫完成後點選「連接」，Piora 會先驗證 SSH 連線是否正常。

   使用 root 帳號

   首次設定建議使用 root 帳號，因為自動安裝過程需要完整的系統權限來安裝 Docker 和其他元件。

5. 自動安裝環境

   連線驗證成功後，Piora 會自動在你的 VPS 上安裝以下元件：

   元件	說明
   Docker 28.5.0	容器化引擎，所有應用都以容器方式運行
   Docker Swarm	Docker 原生的叢集管理與編排工具
   Traefik	自動反向代理與 SSL 憑證管理
   Nixpacks	自動偵測程式語言並建置容器映像
   Buildpacks	Cloud Native Buildpacks，替代建置方案
   Railpack	針對 Rails 等框架最佳化的建置工具
   RClone	雲端儲存同步工具，用於備份功能

   整個安裝過程約需 3-5 分鐘，你可以在控制面板中即時查看安裝進度與日誌。

6. 驗證安裝結果

   安裝完成後，Piora 會自動驗證所有元件是否正確安裝並運行中。你會在控制面板看到每個元件的狀態指示：

   • Docker 服務運行中
   • Docker Swarm 已初始化
   • Traefik 反向代理已啟動
   • 建置工具已就緒

   全部顯示綠色勾號後，你的伺服器就準備好了。

7. 部署第一個應用程式

   伺服器設定完成後，你可以透過以下三種方式部署應用：

   Git 部署

   連接你的 GitHub / GitLab 倉庫，每次推送程式碼時自動觸發部署。

   # 在控制面板中連接 Git 倉庫後
   # 每次 git push 都會自動部署
   git push origin main

   Docker 部署

   直接使用現有的 Docker 映像進行部署。

   # 在控制面板中指定映像
   image: nginx:alpine
   ports:
     - "80:80"

   Compose 部署

   上傳 docker-compose.yml 部署多容器應用。

   version: "3.8"
   services:
     web:
       image: node:20-alpine
       ports:
         - "3000:3000"
     db:
       image: postgres:16
       environment:
         POSTGRES_PASSWORD: your-password

下一步

恭喜你完成了 Piora 的初始設定！接下來，你可以深入了解以下主題：

• 伺服器設定 — 進階伺服器配置與管理
• 應用部署 — 深入了解各種部署方式
• 域名與 SSL — 設定自訂域名與 HTTPS
• 資料庫 — 建立與管理資料庫服務
• 監控 — 監控伺服器與應用狀態
• 備份 — 設定自動備份策略

常見問題

安裝過程失敗怎麼辦？

請確認你的 VPS 符合最低需求（Ubuntu 18.04+ 或 Debian 10+），且 SSH 連線正常。你可以在控制面板檢視安裝日誌，找出具體的錯誤訊息。如果問題持續，請透過控制面板的支援功能聯繫我們。

可以在已有服務的 VPS 上安裝嗎？

建議使用全新的 VPS 進行安裝。如果 VPS 上已有其他服務，Piora 的自動安裝可能會與既有的 Docker 或 Traefik 設定衝突。

支援哪些程式語言？

透過 Nixpacks 和 Buildpacks，Piora 支援大多數主流程式語言和框架，包括但不限於：Node.js、Python、Ruby、Go、Rust、PHP、Java、.NET 等。