Cloudflare Pages Free Plan 完整限制說明 · 2026-04-07
| 項目 | 限制 | 說明 |
|---|---|---|
| 專案數量 | 100 個（軟限制） | 可申請提高上限 |
| 每個專案檔案數 | 20,000 個 | 單一 deployment 的檔案上限 |
| 每月構建次數 | 500 次 | 所有專案合計 |
| 並發構建 | 1 個 | 同一時刻只能構建 1 個 |
| 單檔大小 | 25 MB | 每個檔案不得超過 |
| 帶寬 | 無限 | 無出口流量費用 |
| 自訂域名 | 100 個/專案 | 可綁定自己的網域 |
| 環境變數 | 約 10–20 個 | 依方案略有不同 |
| 構建時間 | 每次最長 15 分鐘 | 超時會自動終止 |
「構建次數」指的是 Cloudflare 自動幫你打包編譯網站的次數，不包含我們用 wrangler 直接上傳的部署方式。
使用 wrangler 直接上傳（我們的做法）：
每次執行 npx wrangler pages deploy . → 屬於 Direct Upload（直接上傳），不消耗構建次數。
因為打包編譯的工作在我們電腦上完成，Cloudflare 只負責接收檔案和發佈。
使用 Git 連接自動構建：
如果把 GitHub/GitLab 連接到 Cloudflare Pages，每次 push 或合併 PR 時，Cloudflare 會自動拉取程式碼 → 安裝依賴 → 執行建置指令 → 產生檔案 → 發佈。
這個「自動建置 + 發佈」的過程算 1 次構建，免費方案每月限 500 次。
問題現象：累積約 500 個檔案後，新部署回報成功但實際不生效。
可能原因：根據官方限制（每 deployment 20,000 檔），500 檔遠未觸及硬限制。推測可能是以下原因之一：
建議做法：無論官方限制如何，定期清理舊 deployment 是好習慣。每次部署後保留最近 2-3 個版本即可。
執行方式：使用 Delet-olddata Skill 自動清理。
相關 Skill：
→ Delet-olddata — 清理舊 deployment
→ upload-html — 日常部署
資料來源：Cloudflare 官方文檔 · 2026-04-07 確認