Cloudflare 在 2026 年 11 月 12 日更新 Tunnel 的 URL 正規化時程與範圍。從 cloudflared 2026.11.0 起,正規化除了處理點路徑、反斜線與重複斜線,也會在 ingress 規則比對前移除分號分隔的 path parameters。新版本目前仍預設關閉;Cloudflare 預計從 2027 年 2 月 8 日起,讓之後發布的 cloudflared 預設開啟,取代先前公告的 2027 年 1 月 25 日。

這不是把送到 origin 的網址直接改寫。官方文件明確區分:正規化後的路徑用來選擇哪一條 ingress rule,原始完整路徑仍會轉送到後端。真正需要處理的是「同一個請求會不會改走另一個 service」,特別是以 path regex 分流、並要求 Cloudflare Access 驗證的 Tunnel。沒有這類規則的設定不在公告所述影響範圍內,但仍應先用設定檔與實際版本確認,不能只因網域看起來正常就略過盤點。

為什麼分號路徑會改變路由判斷

有些框架、舊式應用或代理會接受 /admin;mode=preview/report 這類 matrix parameters。當 ingress 規則直接比對原始路徑時,帶參數的變體可能沒有命中預期的受保護規則,而落到後面的較寬鬆規則。2026.11.0 在比對前處理這類分號片段,目的是讓路由判斷使用較一致的路徑表示,降低不同表示法繞過 Access 驗證的風險。

但安全修正也可能揭露既有設定對特殊字元的依賴。例如,團隊刻意用分號把流量導向不同服務,或 regex 把分號後的內容視為路由的一部分,啟用後可能改命中另一條規則。由於 origin 收到的仍是原始 URL,後端應用的路由、快取鍵、稽核紀錄與 WAF 判斷也可能與 Tunnel 的 ingress 選擇使用不同表示。驗證不能只看 HTTP 200,而要確認「由哪個 ingress 接收、Access 是否執行、後端看見什麼路徑」。

先找出真正受影響的 Tunnel

第一步盤點所有 locally-managed Tunnel 與每台 cloudflared 的版本、啟動方式及更新來源。容器、systemd、Kubernetes DaemonSet 與自架更新腳本可能各自固定不同版本;只在 Dashboard 看 connector online,無法證明每個 replica 都跑同一版本。把每個 Tunnel 的設定檔、映像 digest、owner、環境與回退方式放進同一份清冊。

第二步搜尋 ingress 中的 path 規則與 catch-all,標示哪些規則要求 Access JWT validation、哪些導向管理介面或內部 API、哪些 regex 可能接受分號、反斜線、重複斜線或點路徑。規則順序同樣重要:正規化後若不再命中前面的窄規則,就可能落到後面的 service;反之,也可能從公開路由改命中需要登入的路由。

第三步查看真實流量與應用路由。不要把「近一週沒看到分號」當成永遠不存在;API client、掃描器、合作方整合與舊書籤都可能低頻使用特殊路徑。對高風險管理端點,應額外確認 origin 本身也有授權,不能把 Tunnel path rule 當成唯一安全邊界。

建立可回歸的路徑測試矩陣

至少為每條關鍵規則準備正常路徑、分號參數、.. 點路徑、重複斜線、反斜線、URL 編碼變體與完全不匹配的請求。每個案例記錄預期 ingress service、預期 Access 結果、origin 收到的 request path 與 status。測試資料應使用受控帳號與非敏感環境,不要在正式管理端點用破壞性 HTTP method 探測。

先升級到 cloudflared 2026.11.0 或更新版本,但保留目前預設關閉狀態,確認一般流量沒有因版本更新本身異常。接著在 staging 以啟動參數 --disable-path-normalization=false,或環境變數 TUNNEL_DISABLE_PATH_NORMALIZATION=false 明確開啟。若是多 replica,必須同時記錄每個 instance 的設定,避免部分節點已開、部分未開而造成間歇性路由結果。

驗收時除了應用回應,也要看 Tunnel log、Access audit log 與 origin access log,使用 request ID 串起同一筆流量。特別檢查未登入請求是否確實停在 Access、已登入請求是否落到正確服務、原始路徑是否照官方說明送達 origin,以及 cache 或 redirect 是否把第一次結果遮蔽。

分階段啟用與回退

正式環境可先挑低流量、規則單純的 Tunnel,明確開啟正規化並觀察錯誤率、登入失敗、404、redirect loop 與各 service 的流量分布。再逐批處理管理介面、API 與多服務 Tunnel。不要等到 2027 年 2 月才隨自動更新一起接受新預設;那會把 binary 更新、設定行為與路由變更混在同一個變更窗口。

若發現相容性問題,可暫時把正規化明確關閉並回到已驗證設定,但這只能爭取修規則與應用的時間。長期解法是調整 ingress regex、移除依賴模糊路徑的分流,並讓 origin 對敏感路由自行驗證身分與權限。回退前後都要重跑同一套矩陣,確認不是因快取、不同 replica 或 DNS 路由造成假象。

這次公告提供近三個月的測試窗口,也補上分號路徑這個容易漏掉的案例。最穩健的做法不是只排一張「升級 cloudflared」工單,而是把版本、正規化開關、規則順序、Access 驗證與 origin 路由一起驗收。如此即使未來預設值再調整,團隊仍能用既有測試判斷影響,而不是等使用者遇到錯誤才從特殊 URL 猜原因。