跳到內容
Piora

自訂域名

透過自訂域名，你的應用可以使用專業的網址（如 app.yourcompany.com）而非自動分配的測試域名。

設定步驟

Section titled “設定步驟”

1. 取得域名

Section titled “1. 取得域名”

如果你還沒有域名，可以從以下供應商購買：

  • Namecheap
  • Cloudflare Registrar
  • Google Domains
  • GoDaddy
  • Gandi

2. 設定 DNS 記錄

Section titled “2. 設定 DNS 記錄”

在你的 DNS 供應商控制面板中，新增指向 VPS IP 的記錄：

根域名（example.com）

Section titled “根域名（example.com）”
類型: A
名稱: @
值:   123.456.789.0  （你的 VPS IP）
TTL:  3600

子域名（app.example.com）

Section titled “子域名（app.example.com）”
類型: A
名稱: app
值:   123.456.789.0  （你的 VPS IP）
TTL:  3600

WWW 域名

Section titled “WWW 域名”
類型: CNAME
名稱: www
值:   example.com
TTL:  3600

3. 在 Piora 中設定域名

Section titled “3. 在 Piora 中設定域名”
  1. 進入應用設定頁面
  2. 點選「域名」區塊
  3. 輸入你的域名（例如 app.example.com）
  4. 點選「新增」

Piora 會自動：

  • 在 Traefik 中建立路由規則
  • 申請 Let’s Encrypt SSL 憑證
  • 設定 HTTP → HTTPS 轉導

多域名支援

Section titled “多域名支援”

每個應用可以設定多個域名，例如：

  • example.com（根域名）
  • www.example.com（www 子域名）
  • app.example.com（應用子域名）

所有域名都會指向同一個應用，並各自擁有 SSL 憑證。

使用 Cloudflare

Section titled “使用 Cloudflare”

如果你使用 Cloudflare 管理 DNS：

建議設定

Section titled “建議設定”
  1. 將 Cloudflare 的 Proxy 狀態設為「DNS Only」（灰色雲朵）
  2. 讓 Piora 的 Traefik 直接處理 SSL

Cloudflare + Piora 的 SSL 模式

Section titled “Cloudflare + Piora 的 SSL 模式”
Cloudflare SSL 模式說明建議
Off不使用 SSL不建議
FlexibleCloudflare → 伺服器使用 HTTP不建議
Full允許自簽憑證可用
Full (Strict)需要有效憑證推薦

萬用字元域名

Section titled “萬用字元域名”

如果你需要為多個子域名路由到不同應用：

類型: A
名稱: *
值:   123.456.789.0

然後在每個應用中分別設定對應的子域名。

疑難排解

Section titled “疑難排解”

域名無法存取

Section titled “域名無法存取”
  1. 確認 DNS 記錄已生效：dig app.example.com 或使用線上 DNS 檢查工具
  2. 確認 VPS 的 80 和 443 連接埠已開放
  3. 確認 Traefik 正常運行

SSL 憑證申請失敗

Section titled “SSL 憑證申請失敗”
  1. DNS 必須正確指向你的 VPS IP
  2. 80 埠必須開放（Let’s Encrypt HTTP-01 驗證需要）
  3. 確認域名未被其他服務的 SSL 設定佔用
Terminal window
# 檢查 DNS 解析
dig +short app.example.com
# 應回傳你的 VPS IP


# 測試連接埠
curl -I http://app.example.com