自訂網域與預覽網址
Cloudflare Pages 專案預設使用 專案名稱.pages.dev 網址,你可以再綁定自己的網域(例如 www.example.com),Cloudflare 會自動簽發 HTTPS 憑證。另外,每次部署與每個分支都有獨立的預覽網址;這些網址預設公開,可以用 Cloudflare Access 限制只有團隊成員能看。
如何綁定自訂網域?
- 進入 Pages 專案的 Custom domains → Set up a custom domain。
- 輸入網域,例如
www.example.com或根網域example.com。 - 依網域所在位置完成設定:
| 情況 | 做法 |
|---|---|
| 網域已在同一個 Cloudflare 帳號 | Cloudflare 自動新增 CNAME 紀錄,按確認即可 |
| 網域在其他 DNS 服務(只適用子網域) | 到該 DNS 服務新增 CNAME www → my-site.pages.dev |
要綁根網域 example.com |
網域必須使用 Cloudflare 名稱伺服器(見 加入網域) |
一定要從 Pages 介面綁定
只在 DNS 手動新增 CNAME 指向 my-site.pages.dev、卻沒在 Pages 的 Custom domains 加入網域,訪客會看到 522 錯誤。網域必須先在 Pages 專案中登記,Pages 才知道要回應這個網域。
同時使用根網域與 www
建議兩個都綁定,再用 Redirect Rules 把其中一個 301 導向另一個,避免搜尋引擎把同一內容當成兩個網站。
預覽網址是什麼?
| 網址 | 對應 |
|---|---|
my-site.pages.dev |
生產分支最新部署 |
<hash>.my-site.pages.dev |
某一次特定部署(永久保留,方便比對) |
<branch>.my-site.pages.dev |
某分支的最新部署,例如 staging.my-site.pages.dev |
在 GitHub 開 Pull Request 時,Cloudflare 會在 PR 留言附上預覽網址,審閱者不用在本機跑專案就能看到畫面。
如何讓預覽網址只有團隊看得到?
預覽網址預設任何人都能開,可能洩漏尚未公開的內容。
- 進入 Pages 專案 Settings → General → Access policy,按 Enable access policy。
- Cloudflare 會自動在 Zero Trust 建立一個 Access 應用程式,保護所有預覽網址(
*.my-site.pages.dev)。 - 到 Zero Trust 儀表板編輯該應用程式的 Policy,例如只允許
@example.com的 Email 登入。
正式網址不受影響。若連正式網站也要保護,請參考 Cloudflare Access 另外為自訂網域建立應用程式。