功能介绍
腾讯云 CDN 默认支持携带一些头部回源,也支持自定义配置回源 HTTP 请求头部,供您统计和分析源站业务状况。
注意
腾讯云 CDN 默认支持携带 X-Forwarded-For(真实客户端 IP)和 X-Forwarded-Proto(真实客户端请求协议),您无需再配置。
若您已对全部文件配置增加头部 X-Forward-For,建议您删除该规则,使用默认的标准头部 X-Forwarded-For 即可 (请注意此处头部参数的名称变化)。
2021年12月6日后创建的域名,会默认配置头部 Tencent-Acceleration-Domain-Name(加速域名),您可在配置处修改删除。
如果您的回源链路中包含有 CLB 负载均衡产品或其他 Nginx 代理,请注意避免配置使用 X-Real-IP 请求头。详情参考:回源链路包含 CLB 负载均衡时,回源 HTTP 请求头如何配置?
操作指南
查看配置
操作类型
操作类型 | 说明 |
设置 | 变更指定请求头部参数的取值为设置后的值。 若设置的头部不存在,则会增加该头部。 若回源同名的头部已存在,则会覆盖原有的值。 |
增加 | 增加指定的回源请求头部参数。 若设置的同名的头部已存在,则会追加新的值。 |
删除 | 删除指定的请求头参数。 |
注意
底部优先级大于顶部 - 此相对位置的优先级仅限于同类型头部操作中,例如多条增加头部规则之间、多条删除头部规则之间或多条设置头部规则之间。
当不同的头部操作类型同时作用于同一个回源请求头参数的时候,按照操作类型的优先级来执行,顺序为:增加 > 删除 > 设置。例如:同时存在增加、删除和设置X-CDN头部的规则时,会先增加,再删除,最后再设置。
头部参数
头部参数 | 说明 |
X-Forward-Port | 用于携带用户端真实端口的头部。其值默认为 $remote_port 变量,不允许修改。 |
Tencent-Acceleration-Domain-Name | 用于携带用户加速域名的头部,其值为 $host 变量。 |
自定义头部 | 自定义头部的Key 值长度默认为1 - 100个字符,由数字0 - 9、字符a - z、A - Z,及特殊符 - 组成。Value 长度为1 - 2000个字符,不支持中文。 若头部取值为变量,当前仅支持配置 $remote_port 、 $client_ip 。 |
注意
回源 HTTP 请求头配置规则最多可配置10条。
生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式,暂不支持正则匹配。
配置示例
若加速域名
cloud.tencent.com
的回源 HTTP 请求头配置如下:
若访问资源为:http://cloud.tencent.com/test/test.mp4
命中
mp4
文件后缀及 /test
目录,因是同一头部操作类型 - 增加,则底部优先级大于顶部,因此增加 x-cdn:Tencent
头部。注意事项
以下标准头部暂时不支持设置/增加/删除回源 HTTP 请求头:
www-authenticate | authorization | proxy-authenticate | proxy-authorization |
age | cache-control | clear-site-data | expires |
pragma | warning | accept-ch | accept-ch-lifetime |
early-data | content-dpr | dpr | device-memory |
save-data | viewport-width | width | last-modified |
etag | if-match | if-none-match | if-modified-since |
if-unmodified-since | vary | connection | keep-alive |
accept | accept-charset | expect | max-forwards |
access-control-allow-origin | access-control-max-age | access-control-allow-headers | access-control-allow-methods |
access-control-expose-headers | access-control-allow-credentials | access-control-request-headers | access-control-request-method |
origin | timing-allow-origin | dnt | tk |
content-disposition | content-length | content-type | content-encoding |
content-language | content-location | forwarded | x-forwarded-host |
x-forwarded-proto | via | from | host |
referer-policy | allow | server | accept-ranges |
range | if-range | content-range | cross-origin-embedder-policy |
cross-origin-opener-policy | cross-origin-resource-policy | content-security-policy | content-security-policy-report-only |
expect-ct | feature-policy | strict-transport-security | upgrade-insecure-requests |
x-content-type-options | x-download-options | x-frame-options(xfo) | x-permitted-cross-domain-policies |
x-powered-by | x-xss-protection | public-key-pins | public-key-pins-report-only |
sec-fetch-site | sec-fetch-mode | sec-fetch-user | sec-fetch-dest |
last-event-id | nel | ping-from | ping-to |
report-to | transfer-encoding | te | trailer |
sec-websocket-key | sec-websocket-extensions | sec-websocket-accept | sec-websocket-protocol |
sec-websocket-version | accept-push-policy | accept-signature | alt-svc |
date | large-allocation | link | push-policy |
retry-after | signature | signed-headers | server-timing |
service-worker-allowed | sourcemap | upgrade | x-dns-prefetch-control |
x-firefox-spdy | x-pingback | x-requested-with | x-robots-tag |
x-ua-compatible | max-age | | |