全部產品
Search
文件中心

Edge Security Acceleration:修改入站回應標頭

更新時間:Jan 14, 2026

可以選擇修改、刪除或添加從來源站點返回的回應標頭(如 Cache-ControlExpires),通過控制這些頭部資訊來最佳化緩衝策略、保護使用者安全,並提升對使用者行為的洞察與體驗定製能力。

背景介紹

該功能將根據預設規則對指定的傳入響應標題進行修改。通過此功能添加的響應標題會在ESA伺服器處理對象之前生效,因此若響應內容可被緩衝,這些標題將隨響應一同存入緩衝中。這與修改出站回應標頭行為有明顯區別:後者是在ESA伺服器完成響應處理、從來源站點或緩衝中擷取完整響應後,才添加或修改響應標題,隨後立即將響應發送給用戶端。

image

操作步驟

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

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

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

  3. 選擇修改回應標頭頁簽,單擊來源站點到 ESA項,單擊新增規則

    image

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

  5. 修改回應標頭地區,選擇操作方式,寫入回應標頭名稱回應標頭值後單擊確定

    操作方式

    類型

    說明

    樣本

    添加

    靜態

    • 在返回用戶端的響應中添加指定回應標頭。

    • 如果用戶端中的回應標頭已包含同名回應標頭,則新添加的回應標頭將覆蓋該同名回應標頭。

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

    • 回應標頭名稱x-code

    • 回應標頭值key1

    動態

    回應標頭值支援設定為一個運算式

    增加名稱為Client-Ip-Geo-Location,值為ip.geoip.country的回應標頭,用於記錄用戶端IP歸屬的地理位置對應的國家或地區,請填寫:

    • 回應標頭名稱Client-Ip-Geo-Location

    • 回應標頭值ip.geoip.country

    變更

    靜態

    在返回用戶端的響應中變更指定回應標頭的值。

    修改名稱為x-code的回應標頭,值為key2,請填寫:

    • 回應標頭名稱x-code

    • 回應標頭值key2

    動態

    回應標頭值支援設定為一個運算式

    修改名稱為Client-Ip-Geo-Location的回應標頭,值為ip.geoip.country,將回應標頭值變更為用戶端IP歸屬的地理位置對應的國家或地區,請填寫:

    • 回應標頭名稱Client-Ip-Geo-Location

    • 回應標頭值ip.geoip.country

    刪除

    在返回用戶端的響應中刪除所有與回應標頭名稱匹配的參數值,無論是否有重複的回應標頭參數。

    刪除名稱為x-code的回應標頭,請填寫回應標頭名稱x-code

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

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

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

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

回應標頭參數說明

回應標頭參數

說明

樣本

自訂

支援添加自訂回應標頭。自訂回應標頭名稱要求如下:

  • 由大小寫字母、中劃線-和數字組成。

  • 長度為1~100個字元。

Test-Header

Cache-Control

指定用戶端程式請求和響應遵循的緩衝機制。

no-cache

Content-Disposition

指定用戶端程式將請求所得的內容存為一個檔案時提供的預設檔案名稱。

examplefile.txt

Content-Type

指定用戶端程式響應對象的內容類型。

text/plain

Pragma

Pragma 是一個在 HTTP/1.0 中規定的通用首部,這個首部通常用於在伺服器的響應中定義用戶端對檔案的緩衝行為。

no-cache

Access-Control-Allow-Origin

指定哪些源可以訪問資源。它是跨域資源共用(CORS,Cross-Origin Resource Sharing)機制的一部分,該機制允許伺服器聲明其資源是否可以被某個指定的源網域名稱訪問。該回應標頭的值支援以下類型:

  • 萬用字元 *:使用萬用字元表示允許任何源訪問資源。這種方式非常寬鬆,適用於那些公開無需認證或授權即可訪問的資源。不過,在生產環境中使用萬用字元時需要謹慎,因為它可能帶來安全風險,比如跨站請求偽造攻擊。

  • 單個指定源:你可以指定一個具體的源網域名稱,表示僅允許該特定源訪問資源。例如http://example.comhttps://api.example.com,這要求請求必須來自指定的源,否則將被拒絕。

  • *

  • http://www.aliyun.com

Access-Control-Allow-Methods

指定允許的跨域要求方法。多個方法用英文逗號,分隔。

POST,GET

Access-Control-Allow-Headers

指定允許的跨域請求欄位。

X-Custom-Header

Access-Control-Expose-Headers

指定允許訪問的自訂頭資訊。

Content-Length

Access-Control-Allow-Credentials

該回應標頭指示是否允許將請求的響應暴露給頁面。

  • true:表示可以暴露。

  • 其他值:表示不可以暴露。

true

Access-Control-Max-Age

指定用戶端程式對特定資源的預請求返回結果的緩衝時間,單位為秒。

600

相關文檔

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