CDN：配置緩衝到期時間

注意事項

• 您成功添加網域名稱後，可以修改緩衝時間。設定的緩衝時間長短會導致回源流量不一樣，費用也有所不同，建議根據不同的業務需求設定緩衝時間長度。緩衝到期時間會影響回源頻率，建議根據實際業務需求設定資源緩衝時間長度。

  緩衝到期時間過短，會導致CDN頻繁回源，增加來源站點的流量消耗；緩衝到期時間過長，會帶來資料更新時間慢的問題。

• 緩衝在CDN節點上的資源，如果該資源的訪問熱度較低（同一個CDN節點上的同一個資源被用戶端訪問的頻次較低），那麼很可能會在緩衝到期之前被CDN節點上其他訪問熱度較高的資源覆蓋。

• CDN節點在收到來源站點響應的靜態檔案資源的時候，預設會按照阿里雲CDNDCDN預設緩衝規則及優先順序來執行。

• 建議您來源站點的內容不使用同名更新，而是採用版本號碼的方式同步。

  為了能準確找到更新前和更新後的來源站點內容，建議您來源站點的內容以版本號碼的方式同步，即更新來源站點內容時採用不同的名稱。例如，採用img-v1.0.jpg、img-v2.1.jpg的方式命名。

操作步驟

1. 登入CDN控制台。

2. 在左側導覽列，單擊域名管理。

3. 在域名管理頁面，找到目標網域名稱，單擊操作列的管理。

4. 在指定網域名稱的左側導覽列，單擊缓存配置。

5. 在缓存过期时间頁簽下，單擊添加。

   

   參數	說明
   类型	支援按目录或文件后缀名指定資源範圍。 目录：為某一路徑下所有資源設定相同緩衝規則。 文件后缀名：為某一檔案類型資源的設定相同緩衝規則。
   地址	指定待配置資源的目錄或檔案尾碼名。 類型選擇目錄時，填寫規則如下： 每次只能添加單條目錄，可以用正斜線（/）匹配所有目錄。 支援輸入目錄的完整路徑，須以正斜線（/）開頭，例如/directory/aaa。 類型選擇檔案尾碼名時，填寫規則如下： 支援輸入一個或多個檔案尾碼名，多個檔案尾碼名用半形逗號（,）分隔，例如jpg,txt。 大小寫敏感，注意區分大小寫。 不支援用星號（*）匹配所有的檔案類型。
   过期时间	資源在CDN節點的緩衝時間，最長可以設定3年。建議參考如下規則配置： 不常更新的靜態檔案（例如，圖片類型、應用下載類型等），建議設定1個月以上。 頻繁更新的靜態檔案（例如，JS、CSS等），根據實際業務情況設定。 動態檔案（例如，PHP、JSP、ASP等），建議設定為0s，即不緩衝。
   優選遵循來源站點緩衝策略	開啟後，如果來源站點響應了緩衝策略標題（包括 Cache-Control 和 Pragma ），那麼來源站點響應的緩衝策略將會優先生效。
   忽略來源站點不緩衝標題	開啟後，CDN節點將會忽略來源站點響應的以下幾個緩衝策略標題（這幾個標題均表示不緩衝）。 Cache-Control: no-store Cache-Control: no-cache Cache-Control: max-age=0 Pragma: no-cache
   用戶端跟隨CDN緩衝策略	開啟後，CDN節點會將最終生效的緩衝策略響應給用戶端。
   強制內容重新驗證	該參數只在緩衝到期時間為0時生效，使用效果如下： 關閉（預設）：CDN的緩衝到期時間配置為0時，CDN節點上不快取檔案，每次請求都需要回源擷取內容。 開啟：CDN的緩衝到期時間配置為0時，支援在CDN節點上快取檔案，每次請求都需要回源驗證緩衝內容。
   权重	權重即緩衝規則的優先順序。取值為1~99，數值越大優先順序越高，對應規則優先生效。 說明 有多條緩衝規則的情況下，建議每條緩衝規則都設定不同的權重，通過權重來控制規則執行優先順序。 權重相同的規則生效優先順序：先建立的＞後建立的，與規則類型無關。 如果配置了多條緩衝策略，其中一條緩衝策略生效後將不再繼續匹配其他的緩衝策略。
   規則條件	規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別，以此來決定某個配置是否對該請求生效。 不使用：不使用規則條件。 若需新增或編輯規則條件，請在規則引擎中進行管理。

6. 單擊確定，完成配置。

阿里雲CDN預設緩衝規則及優先順序

1. 來源站點響應pragma:no-cache、cache-control:no-cache（或者no-store，或者max-age=0）時，CDN遵循來源站點的策略，完全不緩衝資源。

