You need to enable JavaScript to run this app.
视频点播

视频点播

复制全文
回源配置
配置 HTTP 请求头
复制全文
配置 HTTP 请求头

视频点播支持在域名管理中配置 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

操作步骤

  1. 登录火山引擎视频点播控制台,进入空间。
  2. 选择左侧导航栏分发加速设置 > 域名管理,进入域名管理页面。
  3. 选择自定义源站加速域名页签,单击操作列的配置按钮。
  4. 进入自定义源站加速域名配置页面,选择回源配置页签。
  5. 单击页面下方的修改配置按钮,在 HTTP 请求头配置下方,单击添加规则按钮,根据表头,完成请求头配置。详细请参见下方的配置说明
  6. 完成配置后,单击保存配置按钮。
    Image

配置说明

配置

说明

回源请求头 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

最近更新时间:2025.05.21 19:21:11
这个页面对您有帮助吗?
有用
有用
无用
无用