最近更新时间:2024.03.06 15:19:22
首次发布时间:2022.02.09 10:17:15
本文档介绍如何在火山引擎内容分发网络中配置 HTTP 响应头。
默认情况下,边缘节点在响应用户请求时,会包含所有来自源站的响应头。在内容分发网络中,您可以对响应头进行以下操作,以实现特定的目的。
X-Test:123
,但是源站响应头中已存在字段 x-test:456
。此时,内容分发网络的响应头中该字段会更新为 x-test:123
。在您设置字段时,可以输入任意字段或者从列表中选择一个常用字段。但是内容分发网络不支持设置某些字段,具体参见注意事项。
此时,在规则列表中会出现一条待配置的规则。
配置 | 说明 |
---|---|
响应头部操作 | 设置具体的操作。您可以设置以下值:
|
响应头部名称 | 设置一个需要添加或者删除的响应头字段。您可以设置任意的名称。系统也提供了常用的字段供您设置。参见常用字段。字段名称不能超过 1,024 个字符,可以包含除了以下字符的可打印 ASCII 字符:
|
取值方式 | 设置响应头字段的取值方式。您可以设置以下值:
|
响应头部取值 | 设置一个需要添加或者删除的响应头字段。您可以设置任意的名称。字段名称不能超过 1,024 个字符,可以包含除了以下字符的可打印 ASCII 字符:
如果您对 响应头部名称 列表中的字段设置字段值,例如 |
跨域校验 | 表示在内容分发网络响应用户请求时,是否校验请求头中的 Origin 字段。您可以启用或者禁用该配置。
该配置仅在以下情况下可被配置:
说明
注意
|
操作 | 表示可以对该规则进行的操作。比如删除该规则。 |
系统提供了以下变量字段。
字段名 | 说明 | 示例 |
---|---|---|
raw_uri | 表示客户端请求 URL 中的路径。 | /dir/volcano.php |
request_uri | 表示客户端请求 URL 中的路径和查询字符串(query string)。 | /dir/volcano.php?color=red&n=10 |
remote_addr | 表示发起本次请求的客户端的 IP 地址。 | 10.10.10.10 |
remote_port | 表示发起本次请求的客户端的端口。 | 5936 |
host | 表示客户端请求中 host 头部的值。 需要留意的是,内容分发网络在处理请求时可能会修改该字段的值。因此,不建议您使用该字段,而是使用 http_host 。 | www.example.com:8080 |
http_host | 表示客户端请求中 host 头部的值。该字段值不会被内容分发网络修改。 | |
args | 表示客户端请求 URL 中的查询字符串。 | color=red&n=10 |
msec | 表示内容分发网络设置响应头的时间,格式是 Unix 时间戳,精确到毫秒。该时间戳接近首包的响应时间。 | 1704444754.917 |
scheme | 表示客户端使用的协议。 | https |
cdn_cache_status | 表示请求是否命中缓存。
|
|
您可以从列表中选择常用的字段进行设置。这些常用字段的说明如下:
说明
这些字段是标准的 HTTP 响应头。如果响应头的值是合法的,浏览器会根据响应头做相应处理。您也可以将这些字段作为自定义字段来使用,赋予这些字段任意值。例如,您可能需要设置 Access-Control-Allow-Origin
的值为 helloworld
作为特殊用途。
字段名 | 说明 | 示例 |
---|---|---|
Access-Control-Allow-Origin | 指定允许访问您站点资源的来源(Origin)。
| 示例一 |
Access-Control-Allow-Methods | 指定跨域请求可以使用的 HTTP 请求方法。多个方法使用逗号(,)分隔。 | GET |
Access-Control-Allow-Headers | 指定跨域请求可以包含的 HTTP 请求头。多个请求头使用逗号(,)分隔。 | X-Custom-Header |
Access-Control-Expose-Headers | 指定客户端运行的脚本可以使用哪些响应头。多个响应头使用逗号(,)分隔。 |
|
Access-Control-Allow-Credentials | 指定跨域请求是否需要包含鉴权信息。鉴权信息包括 cookie,鉴权请求头或客户端 TLS 证书。 | true |
Access-Control-Max-Age | 指定跨域请求时,客户端对请求内容发起的预检请求的缓存时间。单位是秒。在缓存时间内,客户端不用再次发送预检请求。 | 3600 |
Cache-Control | 对于内容分发网络返回的内容,指定该内容在客户端的缓存方式。 | max-age=3600 |
Content-Disposition | 指示内容分发网络返回给客户端的内容是以下载的方式提供。并指定下载的文件名。 | attachment;filename=Demo.xlsx |
Content-Language | 指示内容分发网络返回给客户端的内容语言。 | zh-CN |
Content-Type | 指示内容分发网络返回给客户端的内容类型。 | text/plain |
Pragma | 对于 HTTP/1.0,指示内容分发网络返回的内容在客户端的缓存方式。字段值只能是 no-cache ,表示不缓存。 | no-cache |
在您设置字段时,不能使用以下字段,不然会报错。字段名称不区分大小写。
如果您输入了这些字段名中的任意一个,会收到以下错误:暂不支持配置此类头部!