配置回源HTTP要求標頭 -

阿里雲DCDN預設支援攜帶一些例如用戶端IP地址的要求標頭，也支援自訂配置。如果您需要改寫使用者回源請求中的HTTP Header，可以通過配置回源HTTP要求標頭實現，支援增加、刪除、變更或替換回源HTTP要求標頭，滿足更多實際業務需求。

前提條件

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

HTTP要求標頭是HTTP的請求訊息頭的組成部分之一，可攜帶特定請求參數資訊並傳遞給伺服器。

當DCDN節點請求回來源站點拉取資源時，來源站點可擷取到回源要求標頭中攜帶的資訊。您可以通過該功能，改寫使用者回源請求中的HTTP Header資訊，攜帶特定的參數資訊給來源站點，實現特定業務需求。例如，通過X-Forwarded-For頭部攜帶真實用戶端IP至來源站點。

來源站點伺服器通過使用者回源請求中攜帶的X-Forwarded-For頭部擷取用戶端真實IP的方式，請參見擷取用戶端真實IP。

回源請求指使用者請求中通過DCDN回源的HTTP訊息。回源HTTP要求標頭配置只會影響通過DCDN回源的HTTP訊息，對於DCDN節點直接響應給使用者的HTTP訊息不做修改。
不支援對泛網域名稱配置回源HTTP要求標頭。

阿里雲DCDN預設支援攜帶以下HTTP要求標頭回源，您無需額外配置。

回源HTTP Header	說明	樣本
Ali-Cdn-Real-Port	用戶端與DCDN節點建連時使用的真實連接埠。	Ali-Cdn-Real-Port:80
Ali-Cdn-Real-Ip	用戶端與DCDN節點建連時使用的真實IP。	Ali-Cdn-Real-Ip:192.168.0.1
X-Forwarded-For	用戶端請求經過DCDN節點回源的整個鏈路上，包括用戶端和CDN節點的IP資訊。	X-Forwarded-For:192.168.0.1, 172.16.0.1
X-Client-Scheme	用戶端發送到DCDN節點的應用程式層請求使用的協議，例如：HTTP、HTTPS。	X-Client-Scheme:http
Host	用戶端請求在回源時實際訪問的來源站點Web網站網域名稱。	Host:example.com
Via	用戶端請求經過的所有DCDN節點的名稱。	Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

回源HTTP要求標頭的值如果配置的是某個變數，那麼實際使用的時候會被設定為具體的變數值，以下為可以使用的變數。

回源HTTP Header	說明
$http_Ali_Cdn_Real_Port	在回源頭裡面添加用戶端真實連接埠資訊，向來源站點傳遞用戶端連接埠資訊。
$http_Ali_Cdn_Real_Ip	在回源頭裡面添加用戶端真實IP資訊，向來源站點傳遞用戶端IP地址資訊。
$proxy_add_x_forwarded_for	在回源頭裡面添加X-Forwarded-For資訊，向來源站點傳遞用戶端IP和中間的Proxy 伺服器IP。

配置回源HTTP要求標頭資訊。

重要

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

增加要求標頭參數

配置項	樣本	說明
要求標頭操作	增加	在回源HTTP請求中增加指定的要求標頭參數。
自訂要求標頭參數	自訂回源要求標頭	選擇自訂要求標頭或選擇已經預設好的要求標頭參數。
自訂要求標頭名稱	x-code	自訂要求標頭名稱為x-code。
要求標頭值	key1	一個要求標頭參數中可以配置多個值，多個值用英文逗號（,）分隔。
要求標頭值	key1, key2	一個要求標頭參數中可以配置多個值，多個值用英文逗號（,）分隔。
是否允許重複	允許	允許：可以添加重複的要求標頭參數。例如`x-code:key1`，`x-code:key2`。不允許：添加同一個要求標頭參數，新值將覆蓋舊值。例如先添加`x-code:key1`，再添加`x-code:key2`，最終的值為`x-code:key2`。

刪除要求標頭參數

配置項	樣本	說明
要求標頭操作	刪除	刪除所有與要求標頭參數名稱匹配的參數值，無論是否有重複的要求標頭參數。
自訂要求標頭參數	自訂回源要求標頭	選擇自訂要求標頭或選擇已經預設好的要求標頭參數。
自訂要求標頭名稱	x-code	自訂要求標頭名稱為x-code。

變更要求標頭參數

配置項	樣本	說明
要求標頭操作	變更	當要求標頭參數不存在重複時，可以正常變更參數，有多個重複要求標頭參數的情況下，不允許進行變更操作。
自訂要求標頭參數	自訂回源要求標頭	選擇自訂要求標頭或選擇已經預設好的要求標頭參數。
自訂要求標頭名稱	x-code	自訂要求標頭名稱為x-code。
要求標頭變更為	key1, key3	一個要求標頭參數中可以配置多個值，多個值用英文逗號（,）分隔。

替換要求標頭參數

配置項	樣本	說明
要求標頭操作	替換	當要求標頭參數不存在重複時，可以正常替換參數，有多個重複要求標頭參數的情況下，不允許進行替換操作。
自訂要求標頭參數	自訂回源要求標頭	選擇自訂要求標頭或選擇已經預設好的要求標頭參數。
自訂要求標頭名稱	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`。