本文档介绍如何在火山引擎内容分发网络(CDN)中配置 HTTP 响应头。
默认情况下,在对用户请求的响应中,CDN 会包含源站响应中的所有头部。您也可以配置 CDN 在用户请求的响应中所包含的头部。
配置 | 说明 |
---|---|
配置类型 | 表示一个操作类型。该配置有以下选项:
|
头部名称 | 表示需要添加或者删除的一个头部。头部名称是大小写不敏感的。您可以从下拉列表中选择一个常用头部,参见 常用头部。您也可以输入一个任意头部,头部名称不能超过 1,024 个字符,不能包含以下字符:
参见 注意事项。 |
取值方式 | 对于您在 头部名称 中指定头部,该配置表示该头部的取值方式,有以下选项:
|
头部取值 | 表示您在 头部名称 中指定头部的取值。
如果 头部名称 是 |
跨域校验 | 表示在 CDN 响应用户请求时,是否校验用户请求头中的 Origin 头部。该配置仅在以下情况下会出现:
该配置的设置说明如下:
说明
|
CDN 提供了以下变量。
变量名称 | 说明 | 示例 |
---|---|---|
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 头部的值。 需要留意的是,CDN 在处理请求时可能会修改该头部的值。因此,不建议您使用该头部,而是使用 http_host 。 | www.example.com:8080 |
http_host | 表示客户端请求中 host 头部的值。该头部值不会被 CDN 修改。 | |
args | 表示客户端请求 URL 中的查询字符串。 | color=red&n=10 |
msec | 表示 CDN 设置响应头的时间,格式是 Unix 时间戳,精确到毫秒。该时间戳接近首包的响应时间。 | 1704444754.917 |
scheme | 表示客户端使用的协议。 | https |
cdn_cache_status | 表示请求是否命中缓存。
|
|
CDN 提供了以下常用的头部。
说明
这些头部是标准的 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 | 对于 CDN 返回的内容,指定该内容在客户端的缓存方式。 | max-age=3600 |
Content-Disposition | 指示 CDN 返回给客户端的内容是以下载的方式提供。并指定下载的文件名。 | attachment;filename=Demo.xlsx |
Content-Language | 指示 CDN 返回给客户端的内容语言。 | zh-CN |
Content-Type | 指示 CDN 返回给客户端的内容类型。 | text/plain |
Pragma | 对于 HTTP/1.0,指示 CDN 返回的内容在客户端的缓存方式。头部值只能是 no-cache ,表示不缓存。 | no-cache |
您设置的响应头名称不能是以下任意头部。