tencent cloud

内容分发网络 CDN

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
应用场景
基本概念
使用限制
CDN性能说明(抽样)
购买指南
CDN 购买指南
ECDN 购买指南
快速入门
从零开始配置 CDN
接入域名
配置 CNAME
域名归属权验证
域名接入常见问题
配置指南
域名管理
域名配置
统计分析
刷新预热
日志服务
安全加速
服务查询
离线缓存
权限管理
权限配置
控制台权限说明
子账号或协作者开通实时日志的方法
场景教学
CDN 加速 COS 资源
实践教程
CDN 迁移至 EdgeOne 工具使用指南
CDN - CVM
CDN - COS
DNSPod 一键配置 CNAME
CDN日志定时存储
API 文档
History
Introduction
API Category
Content Management APIs
Real-time Log APIs
Service Query APIs
Data Query APIs
Making API Requests
Log Query APIs
StopCdnDomain
Configuration Management APIs
Obsoleted APIs
Other APIs
Data Types
Error Codes
常见问题
功能特性问题
计费相关问题
域名接入问题
缓存配置问题
刷新预热问题
统计分析问题
HTTPS 相关问题
访问相关问题
故障相关问题
故障处理
状态码说明及处理建议
不同节点缓存内容不一致
接入 CDN 后,网页访问速度慢
流量命中率偏低
CDN 域名突然出现404状态
页面展示异常-访问跨域报错
资源缓存未生效
CDN Service Level Agreement
词汇表

回源 Request Header 配置

PDF
聚焦模式
字号
最后更新时间: 2023-09-06 18:09:52

配置场景

腾讯云 CDN 支持增加回源请求头部:
支持通过 X-Forwarded-For 头部携带真实客户端 IP 至源站。
支持通过 X-Forward-Port 头部携带真实客户端端口至源站,用于源站侧分析。
支持添加各类自定义头部。
也支持设置和删除自定义回源请求头部。

配置指南

查看配置

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



操作类型

操作类型
说明
设置
变更指定请求头部参数的取值为设置后的值。
若设置的头部不存在,则会增加该头部。
若回源请求头部参数已存在,则设置的请求头会覆盖原有头部且唯一。
增加
增加指定的回源请求头部参数。
若设置的头部已存在,则增加的请求头会覆盖原有头部且唯一。
删除
删除指定的响应头参数。
注意:
底部优先级大于顶部 - 此相对位置的优先级仅限于同类型头部操作中,例如多条增加头部规则之间、多条删除头部规则之间或多条设置头部规则之间。
当不同的头部操作类型同时作用于同一个回源请求头参数的时候,按照操作类型的优先级来执行,顺序为:增加 > 删除 > 设置。例如:同时存在增加、删除和设置X-CDN头部的规则时,会先增加,再删除,最后再设置。

头部参数

头部参数
说明
X-Forwarded-For
用于携带用户端真实 IP 的头部。其值默认为 $client_ip 变量,不允许修改。
X-Forward-Port
用于携带用户端真实端口的头部。其值默认为 $remote_port 变量,不允许修改。
自定义头部
自定义头部的Key 值长度默认为1 - 100个字符,由数字0 - 9、字符a - z、A - Z,及特殊符 - 组成。
Value 长度为1 - 1000个字符,不支持中文。
部分标准头部不支持自助设置/增加/删除,具体清单请参见文档 注意事项
注意:
回源 Request Header 配置规则最多可配置10条。
生效类型支持全部文件、文件类型、文件目录、指定文件路径四种模式,暂不支持正则匹配。

配置示例

若加速域名 cloud.tencent.com 的回源 Request Header 配置如下:
img

若访问资源为:http://cloud.tencent.com/test/test.mp4
1. 命中 * 规则,增加头部 X-Forwarded-For:$client_ip 头部,回源时将 $client_ip 替换为真实客户端 IP。
2. 命中 .mp4 文件类型及/test路径,因是同一头部操作类型 - 增加,则底部优先级大于顶部,因此增加 x-cdn:Tencent 头部。


注意事项

以下标准头部暂时不支持设置/增加/删除回源 Request Header:
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



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