本文档描述火山引擎内容分发网络(CDN)中的 "源站响应头设置" 特性。
CDN 提供了 "源站响应头设置" 的特性。在 CDN 收到源站响应时,会先基于 "源站响应头设置" 更新响应中的响应头,然后再基于更新后的响应头执行相应的操作。

操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏,点击 域名管理。
- 在 域名管理 页面,找到需要配置的域名,点击 管理。
- 定位 源站响应头设置 模块。
- 如果您使用的是旧版域名管理页面,点击 编辑配置,然后在 回源配置 标签页中定位 源站响应头设置 模块。
- 如果您使用的是新版域名管理页面,点击 编辑域名。在页面左侧的树状配置项列表中,定位 功能配置 > 回源配置 > 源站响应头设置。如果该模块置灰,点击模块右边的 + 。
关于新旧版域名管理页面的区别,参见 新版域名配置。
- 在 源站响应头设置 模块中,点击 新增规则。您最多可以添加 50 条规则。
- 参照文档下方的 配置说明 对该规则进行配置。
- 配置完成后,点击 提交编辑。

配置说明
配置 | 说明 |
|---|
配置类型 | 表示一个操作类型。该配置有以下选项: - 设置:表示设置一个指定的头部。如果源站响应中没有该头部,则 CDN 在响应中添加该头部。如果源站响应中没有该头部,则 CDN 设置该头部为指定的值。
- 删除:表示删除一个指定的头部。
|
头部名称 | 表示需要设置或者删除的一个头部。头部名称是大小写不敏感的。您可以从下拉列表中选择一个常用的头部,参见 常用头部。您也可以输入一个任意头部,头部名称不能超过 1,024 个字符,不能包含汉字以及以下字符: |
取值方式 | 对于您在 头部名称 中指定头部,该配置表示该头部的取值方式,有以下选项: - 常量:表示设置该头部为一个字符串。
- 变量:表示设置该头部为一个变量。
- 自定义:表示设置该头部为一个表达式。您可以在表达式中包含字符串和变量。
|
头部取值 | 表示您在 头部名称 中指定头部的取值。 - 如果 取值方式 是 常量,您需要输入一个字符串。该字符串的长度不能超过 1,024 个字符,不能包含不能包含美元符号($)。
- 如果 取值方式 是 变量,您需要从列表中选择一个变量。参见 变量列表。
- 如果 取值方式 是 自定义,您需要输入一个表达式。表达式由字符串和变量组成。变量需要包裹在
{} 中,由 $ 开头。例如 bind${remote_addr}to${host}done。
如果 头部名称 是 Access-Control-Allow-Origin,您可以在 头部取值 中输入多个以逗号(,)分隔的来源 IP 和来源域名,表示允许访问您域名的来源 IP 或者来源域名。 |
生效范围 | 表示该规则对哪些用户请求生效。该配置有以下选项: - 默认范围:表示该规则仅对源站响应中包含以下响应码的用户请求生效:
- 200、201、204、206、301、302、303、304、307、308
- 全部请求:表示该规则对所有用户请求生效。
当 配置类型 是 删除 时,该配置只能是 全部请求。 |
变量列表
变量列表与变量描述与 回源 HTTP 请求头 中的相同。
注意事项
您设置的响应头名称不能以 x-bdcdn-、x-byteinternal- 或 X-Volc- 开头,也不能是以下任意头部。
- X-Kfc-Cachekey
- X-Bdcdn-Origin-Err
- access-check
- server-timing
- via
- x-request-ip
- x-tt-trace-tag
- x-bdcdn-logid
- byte-error-code
- x-bdcdn-cache-status
- host
- X-Exception-Info
注意
如果源站响应中包含以 x-bdcdn-、x-byteinternal- 或 X-Volc- 开头的头部,这些头部不会包含在 CDN 响应中。
常用头部
常用头部与这些头部的描述与 HTTP 响应头设置 中的相同。