1115 字
6 分鐘

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 limits8 月 20 日 Changelog 為準;Paid 數字是預設值,不是所有帳號的硬上限。

先分清 Browser Sessions 與 Quick Actions#

類型適合的工作主要限制維度
Browser SessionsPuppeteer、Playwright、CDP 或 Stagehand 的互動流程browser hours、同時存在的 browser 數、每秒新增 browser 數、單次 timeout
Quick Actionsscreenshot、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 FreeWorkers 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 timeout60 秒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 請求。

撞到限制時的排查順序#

  1. 先記錄呼叫的是 Browser Session 還是 Quick Action,以及實際 endpoint。
  2. 確認帳號目前是 Workers Free 或 Paid,不要只看本機 wrangler 設定。
  3. 對 Browser Sessions 計算同時存活的 browser,檢查是否每個任務都重新建立 instance;能共用 browser 或 tabs 時,先評估重用。
  4. 對 Quick Actions 計算每秒請求,將批次工作排隊或加入退避,不要用開更多 session 來繞過另一套速率限制。
  5. 把 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

Cloudflare Docs:Browser Run limits

Cloudflare Docs:Quick Actions

Cloudflare Browser Run 限流怎麼看?Free/Paid 與 Quick Actions
https://laplusda.com/posts/cloudflare-browser-run-limits/
作者
Zero
發佈於
2026-08-23
許可協議
CC BY-NC-SA 4.0
這篇文章有幫助嗎?

回報錯字、失效連結,或告訴我你想看的延伸主題。