文档中心

配置自定义HTTP响应头

最近更新时间：2022.11.01 17:48:46

首次发布时间：2022.08.01 10:49:33

操作背景

HTTP 响应头是 HTTP 响应消息头的组成部分之一，携带特定响应参数。对于源站返回的资源，您可以在返回给客户端时自定义 HTTP 响应头，以实现个性化的资源响应行为。这些行为包括：告知客户端全站加速响应文件的资源类型、实现跨域资源访问。

说明

配置 HTTP 响应头的行为属于域名级别的操作。配置生效后，此域名下的所有资源的响应消息中均带有您自定义的 HTTP 响应头。
HTTP 响应头只影响客户端（如浏览器）的响应行为，不会影响全站加速节点的缓存行为。

操作步骤

登录全站加速控制台。
点击左侧导航栏 域名管理 ，进入 域名管理 页面后，点击待配置的加速域名名称。
在域名管理页面，点击 高级配置 ，再点击编辑。
在 高级配置 标签页，设置 HTTP 响应头 为开启，点击添加，配置 HTTP 响应头规则。
点击提交完成对加速域名的 HTTP 响应头配置。

参数解释

字段		解释说明
优先级		对于配置的 HTTP 响应头规则，可以通过对规则的拖拽进行优先级的调整，列表序号越小的规则优先级更高。
Header 操作类型		具体取值包括：添加 ADD 、设置 SET 、删除 DEL 。
参数		自定义头部名称值长度默认为1 - 100个字符，由大小写字母、数字及 “-” 组成。 header 名称不支持x-bd、x-tt开头的字段。参数不支持自定义的响应头及解释见下表。
取值类型	常量	常量取值长度为1 - 1000个字符，不支持中文。
取值类型	变量	变量支持的字段取值和解释详见下表。

下列参数作为HTTP 响应头，不支持自定义，参数解释如下：

字段	解释说明	示例
Content-Disposition	指定客户端程序把请求所得的内容存为一个文件时默认使用的文件名。	dcdntest.txt
Content-Language	指定浏览器响应对象的语言。	en-US
Access-Control-Allow-Origin	指定允许的跨域请求的来源。填写*表示全部域名；您也可以填写完整域名。	https://www.volcengine.com。
Access-Control-Allow-Headers	指定允许的跨域请求字段。	X-Payment-Header
Access-Control-Allow-Methods	指定允许的跨域请求方法。	GET
Access-Control-Max-Age	指定客户端程序对特定资源的预请求返回结果的缓存时间，单位为秒。	60
Access-Control-Expose-Headers	指定允许访问的自定义头信息。	Content-Length
Content-Type	指定浏览器响应对象的内容类型。	text
Cache-Control	指定客户端程序请求和响应遵循的缓存机制。	no-cache
Expires	指定浏览器响应对象的过期时间。	Mon, 13 Dec 2021 16:09:00 GMT

HTTP 响应头取值类型为变量时，支持选择的字段取值如下：

字段	解释说明	示例
uri	表示请求的 URI。如果 URI 本身包含参数，则会删除问号（?）以及问号后面的参数。	/dir/volcano.php
request_uri	表示请求的 URI。如果 URI 本身包含参数，则保留问号（?）以及问号后面的参数。	/dir/volcano.php?color=red&n=10
remote_addr	表示发送请求的客户端 IP 地址。	10.10.10.10
remote_port	表示请求使用的端口号。	443
http_host	表示请求头中的 host 字段的值。	volcengine.com:8080
args	表示请求 URI 的参数部分，但是不包含参数前的问号（?）。	color=red&n=10
msec	表示客户端请求发送的时间。格式是十进制的 Unix 时间戳。	1650558396
scheme	表示客户端请求发送时使用的协议。	https

操作背景

操作步骤

参数解释