全部產品
Search
文件中心

Edge Security Acceleration:配置狀態代碼到期時間

更新時間:Nov 21, 2025

DCDN節點從來源站點擷取資源時,來源站點會返迴響應狀態代碼,您可以在阿里雲DCDN上配置狀態代碼緩衝時間,當用戶端再次請求相同資源時,由DCDN直接響應狀態代碼,不會觸發回源,減輕來源站點壓力。當狀態代碼超過設定的緩衝時間,會重新觸發回源。

適用情境

配置狀態代碼到期時間主要適用於來源站點響應了異常狀態代碼的情況下,用於指定DCDN節點上執行的緩衝處理動作。

正常情況下DCDN節點成功從來源站點擷取到所請求的資源,即來源站點響應了2xx狀態代碼時,會按照阿里雲CDNDCDN預設緩衝規則及優先順序進行處理。如果來源站點無法迅速響應所有狀態代碼(例如非2xx狀態代碼),且不希望所有請求全部由來源站點響應,可以配置狀態代碼到期時間,由DCDN節點直接響應狀態代碼,減輕來源站點壓力。

典型情境

檔案A在來源站點已被刪除,但用戶端仍持續訪問,DCDN節點沒有快取檔案A,所有請求轉寄回源,由來源站點響應4xx狀態代碼,加劇來源站點壓力。如果配置了緩衝4xx狀態代碼,DCDN節點首次回源後,會緩衝4xx狀態代碼,預設緩衝時間內,當用戶端再次請求檔案A時,由DCDN直接響應4xx狀態代碼,無需回源。

異常狀態代碼緩衝規則

  • 對於204、305、404、405、414、424、429、500、501、502、503和504狀態代碼,緩衝規則如下:

    1. 如果來源站點返回set-cookie回應標頭,DCDN不緩衝。

    2. 如果來源站點沒有返回Set-Cookie回應標頭,則遵循DCDN控制台配置的狀態代碼到期時間來緩衝,配置多條規則時生效方式請參考多條規則生效優先順序說明。

    3. 如果來源站點沒有返回Set-Cookie回應標頭,DCDN控制台也沒有配置狀態代碼到期時間,則按照來源站點設定的Pragma、Cache-Control或者Expires回應標頭來緩衝。

    4. 如果來源站點沒有返回Set-Cookie、Pragma、Cache-Control或者Expires回應標頭,DCDN控制台也沒有配置狀態代碼到期時間,則預設緩衝1秒。

  • 對於302、307和403狀態代碼,緩衝規則如下:

    1. 如果來源站點返回set-cookie回應標頭,DCDN不緩衝。

    2. 如果來源站點沒有返回Set-Cookie回應標頭,則遵循DCDN控制台配置的狀態代碼到期時間來緩衝,配置多條規則時生效方式請參考多條規則生效優先順序說明。

    3. 如果來源站點沒有返回Set-Cookie回應標頭,DCDN控制台也沒有配置狀態代碼到期時間,則按照來源站點設定的Pragma、Cache-Control或者Expires回應標頭來緩衝。

    4. 如果來源站點沒有返回Set-Cookie、Pragma、Cache-Control或者Expires回應標頭,DCDN控制台也沒有配置狀態代碼到期時間,不緩衝。

  • 針對304狀態代碼,DCDN將不進行緩衝,且無法通過任何方式設定緩衝時間。

  • 對於其他異常狀態代碼,如400狀態代碼,緩衝規則如下:

    1. 如果來源站點返回set-cookie回應標頭,DCDN不緩衝。

    2. 如果來源站點沒有返回Set-Cookie回應標頭,則遵循DCDN控制台配置的狀態代碼到期時間來緩衝,配置多條規則時生效方式請參考多條規則生效優先順序說明。

    3. 其他情境不緩衝。

  • 對於採用range方式回源的請求,DCDN節點如果收到來源站點響應的非206狀態代碼,則DCDN節點會刪除已緩衝的分區檔案(回源逾時不會刪除快取檔案)。

    Range回源情況下,來源站點會把一個大檔案分割成多個小的檔案分區來返回給DCDN節點。比如有個檔案被分割成了10個分區,DCDN節點已經緩衝了5個分區,在請求第6個分區時,來源站點響應了5xx狀態代碼,這時會把前面已經緩衝的5個分區全部刪除。

多條規則生效說明

支援設定多條狀態代碼緩衝規則,當某個請求同時匹配了多條規則時,只會有一條規則生效,生效規則如下:

  • 判斷順序

    先判斷規則類型(檔案尾碼名>目錄),再判斷規則建立時間(先建立的>後建立的)。

  • 不同類型規則的生效優先順序:檔案尾碼名>目錄。

    例如,如果使用者的請求同時匹配了2條規則(均配置了404狀態代碼),規則類型分別為檔案尾碼名目錄類型,404狀態代碼的到期時間以類型為檔案尾碼名的規則為準。具體樣本,請參見配置樣本

  • 相同類型規則的生效優先順序:先建立的>後建立的(規則列表由上而下)。

    例如,如果使用者的請求同時匹配2條規則(均配置了404狀態代碼),規則類型相同(均為檔案尾碼名或均為目錄類型),404狀態代碼的到期時間以最早建立的規則為準。具體樣本,請參見配置樣本

