Cloudflare Browser Run 限流怎麼看?Free/Paid 與 Quick Actions
Cloudflare 在 2026 年 8 月 20 日提高 Browser Run 的 Workers Paid 預設限制,但 Browser Sessions 和 Quick Actions 仍是兩套不同的計量方式。前者是可持續互動的瀏覽器工作階段,後者是截圖、PDF、HTML 或 Markdown 擷取等單次請求;只看到「並行瀏覽器」數字,無法推算 Quick Actions 的請求速率。
這篇先把目前限制整理成可以對照的表,再處理撞到限流時該從 plan、endpoint 還是程式生命週期開始查。以下數字以 Cloudflare Browser Run limits 與 8 月 20 日 Changelog 為準;Paid 數字是預設值,不是所有帳號的硬上限。
先分清 Browser Sessions 與 Quick Actions
| 類型 | 適合的工作 | 主要限制維度 |
|---|---|---|
| Browser Sessions | Puppeteer、Playwright、CDP 或 Stagehand 的互動流程 | browser hours、同時存在的 browser 數、每秒新增 browser 數、單次 timeout |
| Quick Actions | screenshot、PDF、content、markdown、links 等單次操作 | 每秒請求數、單次 timeout;crawl 另有每日與頁數限制 |
例如用 Worker binding 呼叫 .quickAction(),排查時要看 Quick Actions requests per second;如果是持續開啟多個 session,才看 concurrent browsers 和 new browser instances per second。兩者都在 Browser Run 產品裡,不代表共用同一個配額。
目前 Free 與 Paid 的限制
| 功能 | Workers Free | Workers Paid 預設值 |
|---|---|---|
| Browser hours | 每日 10 分鐘 | 無固定時數上限,費用依 pricing 說明 |
| Concurrent browsers(Browser Sessions) | 每個帳號 3 個 | 每個帳號 200 個 |
| New browser instances(Browser Sessions) | 每 20 秒 1 個 | 每秒 3 個 |
| Quick Actions requests | 每 10 秒 1 次 | 每秒 30 次 |
| Browser timeout | 60 秒 | 60 秒 |
Workers Free 的 /crawl 還有每日 5 個 crawl job、每次最多 100 頁的限制。Workers Paid 的上表數字是預設值,Cloudflare 文件說明需要更高並行數時可以申請提高帳號限制;這不等於應該先把所有工作都開到最大。
本機 wrangler dev 為什麼會出現 RPC 錯誤
如果你的文章擷取流程是從 Worker binding 使用 Quick Actions,本機開發還有一個容易和限流混淆的條件:.quickAction() 目前不支援一般 local mode,必須使用 remote mode。設定可以像這樣:
{ "$schema": "./node_modules/wrangler/config-schema.json", "compatibility_date": "2026-03-24", "browser": { "binding": "BROWSER", "remote": true }}沒有 remote mode 時,收到 The RPC receiver does not implement the method "quickAction",這是本機執行模式的邊界,不是 Paid 方案的 rate limit。若要先確認 Worker 的 binding 和遠端資源,可以參考 Workers Local Explorer 的檢查方式;兩者分別處理 local inspection 與 Browser Run 請求。
撞到限制時的排查順序
- 先記錄呼叫的是 Browser Session 還是 Quick Action,以及實際 endpoint。
- 確認帳號目前是 Workers Free 或 Paid,不要只看本機
wrangler設定。 - 對 Browser Sessions 計算同時存活的 browser,檢查是否每個任務都重新建立 instance;能共用 browser 或 tabs 時,先評估重用。
- 對 Quick Actions 計算每秒請求,將批次工作排隊或加入退避,不要用開更多 session 來繞過另一套速率限制。
- 把 browser time、endpoint、回應時間和失敗時間留下來,再對照 dashboard 的 aggregate metrics。
Cloudflare 的建議也包含重用 sessions、tabs 或 shared browsers。這些是降低啟動成本與並行壓力的工作流調整,不會改變帳號本身的限制;需要更高容量時,再按產品限制頁的申請流程處理。
結論:先按產品類型對表,再調整並行策略
Browser Run 的限流排錯關鍵不是背一個「200」或「30」,而是先知道請求落在 Browser Sessions 還是 Quick Actions,再確認 plan、生命週期和 endpoint。8 月 20 日的 Paid 預設值確實提高了,但 request rate、browser concurrency、本機 remote mode 和計費仍是不同問題。
常見問題
Q: Browser Sessions 和 Quick Actions 共用並行數嗎?
A: 不應這樣計算。Browser Sessions 主要看 browser hours、concurrent browsers 和新增 browser 速率;Quick Actions 主要看每秒請求數。先按 endpoint 分類,再套用對應限制。
Q: Workers Paid 的 Browser Run 限制是永久固定的上限嗎?
A: Cloudflare 文件把 Paid 表格描述為預設值,並說明需要更高限制時可以申請提高帳號限制;另外 Browser hours 的費用仍要依 Browser Run pricing 了解,不能把「無固定時數上限」當成免費使用。
Q: 本機 .quickAction() 失敗一定是限流嗎?
A: 不一定。Cloudflare 文件指出 .quickAction() 在一般 local mode 尚未支援,本機 wrangler dev 要使用 --remote 或 browser binding 的 remote: true。先排除執行模式,再判斷 plan 與 request rate。
參考資料:
Cloudflare Changelog:Run more headless browsers concurrently with Browser Run
回報錯字、失效連結,或告訴我你想看的延伸主題。