You need to enable JavaScript to run this app.
导航
状态码缓存规则
最近更新时间:2025.10.27 10:41:14首次发布时间:2022.02.09 10:17:04
复制全文
我的收藏
有用
有用
无用
无用

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

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

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

操作步骤

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

Image

配置说明

配置

说明

规则类型

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

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

规则内容

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

  • 连续斜杠(//)、空格、美元符号($)、问号(?)、Delete(ASCII code 127)。

CDN 在尝试将规则中的过滤条件与用户请求匹配时,匹配过程是大小写不敏感的。

另外,

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

忽略大小写匹配

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

示例:对于文件后缀规则,您设置 忽略大小写 为关闭。您输入的规则内容是 png;txt。此时,该规则可以匹配 URL 是 HTTPS://www.EXAMPLE.com/volcano.png 的请求,但是不能匹配 URL 是 https://www.example.com/volcano.PNG 的请求。

状态码

输入一个状态码。您可以输入的状态码的范围是 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。