全部產品
Search
文件中心

:修改入站回應標頭

更新時間:Nov 29, 2025

使用者的請求通過全站加速到達來源站點後,如果您需要來源站點反饋的回源響應具備某些能力或者符合自訂的規則時(如緩衝機制、請求MIME類型、到期時間等),可以通過修改入站回應標頭來實現。通過本文,您可以瞭解修改入站回應標頭功能的操作方法。

前提條件

預設不對外提供該功能,需提交工單申請對需要使用該功能的網域名稱開啟使用許可權。

背景資訊

HTTP回應標頭是超文字傳輸通訊協定 (HTTP)HTTP( Hypertext Transfer Protocol)的響應訊息中訊息頭的組成部分之一,修改入站回應標頭後會使該響應訊息具備參數賦予的能力。回應標頭由一個網域名稱,冒號(:)和域值三部分組成,例如Cache-Control: no-cache。

HTTP協議採用了請求和響應模型。使用者發出的請求通過全站加速以後到達來源站點,來源站點以一個狀態行作為回源響應,您可以對來源站點返回的回應標頭做修改,來實現相應的能力,原理如下圖所示。

阿里雲為您提供如下回源參數,來實現下表中的能力:

回應標頭

說明

樣本

Cache-Control

控制來源站點到全站加速所有的緩衝機制是否可以緩衝這個對象,單位是秒。

Cache-Control: max-age=3600

Content-Type

佈建要求體的MIME類型(適用POST和PUT請求)。

Content-Type: application/x-www-form-urlencoded

Expires

指定一個日期或者時間,超過該時間此回應到期。

Content-Type: text/html

Last-Modified

請求對象最後一次的修改日期。

Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT

自訂回源回應標頭

當以上回應標頭無法滿足您的需求時,您還可以選擇自訂回源回應標頭來自訂回應標頭參數和值。

Allow、Content-Encoding和Content-Length等

說明
  • 回源請求是指某加速網域名稱下使用者的請求通過全站加速返回來源站點的HTTP訊息。

  • 回源HTTP回應標頭是網域名稱維度,因此當配置生效,會對網域名稱下任意一個資源的響應訊息生效。該配置只會影響通過全站加速返回來源站點的HTTP訊息,對於全站加速節點直接響應給使用者的HTTP訊息不做修改。

  • 目前不支援泛網域名稱設定。

操作步驟

  1. 登入DCDN控制台

  2. 在左側導覽列,單擊域名管理

  3. 域名管理頁面,找到目標網域名稱,單擊操作列的配置

  4. 在指定網域名稱的左側導覽列,單擊回源配置

  5. 單擊修改入站回應標頭頁簽。

  6. 修改入站回應標頭頁面,單擊添加

  7. 修改入站回應標頭資訊。

    您可以根據業務需要,對回源響應請求URL中的HTTP Header進行增加操作;您還可以對那些回源響應請求URL中預設攜帶、添加過或者不再需要的HTTP Header進行替換、變更和刪除操作。

    說明

    當對同一個回源回應標頭參數同時執行不同操作時,按照以下優先順序依次執行:替換 > 增加 > 變更 > 刪除。例如:當增加和刪除操作同時作用於同一個參數時,會先增加,再刪除。

    • 增加回應標頭參數

      HTTP回應標頭

      配置項

      樣本

      說明

      回應標頭操作

      增加

      在回源HTTP請求中增加指定的回應標頭參數。

      自訂回應標頭參數

      自訂回應標頭

      可以選擇在配置彈窗中已經預製的回應標頭參數,也可以在下拉框裡選擇自訂緩衝回應標頭,配置自訂緩衝回應標頭參數。

      自訂回應標頭名稱

      x-code

      自訂回應標頭名稱為x-code。

      回應標頭值

      key1

      一個回應標頭參數裡面,可以配置多個值,不同值之間使用英文逗號(,)隔開。

      key1,key2

      是否允許重複

      允許

      是否允許重複設定為允許時,該回應標頭參數可以設定不同的參數值。例如:x-code:key1x-code:key2

      不允許

      是否允許重複設定為不允許時,該回應標頭參數僅可以設定唯一的參數值,後面添加的參數值會覆蓋前面添加的參數值。例如:先添加x-code:key1後,再添加x-code:key2,最終的值為x-code:key2

    • 替換回應標頭參數

      替換

      配置項

      樣本

      說明

      回應標頭操作

      替換

      當回應標頭參數不存在重複時,可以正常替換參數,有多個重複回應標頭參數的情況下,不允許進行替換操作。

      自訂回應標頭參數

      自訂回應標頭

      可以選擇在配置彈窗中已經預製的回應標頭參數,也可以在下拉框裡選擇自訂響緩衝應頭,變更自訂緩衝回應標頭參數。

      自訂回應標頭名稱

      x-code

      自訂回應標頭名稱為x-code。

      尋找

      key

      Regex尋找需要替換的參數值。

      替換為

      abc

      Regex替換需要替換的參數值。

      匹配

      匹配所有

      匹配選項設定為匹配所有時,所有被匹配的值都會被替換。例如:x-code:key1,key2,key3,正則匹配值key替換為abc,替換後的結果為x-code:abc1,abc2,abc3

      僅匹配第一個

      匹配選項設定為僅匹配第一個時,只有第一個被匹配的值會被替換。例如:x-code:key1,key2,key3,正則匹配值key替換為abc,替換後的結果為x-code:abc1,key2,key3

    • 變更回應標頭參數

      變更

      配置項

      樣本

      說明

      回應標頭操作

      變更

      當回應標頭參數不存在重複時,可以正常變更參數,有多個重複回應標頭參數的情況下,不允許進行變更操作。

      自訂回應標頭參數

      自訂回應標頭

      可以選擇在配置彈窗中已經預製的回應標頭參數,也可以在下拉框裡選擇自訂緩衝回應標頭,變更自訂緩衝回應標頭參數。

      自訂回應標頭名稱

      x-code

      自訂回應標頭名稱為x-code。

      回應標頭變更為

      key1,key3

      一個回應標頭參數裡面,可以配置多個值,不同值之間使用英文逗號(,)隔開。

    • 刪除回應標頭參數

      刪除

      配置項

      樣本

      說明

      回應標頭操作

      刪除

      刪除所有與回應標頭參數名稱匹配的參數值,無論是否有重複的回應標頭參數。

      自訂回應標頭參數

      自訂回應標頭

      可以選擇在配置彈窗中已經預製的回應標頭參數,也可以在下拉框裡選擇自訂緩衝回應標頭,刪除自訂緩衝回應標頭參數。

      自訂回應標頭名稱

      x-code

      自訂回應標頭名稱為x-code。

  8. 單擊確定