Cloudflare Workers Preview URL 怎麼關？用 workers_dev 與 preview_urls 避免誤公開

workers_dev 和 preview_urls 管的是兩個入口#

workers_dev 控制 Worker 是否使用 workers.dev 路由；Preview URL 則是版本或別名對應的預覽入口。兩者常常一起出現，但不能只看其中一個欄位就判斷外部能否存取。

Cloudflare 文件也特別提醒，Preview URL 啟用後預設是公開的；它不是只在本機或私有網路中可見的測試網址。

用設定檔消除版本差異#

JSON 設定可以寫成：

1
{
2
  "name": "example-worker",
3
  "main": "src/index.ts",
4
  "workers_dev": false,
5
  "preview_urls": false
6
}

如果使用 TOML，對應寫法是：

1
name = "example-worker"
2
main = "src/index.ts"
3
workers_dev = false
4
preview_urls = false

這裡的重點不是一定要關閉 Preview URL，而是把意圖寫進版本控制。若團隊需要 preview，將值改成 true，並在同一份設定與部署檢查中處理 Access、測試資料和 callback URL。

先查看執行部署的 Wrangler 版本與設定檔：

1
wrangler --version
2
rg -n 'workers_dev|preview_urls|routes|domains' wrangler.jsonc wrangler.json wrangler.toml 2>/dev/null

Cloudflare 的版本行為曾經分成三段：4.34.0 以前預設開啟；4.34.0 到 4.44.0 以前預設關閉；4.44.0 之後，未明確設定時才改為跟著 workers.dev。因此，明確寫出 preview_urls 比依賴「這台 CI 剛好安裝哪個 Wrangler」更容易維護。

需要預覽時，先處理公開範圍#

版本預覽與 alias 預覽都可能對應到 workers.dev 子網域。即使 URL 只會放在 Pull Request 留言，也不代表它天然需要登入。若 preview 會讀取真實資料、呼叫 production API，或包含尚未公開的功能，先做三件事：

1. 把預覽使用的 binding、資料庫和 API endpoint 指向測試資源。
2. 在 Worker 設定中明確確認 preview_urls = true 的理由與負責人。
3. 到 Workers > Settings > Domains & Routes，為 Preview URLs 啟用 Cloudflare Access，並檢查 policy 的 email、群組或其他條件。

若你的需求其實是讓私有網站登入，而不是讓每個版本都公開，可以先參考 Cloudflare Access 私有 HTTP 網站的瀏覽器登入檢查，不要用「藏住 URL」代替身份驗證。

部署後怎麼驗證真的關閉#

先把設定檔、部署命令與使用的 Wrangler 版本記錄在同一個變更中。若目前已有版本預覽，從 Dashboard 的 Deployments 找到 versioned URL 和 aliased URL，各自測試；不要只測自訂網域。

可以保留一個不含敏感資料的 smoke test：

1
curl -I https://<preview-url>

這個命令只回答 HTTP 入口目前的回應，不能證明 binding、Access policy 或資料來源都正確。若要重新產生版本預覽，wrangler versions upload 會建立版本並回傳預覽 URL；執行前先確認你是在測試帳號、測試 binding 和正確的 Wrangler environment。

另外，Durable Objects Worker 目前不會產生 Preview URL。這是平台限制，不是把 preview_urls 設成 false 後的替代行為；遇到沒有 URL 的情況，先查 Worker 類型與部署輸出，再判斷是否為設定問題。

最後的判斷順序#

Cloudflare Workers Preview URL 的安全邊界可以縮成四個問題：目前用哪個 Wrangler？preview_urls 有沒有明確設定？版本與 alias URL 是否都測過？預覽是否需要 Cloudflare Access？把這四項寫進部署檢查，才不會因為 workers_dev 的狀態或 CLI 升級而誤判公開範圍。

常見問題#