全部產品
Search
文件中心

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

更新時間:Mar 11, 2026

當來源站點響應非 2xx 狀態代碼時,邊緣安全加速 ESA節點可緩衝該狀態代碼並在有效期間內直接響應,無需每次回源,有效減輕來源站點壓力。

適用情境

正常情況下,ESA節點從來源站點成功擷取到資源(來源站點響應 2xx 狀態代碼)時,會按照緩衝配置規則進行緩衝。但如果來源站點響應非 2xx 狀態代碼(例如 404、502 等),且不希望所有請求都回源,可以配置狀態代碼緩衝到期時間,由ESA節點直接響應狀態代碼,減輕來源站點壓力。

典型情境

檔案 A 在來源站點已被刪除,但用戶端仍持續訪問。由於ESA節點沒有快取檔案 A,所有針對檔案 A 的請求都將回源,由來源站點響應 404 狀態代碼,這會大幅增加來源站點壓力。

如果在ESA節點上配置了緩衝 404 狀態代碼,節點首次回源擷取 404 狀態代碼後會進行緩衝,在緩衝有效期間內,後續請求將由ESA節點直接響應 404,無需回源,從而減輕來源站點壓力。

操作步驟

  1. 在ESA控制台選擇網站管理,在網站列單擊目標網站。

  2. 在左側導覽列,選擇規則 > 緩衝規則

  3. 單擊新增規則,填寫規則名稱

  4. 如果請求匹配以下規則...地區設定要匹配的使用者請求特徵,具體配置規則請參見規則運算式的組成

  5. 繞過緩衝地區,設定是否繞過緩衝,具體請參見緩衝資格

  6. 邊緣緩衝到期時間地區,單擊配置

  7. 單擊狀態代碼緩衝到期時間添加,配置以下參數後單擊確定

    • 狀態代碼:需要緩衝的 HTTP 狀態代碼。支援 4xx(用戶端錯誤)和 5xx(服務端錯誤)狀態代碼,例如 404、502、503 等。

    • 到期時間:節點緩衝該狀態代碼的有效期間,取值範圍:1 秒~31536000 秒(1 年)。到期後節點將重新回源擷取狀態代碼。

    image

配置樣本

情境 1:緩衝靜態資源 404 錯誤

業務需求:網站圖片目錄中的圖片可能被刪除,但前端頁面仍引用舊路徑。

配置方案

  • 匹配條件:URL 路徑包含 /images

  • 狀態代碼:404

  • 緩衝到期時間:600 秒(10 分鐘)

image

生效邏輯:首次請求不存在的圖片時節點回源擷取 404 並緩衝 10 分鐘,後續 10 分鐘內的相同請求由節點直接響應 404,無需回源。

情境 2:短時緩衝來源站點故障

業務需求:來源站點偶爾出現短暫不可用,返回5xx錯誤,希望快速恢複服務。

配置方案

  • 匹配條件所有傳入請求

  • 狀態代碼:5xx

  • 緩衝到期時間:60 秒(1 分鐘)

image

生效邏輯:來源站點故障時節點緩衝 5xx 狀態代碼 1 分鐘,避免大量回源請求加重來源站點壓力;1 分鐘後重新回源檢查來源站點是否已恢複。

驗證配置

配置完成後,可以使用以下方法驗證配置是否生效。

方法 1:使用 curl 命令

  1. 清除本機快取,發起首次請求:

    curl -I https://example.com/non-existent-page

    預期回應標頭包含 x-site-cache-status: MISS(表示首次回源)。

  2. 立即再次請求相同 URL

    curl -I https://example.com/non-existent-page

    預期回應標頭包含 x-site-cache-status: HIT(表示命中緩衝)以及表示緩衝時間長度的欄位值自動遞增。

方法 2:使用瀏覽器開發人員工具

  1. 開啟 Chrome DevTools (F12),切換到 Network 標籤頁,勾選 Preserve log。

  2. 訪問一個不存在的資源(如 https://example.com/test404)。

  3. 查看請求詳情中的 Response Headers:首次請求顯示 x-site-cache-status: MISS,後續請求顯示 x-site-cache-status: HIT 且表示緩衝時間長度的欄位值自動遞增。

常見問題

配置後為什麼仍然在回源?

  1. 緩衝時間已到期:檢查配置的 TTL 值,確認是否過短。可以查看回應標頭中的 Cache‑Control等欄位,確認緩衝存活時間。

  2. URL 參數不同:預設情況下,不同 URL 參數視為不同的緩衝鍵。建議配置緩衝鍵規則,忽略無關參數。

  3. 規則未生效:檢查規則的匹配條件(如路徑匹配條件),確保覆蓋目標請求。

如何驗證特定 URL 的緩衝狀態?

使用 curl 命令查看詳細回應標頭:

curl -v -I https://example.com/target-url

關鍵回應標頭說明:

  • x-site-cache-status: HIT - 命中緩衝

  • x-site-cache-status: MISS - 未命中緩衝,已回源

  • Cache‑Control:max‑age=120 - 緩衝已存活 120 秒

如何手動清除特定狀態代碼的緩衝?

可進行按URL重新整理緩衝按目錄重新整理緩衝

相關文檔

規則相關的功能,在生效優先順序、可重新進入性、生效顆粒度上存在差異,詳細情況請查看規則相關功能的特性說明