You need to enable JavaScript to run this app.
文档中心
文档备案控制台
视频点播

视频点播

请输入
  • 文档首页
    • 视频点播用户指南CDN 分发加速域名配置回源配置配置 HTTP 请求头
复制全文
下载 pdf
我的收藏
回源配置
配置 HTTP 请求头
复制全文
下载 pdf
我的收藏
配置 HTTP 请求头

视频点播支持在域名管理中配置 HTTP 请求头，本文为您介绍配置 HTTP 请求头的功能、操作步骤及配置说明等内容。

适用范围

HTTP 请求头配置适用于自定义源站加速域名。

功能介绍

在回源请求中，CDN 会包含用户请求中的所有请求头。同时，CDN 还会添加一些默认请求头。参见CDN 添加的默认请求头。
除了 CDN 添加的默认请求头，如果您希望回源请求中包含更多的头部，您可以配置回源 HTTP 请求头。

适用场景

识别来自 CDN 的请求

您的源站除了收到来自 CDN 的请求，也有可能收到来自其他请求方的请求。或者您的源站使用了多个云厂商的 CDN 做内容传输加速。在这些情况下，您可以在回源请求中添加一个特定的请求头。在源站的请求日志中，您可以基于该请求头统计以下数据：

  • 请求方不是 CDN 的请求数量。
  • 在多个云厂商中，来自火山引擎 CDN 的请求数量。

区分来自不同加速域名的请求

在 CDN 中，您为多个加速域名配置了相同的源站。这些加速域名有不同的配置，针对不同的使用场景。在这个情况下，您可以在回源请求中添加一个特定的请求头，以区分来自不同加速域名的请求。在源站的请求日志中，您可以基于该请求头统计数据。

在源站实施访问控制

您希望阻止来源不是 CDN 的用户请求。在这个情况下，您可以在回源请求中添加一个特定的请求头，然后在源站实施访问控制，阻止不包含该请求头的请求访问您的源站

操作步骤

  1. 登录视频点播控制台，进入空间。
  2. 选择左侧导航栏分发加速 > 域名管理，进入域名管理页面。
  3. 根据您的域名类型，在域名列表中找到您需要配置的域名，单击操作列的配置按钮。
  4. 进入加速域名配置页面，切换回源配置页签。
  5. 单击页面下方的修改配置按钮，在 HTTP 请求头配置下方，单击新增按钮，根据表头，完成请求头配置。详细请参见下方的配置说明。
  6. 完成配置后，单击保存配置按钮。
    Image

配置说明

配置

说明

配置类型

表示一个操作类型。该配置有以下选项：

  • 设置：表示设置一个头部。设置操作包括添加与修改。如果源站响应中已包含该头部，该头部的值会被覆盖。如果源站响应中没有包含该头部，该头部会被添加。
  • 删除：表示删除一个头部。

头部名称

表示需要设置或者删除的一个头部。头部名称是大小写不敏感的。除了注意事项中列出的那些头部名称之外，您可以输入任意一个头部名称。头部名称不能超过 1,024 个字符，不能包含以下字符：

  • 汉字、空格、双引号（"）、冒号（:）

取值方式

对于您在 头部名称 中指定头部，该配置表示该头部值的类型，有以下选项：

  • 常量：表示该头部值为一个字符串。
  • 变量：表示该头部值来自一个变量。
  • 自定义：表示该头部值是变量与字符串拼接后的一个字符串。

头部取值

表示您在 头部名称 中指定头部的取值。

  • 如果 取值方式 是 常量，您需要输入一个字符串。该字符串的长度不能超过 1,024 个字符，不能包含以下字符：
    • 汉字、美元符号（$）
  • 如果 取值方式 是 变量，您需要从列表中选择一个变量。参见变量列表。
  • 如果 取值方式 是 自定义，您需要输入由变量和字符串拼接后的一个字符串。变量需要包裹在 {} 中，由 $ 开头。例如 bind${scheme}to${client_ip}done。

