在現代網站架構中,Cloudflare Ignore query string 是提升 CDN 快取命中率(Cache Hit Ratio)的關鍵技術。預設情況下,Cloudflare 會將包含不同查詢字串(Query String)的請求視為獨立資源,這往往導致快取碎片化。若您的專案頻繁使用 UTM 參數或無意義的追蹤參數,透過正確設定 Cache Key 規則,能讓相同資源共用快取物件,減少回源請求。
快速跳轉與重點錨點
一、 核心速查與常見瓶頸對照
1. 常見錯誤寫法的工程瓶頸
處理動態參數時,若不分路徑一律忽略 Query String,會導致以下工程瓶頸:
- 快取汙染:若忽略了所有參數,可能導致需要參數區分內容的頁面(如分頁
?page=2)回傳錯誤的快取內容。 - 參數覆蓋:在未精細設定 Cache Key 的情況下,忽略參數可能導致 API 請求回傳過時資料。
- 版本參數失效:靜態檔常用
?v=1這類參數強制更新;忽略 Query String 後,新舊版本會共用同一個快取物件,更新檔案時需要另外清除快取。
2. 核心機制規格對照表
| 功能維度 | 預設行為 | Ignore query string | 適用場景 |
|---|---|---|---|
| Cache Key | 包含完整 URL(含 Query String) | 其餘預設元素不變,只省略 Query String | 靜態資源、不依賴參數的頁面 |
| 快取物件數量 | 每種參數組合各一份 | 同一路徑合併為一份 | 廣告追蹤、無效參數 |
| 方案 | 所有方案 | 所有方案可用 | 自訂保留或排除特定參數(Query string 自訂選項)僅 Enterprise 方案 |
二、 關鍵機制解析:底層規範與注意事項
Cloudflare 的快取機制核心在於 Cache Key。當請求到達邊緣節點時,Cloudflare 會根據 Cache Key 決定是否命中快取。
1. Cache Key 的運作順序
Cloudflare 預設的 Cache Key 包含完整 URL(協定、主機名稱與帶有 Query String 的 URI),以及 Origin 等部分請求標頭。設定「Ignore query string」後,Cache Key 仍包含預設的其他元素,只省略 URI 的 Query String。這意味著 example.com/style.css?v=1 與 example.com/style.css?v=2 會共用同一個快取物件,這也是官方文件的範例情境(file.jpg?something=123 與 file.jpg?something=789 共用 Cache Key)。
2. 安全性與瀏覽器端注意事項
- 安全性考量:Ignore query string 只改變 Cache Key 的組成,不處理請求內容。SQL Injection 是源站應用程式層的漏洞,應在源站做好輸入驗證與參數化查詢。
- 瀏覽器端行為:Cache Key 是 Cloudflare 邊緣節點判斷是否命中快取的依據,瀏覽器本機快取仍由源站回傳的
Cache-Control等標頭決定。可搭配 瀏覽器快取設定 一併規劃。
三、 實作範本:生產環境完整程式碼
Cloudflare 官方的 Cache Everything 忽略 Query String 範例使用 Cache Rules 設定,以下範本依該範例調整。
範本一:針對特定路徑忽略所有 Query String
適用於靜態資源或不依賴參數的頁面。
- 進入 Caching > Cache Rules,建立新規則。
- 條件設定為(路徑與主機名稱為示意值,請換成自己的):
Hostnameequalsexample.comPathcontains/static/
- 在 Cache eligibility 選擇 Eligible for cache(官方範例的設定)。
- 在 Cache key 設定區塊的 Query string 選擇 Ignore query string。
- 部署規則。
範本二:保留或排除特定參數
若只想保留 page、id 等特定參數,需要使用 Custom cache key 的 Query string 選項。官方文件列出的選項有:
- All query string parameters:所有參數都納入 Cache Key。
- All query string parameters except:除了列出的參數,其餘都納入。
- No query parameters except:只有列出的參數納入。
- Ignore query string:全部忽略(所有方案可用)。
前三項屬於 Query string 的自訂選項,官方的方案對照表只標示 Enterprise 方案可用;其他方案只能使用 Ignore query string 或預設行為。需要保留 page、id 時,選擇 No query parameters except 並填入這兩個參數名稱,其餘參數(例如 utm_ 系列)就不會納入 Cache Key。
四、 常見問題與排錯(Q&A)
Q1:啟用 Cloudflare Ignore query string 後,如何確保動態參數(如 UTM)不會導致快取命中率下降?
問題原因:UTM 參數是隨機的,若不忽略,每個 UTM 組合都會產生新的快取項目。
解法:針對不依賴參數的路徑,用 Cache Rules 設定「Ignore query string」,UTM 參數就不會再影響 Cache Key。若同一路徑還需要保留其他功能性參數,需使用 Enterprise 方案的自訂 Query string 選項。
Q2:在 Cloudflare 中使用 Ignore query string 是否會增加 SQL Injection 的攻擊風險?
問題原因:誤以為 CDN 忽略參數會掩蓋注入攻擊。
解法:Ignore query string 只改變 Cache Key 的組成,不會過濾請求內容。請務必在源站應用程式層實作嚴格的輸入驗證與參數化查詢。
Q3:如何透過 Cloudflare Cache Key 排除特定的 query string 參數而非全部忽略?
問題原因:需要保留部分功能性參數(如搜尋關鍵字)。
解法:在 Cache Rules 的 Cache key 設定中使用 Query string 自訂選項:「No query parameters except」只納入列出的參數,「All query string parameters except」則排除列出的參數。這些自訂選項在官方方案對照表中僅 Enterprise 方案可用。
Q4:當 Cloudflare Cache Key 忽略 query string 時,瀏覽器端的資源請求行為有何變化?
問題原因:擔心 CDN 行為影響瀏覽器快取。
解法:CDN 的 Cache Key 設定不影響瀏覽器行為。瀏覽器依然會根據您伺服器回傳的 Cache-Control 與 ETag 標頭來決定是否使用本地快取。
Q5:Cloudflare Page Rules 與 Cache Rules 在處理 query string 忽略邏輯上的優先級差異為何?
問題原因:新舊功能並存導致設定衝突。
解法:依 Cloudflare 官方的 Page Rules 遷移文件,新版 Rules 功能的優先權高於 Page Rules;兩者對同一路徑都定義快取設定時,Cache Rules 會覆蓋 Page Rules。建議把快取相關設定集中到 Cache Rules 管理。
Q6:針對 API 端點,設定 Ignore query string 是否會導致錯誤的資料回傳?
問題原因:API 請求通常高度依賴參數(如 ?id=123)。
解法:絕對不要針對 API 端點全域忽略參數。若 API 必須快取,請確保 Cache Key 包含所有必要的識別參數,否則將導致所有使用者看到同一筆資料。
發佈留言