全部產品
Search
文件中心

ApsaraVideo VOD:配置HTTP回應標頭

更新時間:Feb 11, 2026

CDN節點上的緩衝到期或者沒有命中緩衝時,CDN節點會向來源站點發起請求來擷取最新內容,來源站點返回的內容以及相關的HTTP頭部資訊就是回源回應標頭。您可以通過調整來源站點修改入站回應標頭,來設定緩衝策略、跨域資源共用等,從而最佳化網站的載入速度、增強Alibaba Content Security Service性、控制資源可訪問性,並提高使用者體驗。

背景資訊

HTTP回應標頭是HTTP的響應訊息頭的組成部分之一,可攜帶特定響應參數資訊並傳遞給用戶端。

當CDN節點上沒有緩衝使用者請求的內容時,CDN會回來源站點拉取資源,來源站點收到CDN的請求後會給出響應。為了便於使用者識別來源站點的響應資訊,您可以修改入站回應標頭功能,改寫使用者來源站點響應報文中的HTTP Header資訊。例如,改寫回源回應標頭中Content-Type參數的值,然後再傳遞給用戶端,以確保用戶端解析正常(如果來源站點返回的Content-Type值有誤,用戶端直接解析將出現亂碼,因此需要在CDN上改寫)。

image
說明
  • 入站響應指來源站點收到CDN節點的請求後,返回給CDN節點的HTTP訊息。修改入站回應標頭配置只會影響來源站點響應給CDN節點的HTTP訊息,對於CDN節點直接響應給使用者的HTTP訊息不做修改。

  • 不支援對泛網域名稱修改入站回應標頭。

操作步驟

  1. 登入ApsaraVideo for VOD控制台

  2. 在左側導覽列選擇配置管理 > 分发加速配置 > 域名管理,進入到網域名稱管理頁面。

  3. 單擊目標網域名稱所在行的配置

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

  5. 單擊回源HTTP回應標頭頁簽。

  6. 單擊添加,並配置回源HTTP回應標頭資訊。

    重要

    當不同的操作方式同時作用於同一個回源回應標頭參數時,會存在操作衝突。此時按照操作類型的優先順序來執行,優先順序順序為替換增加變更刪除。例如,當增加和刪除操作同時作用於同一個參數時,會先增加再刪除。

    增加回應標頭參數

    image

    配置項

    樣本

    說明

    响应头操作

    增加

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

    自定义响应头参数

    自訂回源回應標頭

    選擇自訂回源回應標頭或選擇已經預設好的回應標頭參數。

    自定义响应头名称

    x-code

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

    响应头值

    key1

    一個回應標頭參數中可以配置多個值,多個值用英文逗號(,)分隔。

    key1,key2

    是否允许重复

    允許

    • 允许:可以添加重複的回應標頭參數。例如x-code:key1x-code:key2

    • 不允许:添加同一個回應標頭參數,新值將覆蓋舊值。例如先添加x-code:key1,再添加x-code:key2,最終的值為x-code:key2

    規則條件

    不使用

    規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

    • 不使用:不使用規則條件。

    • 若需新增或編輯規則條件,請在規則引擎中進行管理。

    刪除回應標頭參數

    image

    配置項

    樣本

    說明

    响应头操作

    刪除

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

    自定义响应头参数

    自訂回源回應標頭

    選擇自訂回源回應標頭或選擇已經預設好的回應標頭參數。

    自定义响应头名称

    x-code

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

    規則條件

    不使用

    規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

    • 不使用:不使用規則條件。

    • 若需新增或編輯規則條件,請在規則引擎中進行管理。

    變更回應標頭參數

    image

    配置項

    樣本

    說明

    响应头操作

    變更

    當回應標頭參數不存在重複時,可以正常變更參數,如果有多個重複的回應標頭參數,則不允許變更。

    自定义响应头参数

    自訂回源回應標頭

    選擇自訂回源回應標頭或選擇已經預設好的回應標頭參數。

    自定义响应头名称

    x-code

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

    响应头变更为

    key1,key3

    一個回應標頭參數中可以配置多個值,多個值用英文逗號(,)分隔。

    規則條件

    規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

    • 不使用:不使用規則條件。

    • 若需新增或編輯規則條件,請在規則引擎中進行管理。

    替換回應標頭參數

    image

    配置項

    樣本

    說明

    响应头操作

    替換

    當回應標頭參數不存在重複時,可以正常替換參數,如果有多個重複的回應標頭參數,則不允許替換。

    自定义响应头参数

    自訂回源回應標頭

    選擇自訂回源回應標頭或選擇已經預設好的回應標頭參數。

    自定义响应头名称

    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

    規則條件

    規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

    • 不使用:不使用規則條件。

    • 若需新增或編輯規則條件,請在規則引擎中進行管理。

  7. 單擊确定,完成配置。

配置樣本

樣本一:配置響應文檔屬於某種MIME類型

配置情境

如果您希望配置響應文檔屬於某種MIME類型。

說明

MIME類型主要包含以下幾類:

  • 文本類型:包括文字檔(例如.txt、.csv)和HTML檔案(例如.html、.htm、.shtml)。

  • 圖片類型:包括常見的圖片檔案(例如.jpg、.png、.gif)。

  • 音訊類型:包括音頻檔案(例如.mp3、.wav)。

  • 視頻類型:包括視頻檔案(例如.mp4、.avi)。

  • 應用程式類型:包括應用程式檔案(例如.pdf、.doc、.xls)。

配置方法

  • 回應標頭操作:增加

  • 自訂回應標頭名稱:Content-Type。

  • 回應標頭值:text/html。

    image

結果說明:在來源站點發送給CDN節點的響應資訊中聲明內容類型為text/html,再次配置將覆蓋舊值。

樣本二:刪除回應標頭資訊

配置情境

如果您希望刪除回應標頭資訊。

配置方法

  • 回應標頭操作:刪除

  • 自訂回應標頭名稱:Content-Type。

配置

結果說明:刪除要求標頭中的Content-Type資訊,然後返回給使用者。

說明

如果同時完成了樣本一樣本二,那麼會先增加回應標頭Content-Type資訊(響應的內容屬於text/html類型),然後刪除該要求標頭,最終結果為:響應的資源沒有MIME類型限制,直接以最初的類型返回使用者。

相關文檔

大量設定網域名稱