繞過緩衝 - Edge Security Acceleration

如果您希望邊緣安全加速 ESA不緩衝原本匹配預設緩衝規則的部分資源，可以設定規則條件過濾出這部分請求，然後再配置緩衝資格為繞過緩衝。

說明

在沒有設定任何緩衝規則或者緩衝配置的情況下，ESA節點的緩衝邏輯遵循預設緩衝規則。

使用情境

如果來源站點有部分資源不希望在ESA節點上緩衝（即動態資源，每個請求都需要回源擷取最新的內容），您可以在緩衝規則中配置針對指定資源使用繞過緩衝模式，動態資源使用繞過緩衝的處理方式能夠提高訪問效能。

操作步驟

在ESA控制台選擇網站管理，在網站列單擊目標網站。
在左側導覽列，選擇規則 > 緩衝規則。
單擊新增規則，填寫規則名稱。
在如果請求匹配以下規則...地區設定要匹配的使用者請求特徵，具體配置規則請參見規則運算式文法。
在緩衝資格地區，選擇緩衝策略後單擊確定。
- 繞過緩衝：所有請求都繞過邊緣節點上的緩衝組件，以便能夠即時查看來源站點伺服器上的最新資源。設定為繞過緩衝的情況下，緩衝相關功能中，僅瀏覽器緩衝到期時間這一項能夠生效。
  說明
  限制說明：
  - ESA 不支援通過 HTTP 回應標頭（如 X-Fallback）配置不緩衝，也不支援通過 HTML 注釋標記實現局部不緩衝，需改用基於要求標頭或 URL 路徑的緩衝規則。
  - 未配置任何緩衝規則時，ESA 遵循預設緩衝規則；以 / 結尾的動態請求預設回源；來源站點返回 no-cache 回應標頭時，ESA 預設不緩衝該資源。
  - 緩衝欺騙防禦和響應到期緩衝功能預設關閉，如需使用，請在緩衝規則中手動開啟。
- 符合緩衝條件：所有合格請求都經過邊緣節點上的緩衝組件，可直接從緩衝節點上擷取資源，而無需從來源站點重新擷取，有效避免通過較長的鏈路回源，從而減少延遲和提高資源訪問效率。

常見配置樣本

以下為高頻使用情境的參考配置，協助快速完成動靜分離策略的設定。

樣本 1：動態介面 / API 不緩衝

針對介面或 PHP 頁面，配置繞過緩衝規則：

URL 路徑包含 /api 或 /prod-api/，緩衝資格選擇繞過緩衝；
或副檔名等於 php（填寫時不帶點），緩衝資格選擇繞過緩衝。

樣本 2：後台 / 登入頁不緩衝

針對 WordPress 後台（/wp-admin）、CMS 管理端或登入介面（/login）路徑，配置繞過緩衝規則，並將該規則置於規則列表頂部，確保其優先順序高於靜態資源緩衝規則。

樣本 3：單頁應用（SPA）根路徑緩衝

ESA 預設不緩衝無尾碼 URL（如 /）。若需緩衝 text/html 頁面內容，新增規則：匹配要求標頭 Accept 包含 text/html，並配置相應的緩衝時間。

樣本 4：特定檔案不緩衝

配置特定檔案路徑時，注意格式：

路徑欄位填寫 sitemap（不帶尾碼），可匹配 sitemap.xml；
副檔名欄位填寫 xml（不帶點），而非 .xml。

樣本 5：動靜分離策略

建議刪除全站緩衝規則，改為分別配置兩條獨立規則：

靜態資源緩衝：匹配圖片、CSS、JS 等靜態資源路徑，配置相應緩衝時間；
動態介面繞過緩衝：匹配 API 介面路徑，設定緩衝資格為繞過緩衝。

這樣可以精確控制緩衝策略，避免動態請求被誤緩衝。

注意事項

規則拆分原則：一條緩衝規則只能設定一個緩衝時間。不同檔案尾碼或目錄若緩衝策略不同，需拆分為多條獨立規則分別配置。
規則獨立性：關閉或刪除某條特定緩衝規則，不會影響其他規則的生效狀態，系統按剩餘規則的列表順序繼續匹配。
規則優先順序：ESA 按規則列表從上到下匹配，首條命中的規則即生效。需要高優先順序的規則（如繞過緩衝）應置於列表頂部。

常見問題

為什麼配置了繞過緩衝規則但未生效？

按以下步驟逐項排查：

檢查匹配條件：確認規則運算式是否準確，常見錯誤包括：OR 條件導致邏輯覆蓋其他網域名稱；副檔名或路徑格式填寫錯誤（如副檔名多了點號）。
確認請求特徵：若規則依賴特定要求標頭（如 sec-fetch-site）觸發，需確認實際請求是否攜帶該標題。
調整規則順序：ESA 按列表從上到下匹配，若繞過緩衝規則位於長緩衝規則之後，可能被前置規則攔截。將繞過緩衝規則調整至列表頂部。
重新整理緩衝：修改規則後，需在控制台執行 URL 或目錄重新整理；僅重新整理瀏覽器無效。
確認套餐版本：免費版套餐可能無法保證規則穩定生效，建議確認套餐權益或升級套餐。
驗證是否過 ESA 節點：通過回應標頭 Server 欄位判斷請求是否經過 ESA 節點，使用無痕瀏覽器排除本機快取幹擾。

接入 ESA 後網站無法登入、跳轉失敗或頁面內容異常怎麼辦？

此類問題通常因全站緩衝或不當的緩衝規則導致登入態 Cookie、Session 或動態 API 響應被邊緣節點緩衝。解決步驟：

暫停或刪除可疑的全站緩衝規則；
為登入頁、驗證碼介面及後台路徑單獨配置繞過緩衝規則，並確保其優先順序最高（置於列表頂部）；
在控制台重新整理相關 URL 緩衝；
使用無痕瀏覽器驗證是否恢複正常。

若以上配置無誤仍異常，需排查來源站點商務邏輯（如 302 跳轉邏輯是否正確識別登入狀態）。此類情況屬於來源站點問題，非 ESA 產品問題。

緩衝規則中的"等於"與"包含"有什麼區別？

匹配方式	說明
等於	精確匹配指定 URL 路徑，同時自動涵蓋該路徑下的所有子路徑。例如，配置 `/test/_nuxt/` 等於，也會匹配其下級資源。
包含	模糊比對，只要 URL 中出現指定字串即命中，無論該字串出現在路徑的哪個位置。

在主機名稱匹配情境下，"等於"與"包含"效果類似，均可正常使用。

為什麼開啟緩衝規則後撥測正常，關閉後反而逾時？

這是正常現象，原因如下：

開啟緩衝時：請求由邊緣節點直接響應，來源站點壓力小，響應速度快；
關閉緩衝後：所有請求（包括動態請求）均即時回源，高並發撥測可能導致來源站點負載過高而逾時。

此現象反映來源站點存在效能瓶頸，屬於來源站點問題，非 ESA 問題。建議：

通過配置緩衝規則減輕回源壓力；
開啟 JS 挑戰或智能限頻功能保護來源站點。

Edge Security Acceleration：緩衝資格