SCDN 常用緩存文件後綴

參考常見資源擴展名設置緩存,並驗證個性化內容排除、資源更新和實際緩存效果。

本文目錄

後綴是識別資源的線索,不代表該類文件都能公開緩存。操作前先判斷內容是否公開、是否隨登錄用戶變化,以及多久更新一次。

常用靜態文件

.css,.js,.txt,.iso,.img,.exe,.zip,.rar,.7z,.gz,.tar,.apk,.ipa,.dmg,.manifest,.conf,.xml,.cab,.bin,.msi

圖片文件

.jpg,.jpeg,.gif,.ico,.png,.bmp,.webp,.psd,.tif,.tiff,.svg,.svgz

常用音視頻

.mp3,.flv,.swf,.wma,.wav,.mp4,.mov,.mpeg,.rm,.avi,.wmv,.mkv,.vob,.rmvb,.asf,.mpg,.ogg,.m3u8,.ts,.mid,.midi,.3gp

常用文檔與字體

.doc,.pdf,.csv,.ppt,.docx,.xlsx,.xls,.pptx,.ttf,.chm,.woff,.ps,.class,.jar,.woff2

這些是文件類型參考,不是建議全部啟用的緩存白名單。配置文件、導出報表、付費下載和私有文檔即使命中上述後綴,也可能包含私密信息或要求鑑權,不應被直接加入公共緩存。

網頁與動態內容

以下網頁文件可能返回動態內容,不宜統一設置公共緩存:

.html,.htm,.php,.json

公開且內容固定的 HTML 或 JSON,可以在明確更新策略後單獨評估;登錄狀態、用戶資料、訂單、購物車和業務 API 等個性化響應,應明確排除公共緩存。

把類型參考變成實際規則

SCDN 控制台 中檢查當前網站的緩存字段、匹配語法和規則優先級,再按以下項目配置。

需要覈對 操作要點
匹配語法 先讀當前字段提示,確認是否使用擴展名、路徑或正則,以及分隔符和前導點要求;不要將上方逗號列表盲目粘貼進其他語法字段
緩存範圍 只覆蓋確認可公開共享的資源;鑑權下載、用戶導出和動態接口單獨排除
緩存時間 按發佈頻率與可接受的舊內容時長設置,記錄資源更新後的刷新方式
URL 參數 判斷參數是否改變內容或權限;會改變內容的參數不能隨意忽略
源站響應頭 覈對 Cache-ControlVarySet-Cookie 和實際響應,確認 CDN 規則未覆蓋業務要求
規則優先級 檢查排除規則是否會被更寬泛的緩存規則覆蓋,保存後用真實請求確認

對於登錄和敏感接口,不要只依賴 URL 後綴,也不要假定攜帶 Cookie 或 Authorization 就會自動繞過緩存。源站可按業務使用 privateno-store 等策略,CDN 側也需確認生效。

音視頻清單、分片、鑑權鏈接和分段請求有各自的更新與權限要求,不宜僅憑 .m3u8.ts.mp4 後綴套用相同時間。先用播放器驗證完整播放、拖動和過期鏈接行為。

驗證緩存是否正確

  1. 準備三類樣本:一個公開靜態資源、一個登錄後頁面或接口、一個使用參數區分內容的資源。
  2. 重複發起真實請求:對照內容、狀態碼和響應頭;若平臺提供緩存記錄或命中標識,再結合它們與源站訪問日誌判斷。單次訪問更快不能單獨證明緩存命中。
  3. 檢查賬號隔離:用兩個測試賬號訪問同一路徑,確認各自數據正確,再退出登錄複測。不要使用真實客戶的敏感數據做測試。
  4. 驗證發佈更新:更新一個測試資源,執行當前控制台提供的刷新操作或使用新的資源版本地址,再從不同網絡檢查新內容。
  5. 記錄結果:保存測試時間、URL、規則和結果;如果刷新仍有舊內容,還應分別檢查瀏覽器緩存與其他代理層。

若發現個性化內容被緩存,立即停止相關緩存並進行適當刷新,覈查受影響範圍,再調整規則重新測試。不要只等待緩存自然過期。

接入和 API 例外見 SCDN 完整接入與排錯,日常配置見 CDN 網站管理。無法確認規則時,可攜帶脫敏後的 URL、響應頭和當前實際配置,通過 在線技術支持 覈對。

返回SCDN 文檔 返回幫助中心 聯繫技術支持