You need to enable JavaScript to run this app.
文档中心
内容分发网络

内容分发网络

复制全文
下载 pdf
缓存配置
状态码缓存规则
复制全文
下载 pdf
状态码缓存规则

本文档介绍如何在火山引擎内容分发网络(CDN)中配置状态码缓存。

如果源站的响应状态码不是 2xx,CDN 默认不缓存请求的内容。如果另一个用户请求相同的内容时,CDN 还是会向源站请求该内容。如果您希望在短时间内避免这些回源请求,可以配置状态码缓存,降低源站压力。在配置了状态码缓存后,在您指定的时间内,这些内容的用户请求不会触发回源请求,CDN 会直接返回相应的状态码。

当前,您只能对 400-599 区间内的状态码配置状态码缓存。

说明

错误状态码的缓存以缓存键(cachekey)为维度,默认不区分 Range。如需让不同 Range 请求的错误响应互不影响(例如避免单个非法分片返回的 416 污染同一文件其他合法 Range 的缓存),请在 缓存键值 中将 Range 头加入缓存键。

操作步骤

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

Image

配置说明

配置

说明

规则类型

表示规则中的过滤条件。该配置有以下选项:

  • 文件后缀:表示路径末尾的扩展名。
  • 文件目录:表示路径中的目录。
  • 文件全路径:表示请求 URL 中的路径。
  • 全路径正则:表示请求 URL 中的路径,通过正则表达式匹配。 要指定该选项,请 提交工单。

规则内容

表示规则中的过滤值。多个过滤值之间使用分号(;)分隔,总长度不能超过 1,024 个字符,不能包含以下字符:

  • 双斜杠(//)、空格、美元符号($)、问号(?)

另外,

  • 如果 规则类型 是 文件后缀,过滤值是一个或者多个文件后缀。文件后缀无需以句点(.)开头。例如:png;txt。
  • 如果 规则类型 是 目录,过滤值是一个或者多个目录路径。目录路径必须以斜杠(/)开头和结尾。例如:/chs/foods/;/us/birds/。
  • 如果 规则类型 是 文件全路径,过滤值是一个或者多个文件路径。文件路径必须以斜杠(/)开头,可以包含星号(*)用来表示一个或者多个字符。例如:/chs/foods/local*sets;/us/birds/chickadee。
  • 如果 规则类型 是 全路径正则,过滤值是一个或者多个正则表达式,用于匹配请求路径中的任意字符串。例如:^/a{1,2}.*g$。

忽略大小写匹配

表示 CDN 在尝试使用规则与用户请求匹配时,匹配过程是否是大小写敏感的。该配置默认是开启,表示大小写不敏感。

当 规则类型 为 全路径正则 时,该选项置灰。对于全路径正则,匹配过程的大小写敏感性,以您填写的正则表达式为准。

状态码

输入一个状态码。您可以输入的状态码的范围是 400-599。您可以输入 4xx 或者 5xx。4xx 表示 400 到 499 之间的所有状态码。5xx 表示 500 到 599 之间的所有状态码。

缓存时间

表示缓存的时长。该配置的说明如下:

  • 如果您指定的时间单位是 秒,您可以输入的最大缓存时长是 315360000。
  • 如果您指定的时间单位是 分,您可以输入的最大缓存时长是 5256000。
  • 如果您指定的时间单位是 小时,您可以输入的最大缓存时长是 87600。
  • 如果您指定的时间单位是 天,您可以输入的最大缓存时长是 3650。

规则优先级

在规则列表中,每条规则都有优先级。优先级为 1 的规则具有最高优先级。当收到一个用户请求时,CDN 按规则的优先级,从高到低尝试将请求与规则匹配。如果请求匹配了一条规则,匹配过程就停止了。您可以拖动规则来调整优先级。

规则中的过滤条件定义了规则的作用范围。如果您创建了多条规则,请留意这些规则的作用范围是否存在交集,并按您的预期设置规则的优先级。例如,您创建了两条规则。规则A 的作用范围是 /dir/,规则B 的作用范围是 png;jpg。如果 /dir/ 目录下存在 .png 文件,并且您希望规则B 对 .png 文件的请求生效,那么您需要设置规则B 的优先级高于规则A。

最近更新时间:2026.06.09 12:08:48
这个页面对您有帮助吗?
有用
有用
无用
无用