全部產品
Search
文件中心

Edge Security Acceleration:修改出站要求標頭

更新時間:Oct 12, 2025

HTTP要求標頭是HTTP請求訊息的組成部分,用於攜帶特定的請求參數並傳遞給伺服器。通過配置回源HTTP要求標頭規則,可將特定參數傳遞給來源站點。邊緣安全加速 ESA支援對回源HTTP要求標頭規則進行新增、修改和刪除,以滿足更多實際業務需求。

功能介紹

當用戶端請求訪問資源時,請求首先到達ESA。如果未命中ESA節點的緩衝,ESA節點將攜帶出站HTTP要求標頭向來源站點發起回源請求擷取資料。可以根據業務需求對出站HTTP要求標頭進行調整。ESA節點將擷取到的資源返回用戶端。

注意事項

同一條修改出站要求標頭規則配置裡面,如果存在多個操作配置,則這些操作將會順序執行,存在名稱相同的要求標頭的情況下,後面的操作將會覆蓋前面的操作。

樣本一

  • 用戶端請求裡面攜帶了一個要求標頭test:123

  • 規則裡面新增了一個要求標頭test:321

使用者請求命中規則的情況下,執行結果是原始請求裡面的要求標頭test:123被覆蓋為test:321

樣本二

  • 用戶端請求裡面攜帶了一個要求標頭test:123

  • 規則裡面新增了一個要求標頭test:321,然後又配置了一條規則是刪除要求標頭test

使用者請求命中規則的情況下,執行結果是原始請求裡面的要求標頭test:123被刪除。

操作步驟

新增規則後,當使用者發起資源訪問請求時,ESA將根據規則的生效優先順序依次進行匹配與執行。

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

  2. 在左側導覽列,選擇規則 > 轉換規則

  3. 單擊修改出站要求標頭頁簽,單擊新增規則,填寫規則名稱

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

  5. 修改出站要求標頭地區,選擇規則適用的資源類型操作方式,填入要求標頭名稱要求標頭值

    說明

    同一條修改出站要求標頭規則配置裡面,如果存在多個操作配置,則這些操作將會順序執行,存在名稱相同的要求標頭的情況下,後面的操作將會覆蓋前面的操作。

    操作方式

    類型

    說明

    樣本

    添加

    靜態

    • 在回源請求中添加指定要求標頭。

    • 如果用戶端請求中已經包含了同名要求標頭,則新添加的要求標頭將會覆蓋用戶端請求中的同名要求標頭。

    增加名稱為x-code,值為key1的要求標頭,請填寫:

    • 要求標頭名稱x-code

    • 要求標頭值key1

    動態

    要求標頭值支援設定為一個運算式

    增加名稱為True-Client-IP,值為ip.src的要求標頭,用於記錄用戶端的真實IP地址,請填寫:

    • 要求標頭名稱True-Client-IP

    • 要求標頭值ip.src

    變更

    靜態

    在回源請求中變更指定要求標頭的值。

    修改回源請求中名稱為x-code的要求標頭的值為key2,請填寫:

    • 要求標頭名稱x-code

    • 要求標頭值key2

    動態

    要求標頭值支援設定為一個運算式

    修改回源請求中名稱為True-Client-IP的要求標頭,值為ip.src,將要求標頭的值變更為用戶端的真實IP地址,請填寫:

    • 要求標頭名稱True-Client-IP

    • 要求標頭值ip.src

    刪除

    在回源請求中刪除所有與要求標頭名稱匹配的參數值,無論是否有重複的要求標頭參數。

    刪除名稱為x-code的要求標頭,請填寫要求標頭名稱x-code

    說明
    • 禁止配置以ali-或者Ali-開頭的要求標頭名稱

    • 要求標頭值中可以配置多個值,用英文逗號,分隔。

    • 刪除操作不區分靜態模式和動態模式,效果一致。

    • 變更是對已存在的要求標頭進行修改,僅在原始要求標頭中存在對應名稱的要求標頭時,變更操作才會生效。

  6. 單擊確定

動態運算式樣本

樣本一

添加用於記錄用戶端的真實IP地址的要求標頭。

  • 要求標頭名稱:True-Client-IP

  • 要求標頭值:ip.src

樣本二

添加用於記錄用戶端IP地址對應國家代碼的要求標頭。

  • 要求標頭名稱:IP-Country-Code

  • 要求標頭值:ip.geoip.country

樣本二

添加用於記錄用戶端IP地址對應省份代碼的要求標頭。

  • 要求標頭名稱:IP-Province-Code

  • 要求標頭值:ip.src.subdivision_1_iso_code

相關文檔

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