Cloudflare Pages

定義

Cloudflare 提供的靜態網站與全端框架部署平台，支援從 GitHub/GitLab 自動部署，內建 CDN 與預覽環境。

關鍵數據點（附來源）

• 預設 Node.js 版本為 18，Astro 5 需要 Node 22 以上，需透過 .node-version 檔案指定。（cloudflare-pages-preview-access）
• 部署失敗時錯誤訊息可能不明確（如「an internal error occurred」）。（cloudflare-pages-preview-access）
• Wrangler CLI 可在終端機查看部署狀態，多帳號時需指定 Account ID。（cloudflare-pages-preview-access）
• Production 分支與預覽分支的綁定需在設定頁面明確指定。（cloudflare-pages-preview-access）

前提與局限性

• 錯誤日誌有時不夠詳細，增加除錯難度。
• 預覽網址預設公開，需搭配 [[Zero Trust Access]] 保護。
• 與 [[Vercel]] 相比，Cloudflare Pages 的協作模式不依賴 commit author 辨識。

衝突標記

（無）

關聯概念

• [[分支部署策略]]
• [[預覽環境存取控制]]
• [[Zero Trust Access]]
• [[Node.js 版本管理]]
• [[Vercel]]