配置指南

API 文档

回源 HTTP 请求头配置

最近更新时间:2021-05-14 15:05:11

配置场景

腾讯云 CDN 支持增加回源请求头部:

  • 支持通过 X-Forward-For 头部携带真实客户端 IP 至源站。
  • 支持通过 X-Forward-Port 头部携带真实客户端端口至源站,用于源站侧分析。
  • 支持添加各类自定义头部。

也支持设置和删除自定义回源请求头部。

配置指南

查看配置

登录 CDN 控制台,在菜单栏里选择【域名管理】,单击域名右侧【管理】,即可在【回源配置】中看到回源 HTTP 请求头配置,默认情况下为关闭状态,无任何配置:

操作类型

操作类型 说明
设置 变更指定请求头部参数的取值为设置后的值。
若设置的头部不存在,则会增加该头部。
若回源请求头部参数已存在,则设置的请求头会覆盖原有头部且唯一。
增加 增加指定的回源请求头部参数。
若设置的头部已存在,则增加的请求头会覆盖原有头部且唯一。
删除 删除指定的请求头参数。
注意:

  • 底部优先级大于顶部 - 此相对位置的优先级仅限于同类型头部操作中,例如多条增加头部规则之间、多条删除头部规则之间或多条设置头部规则之间。
  • 当不同的头部操作类型同时作用于同一个回源请求头参数的时候,按照操作类型的优先级来执行,顺序为:增加 > 删除 > 设置。例如:同时存在增加、删除和设置X-CDN头部的规则时,会先增加,再删除,最后再设置。

头部参数

头部参数 说明
X-Forward-For 用于携带用户端真实 IP 的头部。其值默认为 $client_ip 变量,不允许修改。
X-Forward-Port 用于携带用户端真实端口的头部。其值默认为 $remote_port 变量,不允许修改。
自定义头部 自定义头部的Key 值长度默认为1 - 100个字符,由数字0 - 9、字符a - z、A - Z,及特殊符 - 组成。
Value 长度为1 - 1000个字符,不支持中文。
部分标准头部不支持自助设置/增加/删除,具体清单请参见文档 注意事项
注意:

  • 回源 HTTP 请求头配置规则最多可配置10条。
  • 生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式,暂不支持正则匹配。

配置示例

若加速域名 cloud.tencent.com 的回源 HTTP 请求头配置如下:

若访问资源为:http://cloud.tencent.com/test/test.mp4

  1. 命中 * 规则,增加头部 X-Forward-For:$client_ip 头部,回源时将 $client_ip 替换为真实客户端 IP。
  2. 命中 .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
目录