视频点播支持在域名管理中配置 HTTP 请求头,本文为您介绍配置 HTTP 请求头的功能、操作步骤及配置说明等内容。
适用范围
HTTP 请求头配置适用于自定义源站加速域名。
功能介绍
如果您希望在回源时,回源请求中包含自定义请求头字段,那么您可以配置 HTTP 请求头,实现某些功能。比如通过添加 X-Form
字段,实现在回源请求中包含回源的 CDN 厂商。
在视频点播中,您可以对请求头进行以下操作:
- 设置请求头字段:如果您需要在回源请求头中添加字段,可以通过该操作进行配置。如果在匹配时发现请求头中已存在该字段,已有的字段值会被覆盖。匹配时不区分大小写。比如您添加了字段
X-Form:huoshan
,但是请求头中已存在字段 x-form:hs
。此时,请求头中该字段会更新为 x-form:huoshan
。 - 删除请求头字段:如果您不需要回源请求头中某些字段,可以通过该操作进行配置。在缓存节点回源时,请求头中就会删除这些字段。
注意事项
- 当回源请求 Header 操作为设置时,如果本次请求本身的回源请求 Header 没有用户设置的 Header 时,此时为添加请求 Header。
- 当回源请求 Header 操作为设置时,如果本次请求本身的回源请求 Header 已有用户设置的 Header 时,此时为编辑请求 Header。
- 字段名称不区分大小写。
- 在您设置字段时,不能使用以
x-bdcdn-
开头的字段,也不能使用以下字段,不然会报错。如果您输入了这些字段名中的任意一个,会收到以下错误:暂不支持配置此类头部!
- x-forwarded-for
- x-bdcache-trace-id
- x-real-ip
- x-client-scheme
- x-tos-request-id
- bd-bdcdn-oss-switch
- x-storagegw-request-id
- x-sign
操作步骤
- 登录火山引擎视频点播控制台,进入空间。
- 选择左侧导航栏分发加速设置 > 域名管理,进入域名管理页面。
- 选择自定义源站加速域名页签,单击操作列的配置按钮。
- 进入自定义源站加速域名配置页面,选择回源配置页签。
- 单击页面下方的修改配置按钮,在 HTTP 请求头配置下方,单击添加规则按钮,根据表头,完成请求头配置。详细请参见下方的配置说明。
- 完成配置后,单击保存配置按钮。

配置说明
配置 | 说明 |
---|
回源请求头 Header 操作 | 设置具体的操作。您可以设置以下值: - 设置:表示添加字段或者对已有字段设置特定值。
- 删除:表示删除特定字段。
|
回源请求头 Header 名称 | 输入一个请求头字段。您可以设置任意的名称,例如 X-Form 。字段名称不能超过 1,024 个字符,设置回源请求头部名称的规则如下所示。 - 名称不能为空。
- 名称不能包含中文,下划线(_)、空格、双引号(")。
- 名称不能是以下名称: x-forwarded-for, x-bdcache-trace-id, x-real-ip, x-client-scheme, x-tos-request-id, bd-bdcdn-oss-switch,x-storagegw-request-id,x-sign。
- 名称不能以 x-bdcdn- 开头。
|
取值方式 | 设置请求头字段的取值方式。您可以设置以下值: - 常量:表示请求头字段的值是一个固定值。您需要在回源请求头部取值中设置这个值。
- 变量:表示请求头字段的值是一个变量。您需要在回源请求头部取值列表中选择一个变量字段。
|
回源请求头部取值 | - 当取值方式为常量时,设置该请求头字段的值。字段值不能超过 1,024 个字符。设置的规则如下所示。
- Header 值不能为空
- Header值不能包含中文、美元符号($)
- 当取值方式为变量时,支持选择该请求头字段的值。支持的回源请求头部取值详情请参见下方变量字段。
|
操作 | 表示可以对该规则进行的操作。比如删除该规则。 |
变量字段
系统提供了以下变量字段。
字段名 | 说明 | 示例值 |
---|
uri | 表示请求的 URI。如果 URI 本身包含参数,则会删除问号(?)以及问号后面的参数。 | /dir/volcano.php
|
request_uri | 表示请求的 URI。如果 URI 本身包含参数,则保留问号(?)以及问号后面的参数。 | /dir/volcano.php?color=red&n=10
|
http_host | 表示请求头中的 host 字段的值。 | volcengine.com:8080
|
args | 表示请求 URI 的参数部分,但是不包含参数前的问号(?)。 | color=red&n=10
|
msec | 表示缓存节点发送回源请求的时间。格式是十进制的 Unix 时间戳。 | 1650558396
|
scheme | 表示缓存节点发送回源请求时使用的协议。 | https
|