You need to enable JavaScript to run this app.
导航

配置 HTTP 请求头

最近更新时间2023.03.08 14:23:14

首次发布时间2023.03.08 14:23:14

视频点播支持在域名管理中配置 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. 完成配置后,单击保存配置按钮。

配置说明

配置说明

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