全部產品
Search
文件中心

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

更新時間:Jan 17, 2026

通過配置對來自用戶端或上遊的特定請求標題進行修改、添加、刪除的行為,您可以根據後端服務需求(如添加 Accept-EncodingAccept-Language 等標題)靈活控制請求內容,從而進一步自訂網站訪問者的體驗並深入瞭解其使用行為。

功能介紹

通過邊緣安全加速 ESA的修改入站要求標頭功能,您可以在邊緣節點對用戶端的原始請求進行處理,靈活地添加、變更或刪除指定的要求標頭。這使您能夠實現精細化的回源路由控制、豐富後端日誌資訊、並清理無關的要求標頭資料,從而增強業務靈活性與安全性。

image

配置入站要求標頭

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

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

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

  3. 單擊修改要求標頭頁簽,選擇用戶端到ESA項,單擊新增規則

    image

  4. 新增修改要求標頭規則地區,填寫:

    • 規則名稱:填寫自訂規則名稱

    • 如果請求匹配以下規則...:選擇該規則將匹配的請求特徵。

      • 所有傳入請求:表示該規則將應用於當前網站下的所有請求。

      • 自訂規則:表示該規則僅應用於與自訂運算式匹配的流量。可以通過控制群組合配置自訂的流量篩選條件。

    • 修改要求標頭:表示符合特徵的請求將執行的動作。

      操作方式

      類型

      說明

      樣本

      添加

      靜態

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

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

      增加名稱為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-開頭的要求標頭名稱

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

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

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

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

動態運算式配置樣本

添加用戶端真實IP地址

情境

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

操作步驟

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

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

  3. 單擊修改要求標頭頁簽,選擇用戶端到ESA項,單擊新增規則

    image

  4. 新增修改要求標頭規則地區,填寫:

    • 規則名稱:填寫自訂規則名稱add-client-ip-in

    • 如果請求匹配以下規則...:選擇所有傳入請求,表示該規則將應用於當前網站下的所有請求。

    • 修改要求標頭

      • 類型動態

      • 操作方式添加

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

      • 要求標頭值ip.src

    image

效果驗證

配置前:不攜帶用戶端真實IP。

image

配置後:通過true-client-ip-in標題攜帶用戶端真實IP。

image

添加用戶端IP地址對應國家代碼

情境

為所有來自非中國香港的請求添加用於記錄用戶端IP地址對應國家代碼的要求標頭。

操作步驟

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

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

  3. 單擊修改要求標頭頁簽,選擇用戶端到ESA項,單擊新增規則

    image

  4. 新增修改要求標頭規則地區,填寫:

    • 規則名稱:填寫自訂規則名稱add-client-country

    • 如果請求匹配以下規則...:選擇自訂規則,填寫省/地區 不等於 中國香港

      也可直接編輯運算式如下:(ip.geoip.country ne "HK")
    • 修改要求標頭

      • 類型動態

      • 操作方式添加

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

      • 要求標頭值ip.geoip.country

    image

效果驗證

配置前:不攜帶用戶端IP對應的國家資訊。

image

配置後:通過ip-country-code標題攜帶用戶端IP對應的國家代碼。

image

添加用戶端IP地址對應省份代碼

情境

為訪問URI為/content的請求添加用於記錄用戶端IP地址對應省份代碼的要求標頭。

操作步驟

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

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

  3. 單擊修改要求標頭頁簽,選擇用戶端到ESA項,單擊新增規則

    image

  4. 新增修改要求標頭規則地區,填寫:

    • 規則名稱:填寫自訂規則名稱add-client-province

    • 如果請求匹配以下規則...:選擇自訂規則,填寫URI路徑 等於 /content

      也可直接編輯運算式如下:(http.request.uri.path eq "/content")
    • 修改要求標頭

      • 類型動態

      • 操作方式添加

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

      • 要求標頭值ip.src.subdivision_1_iso_code

    image

效果驗證

配置前:不攜帶用戶端IP對應的省份資訊。

image

配置後:通過ip-province-code標題攜帶用戶端IP對應的省份代碼。

image

相關文檔

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