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 或者 5xx4xx 表示 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
这个页面对您有帮助吗?
有用
有用
无用
无用