2.3 回源配置
2.3.7 回源请求头
如果您需要修改用户回源请求URL中的头部信息，可以通过配置回源请求头参数来实 现。本章帮您了解回源请求头的配置方法。
背景信息
当用户请求的内容CDN节点无缓存时，CDN会回源请求资源。如果您想要改写用户回 源请求URL的头部信息，可以在CDN控制台完成相关配置。
HTTP消息头，是指在超文本传输协议（Hypertext Transfer Protocol，HTTP）的请求 和响应消息中的消息头部分，定义了HTTP传输过程中的具体参数。
注意事项
● 回源请求头配置只会影响通过CDN回源的HTTP消息，对于CDN节点直接响应给用 户的HTTP消息不做修改。
● 同一个请求头不允许同时存在两个不同的取值。
操作步骤
1. 登录华为云控制台，在控制台首页中选择“CDN与智能边缘 > CDN”，进入CDN 控制台。
2. 在左侧菜单栏中，选择“域名管理”。
3. 在域名列表中，单击需要修改的域名或域名所在行的“设置”，进入域名配置页 面。
4. 选择“回源配置”页签。
5. 在回源请求头配置模块，单击“添加”按钮。
6. 配置回源请求头信息
– 添加：在CDN侧添加回源请求头参数，用来改写用户请求URL中的头部信 息。
配置项 示例 说明
请求头操作 设置 在回源HTTP请求中增加指定的请求头参数。
● 如果用户请求URL中携带X-test参数，取值 111。CDN侧设置的X-test取值为aaa，那么回 源时X-test的取值为aaa。
● 如果用户请求URL中没有携带X-test参数，那么 回源时增加X-test，取值为aaa。
删除 删除用户请求URL中已经存在的头部信息。
● 如果用户请求URL中携带X-test参数，回源时会 删除该参数。
请求头参数 X-test ● 长度1～64。
● 由数字0 - 9、字符a - z、A - Z，及特殊符“-”
组成。
请求头取值 aaa ● 长度为1～512。
● 由数字0 - 9、字符a - z、A - Z，及特殊符"*"、
“.”、“-”、“_”组成。
● 不支持变量配置，如：$client_ip，
$remote_port等。
– 编辑：修改当前回源请求头取值或操作
单击编辑按钮，弹框如下：
配置项 示例 说明
请求头操作 设置 在回源HTTP请求中增加指定的请求头参数。
● 如果用户请求URL中携带X-test参数，取值 111。CDN侧设置的X-test取值为aaa，那么回 源时X-test的取值为aaa。
● 如果用户请求URL中没有携带X-test参数，那么 回源时增加X-test，取值为aaa。
删除 删除用户请求URL中已经存在的头部信息。
● 如果用户请求URL中携带X-test参数，回源时会 删除该参数。
请求头参数 X-test 此处无法修改。
请求头取值 aaa ● 长度为1～512。
● 由数字0 - 9、字符a - z、A - Z，及特殊符"*"、
“.”、“-”、“_”组成。
● 不支持变量配置，如：$client_ip,$remote_port 等。
7. 单击确定，完成配置。
说明
如果您的域名服务范围为全球或中国大陆境外时，用户请求头“Accept-Encoding”如果包 含多个值，CDN回源时仅透传“Gzip”。
配置示例
加速域名“www.example.com”的回源请求头设置如下：
当用户访问“http://www.example.com/abc.jpg”文件时，CDN节点没有缓存该资 源，CDN回源请求资源。回源时增加“X-cdn头部”，同时删除“X-test头部”。
使用限制
● 如果您的后台存在特殊配置，暂不支持配置Content-Type、Cache-Control、
Expires、Content-Language、Content-Disposition。
● 目前不支持改写以下标准头部信息：
Origin accept-ch clear-site-data push-policy WsTag Tcp-Retrans
access-control-allow-methods access-control-max-age vary Date X-Forward-Type width Age ETag Purge-Extra X-Cacheable
access-control-allow-headers Front-End-Https ping-to content-range
cross-origin-opener-policy Location viewport-width Mime-Version Proxy-Support X-Resp-Time If-Range sec-fetch-dest device-memory X-Mem-Url Cdn-Src-Ip ping-from Allow
X-Url-Blackwhite-List early-data Sec-WebSocket-Extensions
if-unmodified-since X-Forward-Uri Conf-File x-download-options X-Error-Status Negotiate
x-permitted-cross-domain-policies service-worker-allowed
X-Appa x-firefox-spdy content-dpr X-Miss-Times-Limit
X-Bwctrl-Limit X-Bwctrl-Para X-Max-Conns nel
Origin accept-ch clear-site-data push-policy
public-key-pins-report-only X-MAA-Alias
Sec-WebSocket-Location X-Cache-2 Authorization Expect last-event-id
Sec-WebSocket-Key
X-Refresh-Pattern forwarded X-Local-Ip Sec-WebSocket-Protocol
feature-policy
cross-origin-resource-policy Request-Range Conf-Other
strict-transport-security signed-headers Cdn-Server-Ip Sec-WebSocket-Version
accept X-Black-List content-location sourcemap
Partition-Block-Size
Proxy- Authentication-Info
cross-origin-embedder-policy X-Request-Id
x-dns-prefetch-control if-none-match If-Non-Match Public
X-White-List x-ua-compatible Keep-Alive Transfer-Encoding alt-svc max-age Last-Modified x-xss-protection
Sec-WebSocket-Nonce dnt Link x-robots-tag Key expect-ct sec-fetch-site
access-control-request-headers X-Error-URL X-Log-Url content-encoding X-Times-Limit X-Appa-Origin X-Miss-Rate-Limit X-IP-Region Dynamic X-Squid-Error From accept-ch-lifetime X-MAA-Auth Connection X-Via-CDN Max-Forwards Upgrade sec-fetch-user
content-security-policy-report-only Pragma save-data X-Client-Ip Cdn-Qos x-powered-by
X-Forward-Measured
accept-push-policy server large-allocation X-Request-Uri X-Forward-Ip Host
Proxy-Authenticate X-Request-Url X-Cache-Lookup Conf-Option X-Forward-Host
upgrade-insecure-requests
Origin accept-ch clear-site-data push-policy X-Accelerator-Vary signature
X-Ip-Blackwhite-List X-Cdn-Src-Port
Sec-WebSocket-Draft
Sec-WebSocket-Origin X-IP-Region-CN public-key-pins Ws-Hdr If-Match
Proxy-Authorization X-Rate-Limit sec-fetch-mode trailer X-Rewrite-Url Via
X-Cache X-Mgr-Traffic accept-signature Warning x-forwarded-proto If-Modified-Since
Authentication-Info access-control-request-method Content-Length
x-frame-options(xfo) Range A_Dynamic te x-forwarded-host Title
WWW-Authenticate tk X-Query-Key accept-charset
access-control-allow-origin accept-ranges report-to
access-control-expose-headers x-content-type-options
Proxy-Connection server-timing Retry-After x-requested-with X-No-Referer X-Forward-Peer
Sec-WebSocket-Accept X-Forwarded-For Conf-Err-Host
Sec-WebSocket-Key2
access-control-allow-credentials X-Denyattack-Dynconf referer-policy
Sec-WebSocket-Key1
content-security-policy timing-allow-origin
X-DNS-Time Conf-File-List X-expireURL x-pingback
Purge-Domain dpr -