操作步驟

  1. 登入DCDN控制台

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

  3. 域名管理頁面,找到目標網域名稱,單擊操作列的配置

  4. 在指定網域名稱的左側導覽列,單擊緩衝配置

  5. 單擊狀態代碼到期時間頁簽。

  6. 單擊添加,配置狀態代碼到期時間。

    image

    類型

    注意事項

    類型

    支援目錄檔案尾碼名這兩種類型,請根據您的實際需求選擇。

    說明

    不同類型規則的生效優先順序:檔案尾碼名>目錄,具體請參見多條規則生效說明

    地址

    • 類型選擇為目錄,填寫說明如下:

      • 每次只能添加一條目錄。

      • 支援輸入目錄的完整路徑,須以正斜線/開頭,例如/directory/aaa

    • 類型選擇為檔案尾碼名,填寫說明如下:

      • 支援輸入一個或多個檔案尾碼名,多個檔案尾碼名用半形逗號(,)分隔,例如jpg,txt

        說明

        不同記錄中配置的檔案尾碼名類型完全相同,僅有大小寫區分時,後面建立的會覆蓋掉前面建立的,例如建立jpg,txt規則後,再建立jpg,txt規則時,會覆蓋掉之前建立的jpg,txt記錄。此時,如果需要配置小寫規則,可以單獨建立txtjpg的規則。配置規則實際生效的時候是嚴格區分大小寫。

      • 不支援用星號*匹配所有的檔案類型。

    狀態代碼到期時間設定

    需要緩衝的狀態代碼及其緩衝時間,最長可設定3年,單位:秒,配置規則如下:

    • 多個狀態代碼用半形逗號,分隔。

    • 對於2xx、3xx狀態代碼,僅支援單個精準配置,不支援模糊大量設定。例如,201=10(支援),2xx=12(不支援)。

    • 對於4xx、5xx狀態代碼,既支援單個精準配置,也支援模糊大量設定。例如,401=10(支援),4xx=12(也支援)。

    優選遵循來源站點緩衝策略

    開啟後,如果來源站點響應了緩衝策略標題(包括 Cache-ControlPragma ),那麼來源站點響應的緩衝策略將會優先生效。

    忽略來源站點不緩衝標題

    開啟後,DCDN節點將會忽略來源站點響應的以下幾個緩衝策略標題(這幾個標題均表示不緩衝)。

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    用戶端跟隨DCDN緩衝策略

    開啟後,DCDN節點會將最終生效的緩衝策略響應給用戶端。

    強制內容重新驗證

    該參數只在緩衝到期時間為0時生效,使用效果如下:

    • 關閉(預設):DCDN的緩衝到期時間配置為0時,DCDN節點上不快取檔案,每次請求都需要回源擷取內容。

    • 開啟:DCDN的緩衝到期時間配置為0時,支援在DCDN節點上快取檔案,每次請求都需要回源驗證緩衝內容。

  7. 單擊確定,完成配置。

    成功配置狀態代碼到期時間後,您可以在狀態代碼到期時間列表中,對當前的配置進行修改刪除操作。

配置樣本

  • 樣本一:目錄類型規則

    建立目錄類型規則如下圖所示:樣本一

    /directory/aaa目錄下,所有4xx狀態代碼緩衝時間為10秒,201狀態代碼緩衝時間為15秒,在該時間區間內,由DCDN節點直接響應對應的訪問請求;超過該時間後,會觸發回源。

  • 樣本二:檔案尾碼名類型規則

    建立檔案尾碼名類型規則如下圖所示:樣本二

    檔案尾碼為.jpg.txt類型,403狀態代碼緩衝時間為10秒,404狀態代碼緩衝時間為15秒,在該時間區間內,由DCDN節點直接響應對應的訪問請求;超過該時間後,會觸發回源。

  • 樣本三:不同類型規則的生效優先順序

    分別建立了一條目錄類型規則和一條檔案尾碼名類型規則,設定了不同的狀態代碼到期時間,如下圖所示:樣本三

    使用者請求 http://example.com/directory/aaa/test.jpg,DCDN節點上沒有緩衝資源,DCDN節點向來源站點請求資源,來源站點響應了404狀態代碼,這裡同時匹配上了目錄類型規則檔案尾碼名類型規則,因為在規則類型不同的情況下,規則生效優先順序是檔案尾碼名>目錄,所以檔案尾碼名類型規則生效,404狀態代碼的實際緩衝時間是20秒。

  • 樣本四:相同類型多條規則的生效優先順序

    先建立了一條目錄類型規則一,匹配的地址是/directory,然後再建立另一條目錄類型規則二,匹配的地址是/directory/aaa,設定了不同的狀態代碼到期時間,如下圖所示:樣本四

    使用者請求http://example.com/directory/aaa/test.jpg,DCDN節點上沒有緩衝資源,DCDN節點向來源站點請求資源,來源站點響應了404狀態代碼,這裡同時匹配上了兩條目錄類型規則,因為在規則類型相同的情況下,規則生效優先順序是早建立的>晚建立的,所以最早建立的目錄類型規則一生效,404狀態代碼的實際緩衝時間是15秒。

相關API

大量新增網域名稱