视频点播支持在域名管理中配置 HTTP 响应头。本文为您介绍如何在视频点播中配置 HTTP 响应头字段的功能介绍和操作步骤。

功能介绍 #

默认情况下，缓存节点在响应用户请求时，会透传源站的响应头。在视频点播中，您可以对响应头进行以下操作，以实现特定的功能。

• 设置响应头字段：如果您需要在缓存节点响应头中添加字段，可以通过该操作进行配置。如果在匹配时发现响应头中已存在该字段，已有的字段值会被覆盖。匹配时不区分大小写。比如您添加了字段 X-Test:123，但是源站响应头中已存在字段 x-test:456。此时，缓存节点的响应头中该字段会更新为 x-test:123。
• 删除响应头字段：如果您不需要源站响应头中某些字段，可以通过该操作进行配置。在缓存节点响应用户请求时，响应头中就会删除这些字段。

在您设置字段时，可以输入任意字段或者从列表中选择一个常用头部。但是视频点播不支持设置某些字段，具体参见注意事项。

适用范围 #

HTTP 响应头设置适用于点播加速域名、自定义源站加速域名和封面加速域名。

操作步骤 #

1. 登录视频点播控制台，进入空间。

2. 选择左侧导航栏分发加速 > 域名管理，进入域名管理页面。

3. 根据您的域名类型，在域名列表中找到您需要配置的域名，单击操作列的配置按钮。

4. 进入加速域名配置页面，选择高级配置页签。

5. 单击页面下方的修改配置按钮，在 HTTP 响应头设置下方，根据自身业务需求，单击新增按钮，进行规则配置。规则的详细说明如下表所示。

   说明

   您最多可以添加 50 条规则。

   配置	说明
   配置类型	表示一个操作类型。该配置有以下选项： 设置：表示设置一个头部。设置操作包括添加与修改。如果源站响应中已包含该头部，该头部的值会被覆盖。如果源站响应中没有包含该头部，该头部会被添加。 删除：表示删除一个头部。
   头部名称	表示需要设置或者删除的一个头部。头部名称是大小写不敏感的。您可以从下拉列表中选择一个常用头部，参见常用头部。除了注意事项中列出的那些头部名称之外，您可以输入任意一个头部名称。头部名称不能超过 1,024 个字符，不能包含以下字符： 汉字、空格、双引号（"）、冒号（:）
   取值方式	对于您在 头部名称 中指定的头部，该配置表示该头部值的类型，有以下选项： 常量：表示该头部值是一个字符串。 变量：表示该头部值来自一个变量。 自定义：表示该头部值是变量与字符串拼接后的一个字符串。
   头部取值	表示您在 头部名称 中指定头部的取值。 如果 取值方式 是 常量，您需要输入一个字符串。该字符串的长度不能超过 1,024 个字符，不能包含以下字符： 汉字、美元符号（$） 如果 取值方式 是 变量，您需要从列表中选择一个变量。参见变量列表。 如果 取值方式 是 自定义，您需要输入由变量和字符串拼接后的一个字符串。变量需要包裹在 {} 中，由 $ 开头。例如 bind${remote_addr}to${host}done。 如果 头部名称 是 Access-Control-Allow-Origin，您需要在 头部取值 中指定来源 IP 和来源域名，端口是可选的，域名可以是泛域名。多个来源 IP 和来源域名之间以逗号（,）分隔。建议您指定的来源 IP 和来源域名以 http:// 或者 https:// 开头。
   跨域校验	此配置项决定 CDN 是否根据请求头中的 Origin 字段来进行跨域校验。该配置项仅在满足以下两个条件时才会出现： 头部名称 为 Access-Control-Allow-Origin。 取值方式 为 常量。 Access-Control-Allow-Origin 的值支持以下格式： 任意来源：设置为 *。 特定来源：设置单个或多个 IP、域名，或者 IP 与域名的组合。多个来源之间用逗号（,）分隔。来源必须包含协议头 http:// 或 https://，且支持携带端口。 泛域名：域名支持泛域名格式，例如 https://*.example.com。 启用 跨域校验 后，CDN 的处理逻辑如下： 任意匹配：如果头部取值设置为 *，无论请求中是否携带 Origin 头部，也不论 Origin 头部的值为何，CDN 都会在响应中返回 Access-Control-Allow-Origin: *。 精确匹配：如果头部取值设置为单个或多个具体的来源，CDN 会检查请求头中的 Origin 值是否与设置的任意一个来源精确匹配。 如果匹配成功，CDN 会在响应中返回 Access-Control-Allow-Origin 头部，该头部的值为请求中的 Origin 头部的值。 如果匹配失败，CDN 不会在响应中返回 Access-Control-Allow-Origin 头部。 泛域名匹配：如果头部取值设置了泛域名，CDN 会检查请求头中的 Origin 值是否匹配该泛域名。匹配后的处理逻辑与精确匹配相同。 如果不启用 跨域校验，CDN 不会检查请求中的 Origin 头部，始终将您配置的 Access-Control-Allow-Origin 头部添加到响应中。 说明 如果 Access-Control-Allow-Origin 的值包含多个来源，强烈建议您开启 跨域校验。如果不开启，CDN 会将所有来源作为头部值返回，而浏览器通常只允许 Access-Control-Allow-Origin 包含一个值，导致浏览器报错。 跨域资源共享 (CORS) 涉及复杂的安全策略。为了帮助您更好地理解和配置，我们提供了 CDN 跨域（CORS）配置的最佳实践。该文档解析了技术原理，并为您提供了针对不同业务场景的配置指南，帮助您解决跨域问题。

6. 完成配置后，单击保存配置按钮。

变量列表 #

CDN 提供了以下变量。

常用头部 #

CDN 提供了以下常用的头部。

注意事项 #

您设置的响应头不能是以下头部。

• access-check
• server-timing
• via
• x-request-ip
• x-tt-trace-tag
• x-bdcdn-logid
• byte-error-code
• x-bdcdn-cache-status

配置示例：动态配置 Content-Disposition 实现指定下载文件名 #

当您希望通过 URL 中的查询参数动态控制客户端（如浏览器）保存的文件名时，可以通过配置自定义的 Content-Disposition HTTP 响应头来实现。相比部分源站（例如 TOS）通过 response-content-disposition 参数改写响应头的方式，在 CDN 层改写不依赖源站是否支持该能力，配置更统一、生效更可控。
假设您希望客户端通过 URL 请求 http://example.com/image.jpg?rename=new_name.jpg 时，浏览器保存的文件名为 new_name.jpg，可以参考以下配置：

1. 在 HTTP 响应头设置 中新增一条规则。
2. 配置类型 选择 设置。
3. 头部名称 填写 Content-Disposition。
4. 取值方式 选择 自定义。
5. 头部取值 填写 attachment;filename=${arg_rename}。（其中 ${arg_rename} 对应提取 Query 中的 rename 参数值）。