自訂域名
「自訂域名」是 4 step 自助 wizard，讓您把官網接到自己的網域（如 yourbrand.com 或 www.yourbrand.com），無需碰 DNS / SSL 設定。
進入路徑：左側 網站經營 → 自訂域名；也可以從 網站設定 頁右側的「升級自訂域 →」（已綁定時顯示「管理自訂域」）按鈕進去，或直接造訪 /dashboard/site/custom-domain。
誰能操作：租戶管理員
目前狀態卡
進入頁面最上方「目前狀態」Card 顯示：
- 您目前對外網址（自訂域或預設子網域）
- Badge：「自訂域」綠色 / 「預設子網域」灰色
- 若已綁定：右下「解除自訂域」按鈕（解除後切回預設子網域）
4 Step Wizard
Step 1：選擇接法 + 填入網域
兩種接法（依您需求二選一）：
子網域接（推薦）
例：www.yourbrand.com 或 shop.yourbrand.com
- DNS 只加一筆 CNAME 紀錄
- 5-30 分鐘生效
- 不影響您主域其他用途（例：
yourbrand.com還能跑舊網站、blog.yourbrand.com還能跑別的） - 適合：第一次接、要與舊網站並存、想保留彈性
主域全接（進階）
例：yourbrand.com（無 www）
- 需把整個域的 Nameserver 切到我們的 Cloudflare
- propagation 最長 24-48 小時
- 切過去後整個域 DNS 由我們管（信箱 / 子網域 / TXT 等都要同步搬過來）
- 適合：想用根網域對外（不要 www）、現有 DNS 設定少 / 沒在用
Step 2：到您的 DNS 商加入紀錄
系統會顯示一張表，列出您需要去 DNS 商加入的紀錄：
| 欄位 | 範例 | 說明 |
|---|---|---|
| 類型 | CNAME | DNS 紀錄類型 |
| 名稱 | www 或 @ | 子網域名稱 |
| 值 | xxx.zeabur.app | 對應目標（我們系統的邊緣節點） |
每列右側 「複製」 按鈕一鍵複製值到剪貼簿，下方 details 區塊有逐筆說明該紀錄的用途。
頁面底部附 3 個常見 DNS 商設定教學連結：
- GoDaddy 加 CNAME
- Cloudflare 加紀錄（注意灰雲）
- 中華電信 DNS 管理
Cloudflare 使用者特別注意：Proxy 狀態必須設為「DNS only / 灰雲」，不能用「Proxied / 橘雲」。橘雲會造成 SSL 雙層衝突（您 Cloudflare 一層 + 我們 Let's Encrypt 一層），SSL 永遠簽不下來。
設好後按 「我已設好 → 開始驗證」。
Step 3：自動驗證中
系統每 30 秒 透過 DNS over HTTPS（Google DoH）查詢您的網域解析結果，比對是否指向我們系統。
- 顯示「正在檢查 yourbrand.com 的 DNS 解析⋯」+ 旋轉 spinner
- 顯示「已嘗試 N / 40 次」進度
- 最多嘗試 40 次（= 20 分鐘上限）
- 隨時可按「返回 DNS 設定」回 Step 2 重檢查
CNAME 通常 5-30 分鐘生效；Nameserver（主域接）24-48 小時。如果 20 分鐘超時，請回 Step 2 重檢查紀錄是否拼錯，再來一次。
Step 4：完成（驗證通過）
驗證通過後：
- 系統自動跑 Zeabur
addDomain註冊您的網域 - Let's Encrypt 自動簽發 SSL 憑證（1-5 分鐘）
- 顯示綠色「您的官網現已透過 yourbrand.com 對外服務，SSL 憑證已就緒」
- 您新網址
https://yourbrand.com即可訪問
頁面底部建議後續操作：
- 到 GSC 重新提交 sitemap：
https://yourbrand.com/sitemap.xml - 更新您的社群連結與名片到新網址
- 若舊網址有 SEO 流量，建議設定 301 轉址
Step 4（失敗）：驗證未通過
若 20 分鐘內未通過，會顯示失敗原因 + 4 個常見原因排查清單：
- DNS 紀錄拼錯或還沒生效（請等 5-30 分鐘再試）
- CNAME 指向錯誤目標（請對照 Step 2 顯示的值）
- Cloudflare Proxy 開了橘雲（請改為灰雲 DNS only）
- SSL 憑證簽發中（Let's Encrypt 1-5 分鐘）
兩個按鈕：「返回 Step 2 檢查 DNS」/「立即重新驗證」。
平台保留字（不能使用）
以下子網域屬平台保留字，自訂域填這些會被擋下（共 38 個）：
admin / crm / lineai / bnifl / money / amego-proxy / api / www / mail / ftp / blog / help / support / docs / status / dashboard / app / demo / test / staging / dev / prod / notify / webhook / payment / billing / oauth / auth / sso / login / cdn / static / img / media / assets / ugomkcrm / official / share
您自己的網域如admin.yourbrand.com是 OK 的（黑名單只擋{保留字}.ugomk.com，不擋您自己網域的子域）。
解除自訂域
「目前狀態」Card 內若已綁定，會出現「解除自訂域」按鈕：
- 確認對話框
- 系統 DELETE
/api/site/custom-domain/{domain} - Zeabur removeDomain
- site_settings.custom_domain 設 null
- 對外網址切回預設子網域
解除後您手上的 DNS 紀錄需自行刪除，並建議您把流量重新導回別的網站，避免訪客看到「網站不存在」。
SLA 與費用
| 項目 | SLA / 費用 |
|---|---|
| 子網域接驗證時間 | 5-30 分鐘 |
| 主域接驗證時間 | 24-48 小時 |
| SSL 憑證有效期 | 90 天（自動 renewal） |
| 第 1 個自訂域 | 包在品牌版 / 內容版方案費 |
| 第 2 個以上自訂域 | 加購 $200 / 月 / 域 |
常見問題
Q1 我想要 root 接但又怕 Nameserver 切過去搞砸信箱怎辦？
建議走 子網域接（www 起頭） 較安全。對外網址用 www.yourbrand.com，root yourbrand.com 在自己 DNS 商加一個 301 redirect 到 www.yourbrand.com 即可達到相同效果，且不動原 Nameserver。
Q2 DNS 我不會改怎辦？
請聯繫客服 LINE @ugomk 協助。提供您的 DNS 商帳號（建議您建一個「協作管理員」帳號給我們，不要直接給主帳號密碼）我們可代操。
Q3 主域接需要 Cloudflare 帳號嗎？
不用。系統的 Cloudflare 帳號由我們管理。您只需到原 DNS 商把 Nameserver 改成我們提供的 2 個 NS（Step 2 會顯示）即可。
Q4 原來自己的網站還能保留嗎？
- 子網域接：原網站維持不動，只把一個子網域指到我們
- 主域接：原網站會被取代。如果還要保留，請改用子網域接，或先做好遷移計畫
Q5 SSL 多久 renew？
Let's Encrypt 90 天有效期，系統自動 renew（每 60 天）。您不需做任何事。
Q6 可以同時綁多個自訂域指到同一個官網嗎？
可以（一個官網綁多個 alias 域名）。第 2 個以上加購 $200 / 月。請聯繫客服開通。
Q7 驗證一直失敗，但我 DNS 改了
排查順序：
- 在自己電腦終端機跑
nslookup yourbrand.com看實際解析 - 確認 CNAME 值跟 Step 2 顯示的一致（注意尾巴有沒有
.） - Cloudflare 用戶確認灰雲 DNS only
- 等 30 分鐘再試（DNS TTL cache）
- 仍失敗 → 聯繫客服
解除後 SEO 衝擊
備註