注意事项

您设置的请求头名称不能以 x-bdcdn-、Volc-Cdn 或 X-Bytecdn- 开头，也不能是以下任意头部。

  • x-tos-request-id
  • bd-bdcdn-oss-switch
  • x-storagegw-request-id
  • x-sign
  • X-Trace-Via

注意

如果用户请求中包含以 x-bdcdn-、Volc-Cdn 或 X-Bytecdn- 开头的头部，这些头部不会包含在回源请求中。

变量列表

系统提供了以下变量字段。

说明

如果您配置了配置回源 URL 改写，除了 msec 和 origin_srv_addr，这些变量的值是改写前的值。例如，您的加速域名是 example.com。您在 "回源 URL 改写" 中配置将回源 Host 修改为 img.example.com。在这个情况下，http_host 变量的值依然是 example.com。

字段名

说明

示例值

uri

表示请求的 URI。如果 URI 本身包含参数，则删除问号（?）以及问号后面的参数。

/dir/volcano.php

request_uri

表示请求的 URI。如果 URI 本身包含参数，则保留问号（?）以及问号后面的参数。

/dir/volcano.php?color=red&n=10

host

表示回源请求中 Host 头部的值。
需要留意的是，CDN 在处理请求时可能会修改该头部的值。因此，不建议您使用该头部，而是使用 http_host。

example.com:8080

http_host

表示回源请求头中的 host 字段的值。

volcengine.com:8080

args

表示请求 URI 的参数部分，但是不包含参数前的问号（?）。

color=red&n=10

msec

表示缓存节点发送回源请求的时间。格式是十进制的 Unix 时间戳。

1650558396

scheme

表示缓存节点发送回源请求时使用的协议。

https

origin_srv_addr

表示源站的域名或者 IP 地址。

www.example.com

query_string

与 args 变量的含义相同。

size=small&color=red

client_ip

表示连接到 CDN，触发了本次回源请求的客户端的 IP 地址。

127.1.1.1

client_loc_country

表示客户端 IP 所属的国家或地区的英文名称。

China

client_loc_upper_cy_code

表示客户端 IP 所属的国家或地区的双字母代码。

CN

CDN 添加的默认请求头

CDN 在回源请求中默认会添加以下头部。

请求头

描述

示例

X-Forwarded-For

表示一个 IP 地址列表，用于识别通过代理服务器转发的用户请求。列表中的第一个 IP 地址是发起请求的客户端的 IP 地址。该请求每经过一个代理服务器，这个代理服务器的 IP 地址就会被添加到列表末尾。列表中最后一个 IP 地址是发送该回源请求的 CDN 节点的 IP 地址。

xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxx, xx.xx.xxx.xxx

X-Forwarded-Protocol

表示用户请求使用的协议。

http

X-Real-IP

对于触发该回源请求的用户请求，该头部表示发送该用户请求的客户端 IP 地址。

xxx.xxx.xxx.x

X-Forwarded-Proto

表示用户请求使用的协议。

http

X-Client-Scheme

表示用户请求使用的协议。

http

X-Trace-via

表示发送回源请求的 CDN 节点的标识。

gycm

Bd-Raw-Host

表示用户请求的 URL 中的域名。

www.example.com

X-Bdcache-Trace-Id

表示用户请求的 ID，由 CDN 生成。

f455f0415d901f8aee3b2c7336bfad16

X-Tt-Trace-Id

表示回源请求的 ID，由 CDN 生成。

202405301714110101720050051BB69184

说明

X-Forwarded-Protocol、X-Forwarded-Proto、X-Client-Scheme 这三个头部的含义相同。如果您不希望回源请求中包含这些头部，可以配置 "回源 HTTP 请求头设置" 删除这些头部。

最近更新时间：2026.05.13 17:44:46
这个页面对您有帮助吗？
有用
有用
无用
无用