2. CDN控制台設定的緩衝到期時間或者狀態代碼到期時間。

   說明

   若CDN請求同時命中多條規則，有且僅有一條規則會生效，優先順序為：權重>規則建立時間。

   • 有多條緩衝規則的情況下，建議每條緩衝規則都設定不同的權重（權重越大優先順序越高），通過權重來控制規則執行優先順序。

   • 權重相同的規則生效優先順序：先建立的＞後建立的，與規則類型無關。

3. 來源站點配置其他緩衝規則，優先順序由高至低為：cache-control>expires>last-modified>ETag。

   1. 如果來源站點響應中攜帶了cache-control，參數值包含max-age或s-maxage，並且max-age或s-maxage的值大於0，則使用cache-control設定緩衝到期時間，例如：cache-control:max-age=3600。如果同時存在max-age和s-maxage，則以s-maxage的值為準。

   2. 如果來源站點響應中沒有攜帶cache-control，但是攜帶了Expires，則使用Expires設定緩衝到期時間，例如：expires:Tue, 25 Nov 2031 17:25:43 GMT。

   3. 如果來源站點響應中沒有攜帶cache-control和Expires，但是攜帶了last-modified，則使用以下規則來計算緩衝時間：使用公式（目前時間-last-modified）* 0.1，計算結果在10秒~3600秒及之間的，取計算結果時間；小於10秒的，按照10秒處理；大於3600秒的，按照3600秒處理。

   4. 如果來源站點響應中沒有攜帶cache-control、Expires和last-modified，但是攜帶了ETag，緩衝10秒。

4. 如果來源站點返回的資料中，cache-control、expires、last-modified和ETag這些緩衝策略相關的回應標頭都沒有攜帶，則預設不緩衝。

緩衝響應資訊說明

• Date：

  • 表示來源站點響應該資源給CDN節點的時間。

  • 當CDN節點與來源站點重新驗證資源（通過在回源請求中攜帶If-Modified-Since標題或If-None-Match標題），並且來源站點返回304狀態代碼時，將會更新Date資訊。

  • 格式為GMT（格林尼治標準時間）時區的時間格式，例如：Sat, 19 Apr 2025 08:58:31 GMT。

• X-Cache:

  表示本次請求的資源是否命中在CDN節點上的緩衝，不同狀態的說明詳見下表。

  狀態	說明
  HIT	在CDN節點中命中了該資源的緩衝。
  MISS	在CDN節點中沒有命中該資源的緩衝，而是由來源站點伺服器提供的該資源。

• X-Swift-Cachetime:

  • 表示該資源在CDN節點上的緩衝到期時間，單位為秒。

  • X-Swift-Cachetime = Ali-Swift-Global-Savetime + CDN設定的緩衝到期時間 - X-Swift-SaveTime。

  • X-Swift-Cachetime並不完全等於CDN設定的緩衝到期時間，可能會出現以下3種情況：

    • X-Swift-Cachetime = CDN設定的緩衝到期時間，例如：3600秒。

    • X-Swift-Cachetime略小於CDN設定的緩衝到期時間，例如：CDN設定的緩衝到期時間為300秒，但是X-Swift-Cachetime為295秒，這種情況可能的原因有以下：

      • L1節點回源L2節點的延遲較大。

      • L1節點與L2節點上的時鐘不同步。

    • X-Swift-Cachetime的數值為負數，這種情況可能的原因是使用者對CDN設定的緩衝到期時間做了調整，用戶端訪問的時候，L1節點上的緩衝已經到期，L2節點上的緩衝尚未到期。例如：原先CDN設定的緩衝到期時間為3600秒，後來調整到了300秒，用戶端首次訪問之後過600秒再次訪問，這時候收到X-Swift-Cachetime:-300，對於這個情況，通過重新整理緩衝可以解決。

• X-Swift-SaveTime：

  • 表示該資源首次進入到用戶端直接存取的 CDN節點（ L1 層節點）的時間。

  • 格式為GMT（格林尼治標準時間）時區的時間格式，例如：Sat, 19 Apr 2025 08:58:31 GMT。

• Ali-Swift-Global-Savetime：

  • 表示該資源首次進入到CDN節點（由網站的緩衝架構決定，可能是L2節點，也可能其他的緩衝層級節點）的時間。

  • 格式為Unix時間戳記，例如：1745053111，表示 2025-04-19 16:58:31。

HTTP協議緩衝控制機制說明

配置樣本

相關API

BatchSetCdnDomainConfig

常見問題

• 緩衝相關常見問題

• CDNDCDN緩衝清理機制是什嗎？

• 提高CDN快取命中率

• 如何設定檔案不緩衝直接回源？