视频点播
视频点播
- Documentation
视频点播用户指南CDN 分发加速域名配置高级配置配置 HTTP 响应头
Copy page
Download PDFCopy pageDownload PDF视频点播支持在域名管理中配置 HTTP 响应头。本文为您介绍如何在视频点播中配置 HTTP 响应头字段的功能介绍和操作步骤。
功能介绍
默认情况下，缓存节点在响应用户请求时，会透传源站的响应头。在视频点播中，您可以对响应头进行以下操作，以实现特定的功能。
- 设置响应头字段：如果您需要在缓存节点响应头中添加字段，可以通过该操作进行配置。如果在匹配时发现响应头中已存在该字段，已有的字段值会被覆盖。匹配时不区分大小写。比如您添加了字段
X-Test:123，但是源站响应头中已存在字段x-test:456。此时，缓存节点的响应头中该字段会更新为x-test:123。 - 删除响应头字段：如果您不需要源站响应头中某些字段，可以通过该操作进行配置。在缓存节点响应用户请求时，响应头中就会删除这些字段。
在您设置字段时，可以输入任意字段或者从列表中选择一个常用字段。但是视频点播不支持设置某些字段，具体参见注意事项。
适用范围
HTTP 响应头设置适用于点播加速域名、自定义源站加速域名和封面加速域名。
注意事项
在您设置字段时，不能使用以下字段，不然会报错。字段名称不区分大小写。
- access-check
- server-timing
- via
- x-request-ip
- x-tt-trace-tag
- x-bdcdn-logid
- byte-error-code
- x-bdcdn-cache-status
如果您输入了这些字段名中的任意一个，会收到 暂不支持配置此类头部！ 错误，示意图如下：
操作步骤
登录火山引擎视频点播控制台，进入空间。
选择左侧导航栏分发加速设置 > 域名管理，进入域名管理页面。
选择点播加速域名页签，单击操作列的配置按钮。
进入加速域名配置页面，选择高级配置页签。
单击页面下方的修改配置按钮，在 HTTP 响应头设置下方，根据自身业务需求，单击添加规则按钮，进行规则配置。规则的详细说明如下表示。
tip
您最多可以添加 50 条规则。
参数
说明
响应头部操作
设置具体的操作。您可以设置以下值：
- 设置：表示添加字段或者对已有字段设置特定值。
- 删除：表示删除特定字段。
响应头部名称
设置一个需要添加或者删除的响应头字段。您可以设置任意的名称。系统也提供了常用的字段供您设置。详见常用字段。字段名称不能超过 1,024 个字符，可以包含除了以下字符的可打印 ASCII 字符：
- 中文、下划线（_）、空格、双引号（"），Delete（ASCII code 127）
取值方式
设置响应头字段的取值方式。您可以设置以下值：
- 常量：表示响应头字段的值是一个固定值。您需要在响应头部取值中设置这个值。
- 变量：表示响应头字段的值来自一个变量字段。您需要在响应头部取值列表中选择一个变量字段。该变量字段的值会作为响应头字段的值。参见变量字段。
响应头部取值
设置该响应头字段的值。字段值不能超过 1,024 个字符，可以包含除了以下字符的可打印 ASCII 字符：
- 中文、美元符号（$），Delete（ASCII code 127）
跨域校验
表示在视频点播响应用户请求时，是否校验请求头中的 Origin 字段。您可以启用或者禁用该配置。
tip
该参数可设置，需要满足以下条件：
- 规则中响应头部名称是
Access-Control-Allow-Origin。 - 规则中取值方式是常量。
- 启用：表示视频点播会校验 Origin 字段。如果校验成功，视频点播会在响应头中包含
Access-Control-Allow-Origin字段。字段值与 Origin 字段值相同。如果校验失败，响应头中不会包含Access-Control-Allow-Origin字段。 - 禁用：表示视频点播不会校验 Origin 字段。在响应头中，视频点播将始终包含
Access-Control-Allow-Origin头部和您配置的值。
warning
- 如果您设置
Access-Control-Allow-Origin的值为*。此时，无论跨域校验是否启用，响应头中Access-Control-Allow-Origin字段的值是*。
示例：您的加速域名是 example.com。您在规则中设置 Access-Control-Allow-Origin 是一个常量，取值是
http://example.com,https://www.test.com。此时，一个用户请求访问您的加速域名。- 假设请求头中的 Origin 字段值是
https://www.test.com。- 如果跨域校验是启用，响应头中的
Access-Control-Allow-Origin字段的值是https://www.test.com。 - 如果跨域校验是禁用，响应头中的
Access-Control-Allow-Origin字段的值是http://example.com,https://www.test.com。
在该情况下，用户可以访问您的加速域名。
- 如果跨域校验是启用，响应头中的
- 假设请求头中的 Origin 字段值是
https://www.abc.com。- 如果跨域校验是启用，响应头中不会包含
Access-Control-Allow-Origin字段。原因是域名不匹配。 - 如果跨域校验是禁用，响应头中会包含
Access-Control-Allow-Origin字段。该字段的值是http://example.com,https://www.test.com。
在该情况下，用户无法访问您的加速域名。客户端会显示跨域访问失败的错误消息。
- 如果跨域校验是启用，响应头中不会包含
完成配置后，单击保存配置按钮。
变量字段
系统提供了以下变量字段。这些变量字段默认不会被包含在视频点播的响应中。
tip
以下列表中的这些变量字段是标准的 HTTP 变量，有实际的值以及含义。但是这些变量字段本身默认不会被包含在视频点播的响应中。在您设置一个响应头的名称时，您可以使用列表中任意一个名称不包含下划线（_）的变量字段，然后为该响应头设置一个任意值。也就是说，当您使用任意这些名称不包含下划线的变量字段作为响应头时，其值是可以被覆盖的。
字段名 | 说明 | 示例值 |
|---|---|---|
uri | 表示客户端请求的 URI。如果 URI 本身包含参数，则会删除问号（?）以及问号后面的参数。 |
|
request_uri | 表示客户端请求的 URI。如果 URI 本身包含参数，则保留问号（?）以及问号后面的参数。 |
|
raw_uri | 与 | |
remote_addr | 表示发送请求的客户端 IP 地址。 |
|
remote_port | 表示客户端请求使用的端口号。 |
|
host | 表示客户端请求头中的 host 字段的值。 |
|
http_host | 与 | |
args | 表示客户端请求 URI 的参数部分，但是不包含参数前的问号（?）。 |
|
msec | 表示客户端请求发送的时间。格式是十进制的 Unix 时间戳。 |
|
scheme | 表示客户端请求发送时使用的协议。 |
|
常用字段
您可以从列表中选择常用的字段进行设置。这些常用字段的说明如下：
tip
这些字段是标准的 HTTP 响应头。如果响应头的值是合法的，浏览器会根据响应头做相应处理。您也可以将这些字段作为自定义字段来使用，赋予这些参数任意值。例如，您可能需要设置 Access-Control-Allow-Origin 的值为 helloworld 作为特殊用途。
字段名 | 说明 | 示例值 |
|---|---|---|
Access-Control-Allow-Origin | 指定跨域请求可以访问的站点，支持泛域名。多个站点使用逗号（,）分隔。 |
|
Access-Control-Allow-Methods | 指定跨域请求可以使用的 HTTP 请求方法。多个方法使用逗号（,）分隔。 |
|
Access-Control-Allow-Headers | 指定跨域请求可以包含的 HTTP 请求头。多个请求头使用逗号（,）分隔。 |
|
Access-Control-Expose-Headers | 指定在视频点播的响应中，客户端可以访问哪些响应头。默认情况下，客户端可以访问的响应头有 |
|
Access-Control-Allow-Credentials | 指定跨域请求是否需要包含鉴权信息。鉴权信息包括 cookie，鉴权请求头或客户端 TLS 证书。 |
|
Access-Control-Max-Age | 指定跨域请求时，客户端对请求内容发起的预检请求的缓存时间。单位是秒。在缓存时间内，客户端不用再次发送预检请求。 |
|
Cache-Control | 对于视频点播返回的内容，指定该内容在客户端的缓存方式。 |
|
Content-Disposition | 指示视频点播返回给客户端的内容是以下载的方式提供。并指定下载的文件名。 |
|
Content-Language | 指示视频点播返回给客户端的内容语言。 |
|
Content-Type | 指示视频点播返回给客户端的内容类型。 |
|
Pragma | 对于 HTTP/1.0，指示视频点播返回的内容在客户端的缓存方式。参数值只能是 |
|
