You need to enable JavaScript to run this app.
导航
源站响应头设置
最近更新时间:2025.10.27 10:41:18首次发布时间:2025.02.28 15:09:42
复制全文
我的收藏
有用
有用
无用
无用

本文档描述火山引擎内容分发网络(CDN)中的 "源站响应头设置" 特性。

说明

要使用该特性,请 提交工单

CDN 提供了 "源站响应头设置" 的特性。在 CDN 收到源站响应时,会先基于 "源站响应头设置" 更新响应中的响应头,然后再基于更新后的响应头执行相应的操作。
Image

操作步骤

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

Image

配置说明

配置

说明

配置类型

表示一个操作类型。该配置有以下选项:

  • 设置:表示设置一个指定的头部。如果源站响应中没有该头部,则 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 响应头设置 中的相同。