主题
配置回源 HTTP 请求头
操作说明
在内容分发网络中,您可以对请求头进行以下操作:
设置请求头字段 :如果您需要在回源请求头中添加字段,可以通过该操作进行配置。如果在匹配时发现请求头中已存在该字段,已有的字段值会被覆盖。匹配时不区分大小写。比如您添加了字段
X-Form:huoshan
,但是请求头中已存在字段x-form:hs
。此时,请求头中该字段会更新为x-form:huoshan
。删除请求头字段:如果您不需要回源请求头中某些字段,可以通过该操作进行配置。内容分发网络会在回源请求的请求头中删除这些字段。
在您设置字段时,可以输入任意字段。但是内容分发网络不支持设置某些字段,具体参见下方注意事项。
配置说明
配置 | 说明 |
---|---|
回源请求头部操作 | 设置具体的操作。您可以设置以下值: |
设置:表示添加字段或者对已有字段设置特定值。
删除:表示删除特定字段。 | | 回源请求头部名称 | 输入一个请求头字段。您可以设置任意的名称,例如
X-Form
。字段名称不能超过 1,024 个字符,可以包含除了以下字符的可打印 ASCII 字符:下划线(_)、空格、双引号(")、Delete(ASCII code 127) | | 取值方式 | 设置请求头字段的取值方式。您可以设置以下值:
常量:表示请求头字段的值是一个固定值。您需要在 回源请求头部取值 中设置这个值。
变量:表示请求头字段的值来自一个变量字段。您需要在 回源请求头部取值 列表中选择一个变量字段。该变量字段的值会作为请求头字段的值。参见下方的变量字段。
自定义:表示请求头字段的值是变量字段与常量字符串拼接后的字符串。在拼接字符串中,变量字段使用
${变量名}
表示。 为了方便您输入变量字段,您可以先输入$
。此时,输入框上方会出现一个变量字段列表。在列表中,您可以选择一个或者多个变量字段,点击 确定,然后再插入常量字符串。
示例值:aaa${http_host}bbb${msec}ccc
| | 回源请求头部取值 | 设置该请求头字段的值。字段值不能超过 1,024 个字符,可以包含除了以下字符的可打印 ASCII 字符:美元符号($),Delete(ASCII code 127) | | 操作 | 表示可以对该规则进行的操作。比如删除该规则。 |
变量字段
内容分发网络提供了以下变量字段。需要留意的是,如果加速域名的配置改写了回源请求,这些变量的值依然是改写前的值(不适用 msec
和 origin_srv_addr
这两个变量)。例如您的加速域名是 example.com
,回源 Host 配置为 img.example.com
,那么 http_host
变量的值依然是 example.com
。
字段名 | 说明 | 示例值 |
---|---|---|
uri | 表示回源请求 URL 中的路径。 | /dir/volcano.php |
request_uri | 表示回源请求 URL 中的路径和查询字符串(query string)。 | /dir/volcano.php?color=red&n=10 |
http_host | 表示回源请求中 Host 头部的值。 | volcengine.com:8080 |
args | 表示回源请求 URL 中的查询字符串。 | color=red&n=10 |
msec | 表示内容分发网络设置该回源请求头的时间,格式是 Unix 时间戳,精确到毫秒。 | 1704444754.917 |
scheme | 表示回源请求使用的协议。 | https |
origin_srv_addr | 表示源站的域名或者 IP 地址。 | www.example.com |
query_string | 表示回源请求 URL 中的查询字符串。 | ?size=small&color=red |
host | 表示回源请求中 Host 头部的值。 |
需要留意的是,内容分发网络在处理请求时可能会修改该字段的值。因此,不建议您使用该字段,而是使用 http_host
。 | example.com:8080
| | client_ip | 表示连接到内容分发网络,触发了本次回源请求的客户端的真实 IP 地址。 | 127.1.1.1
|
注意事项
在您设置字段时,不能使用以 x-bdcdn-
开头的字段,也不能使用以下字段,不然会报错。字段名称不区分大小写。
x-bdcache-trace-id
x-real-ip
x-client-scheme
x-tos-request-id
bd-bdcdn-oss-switch
x-storagegw-request-id
x-sign
如果您输入了这些字段名中的任意一个,会收到以下错误:暂不支持配置此类头部!