缓存刷新概述

在火山引擎内容分发网络（CDN）中，每个被缓存的文件都有一个缓存过期时间。如果一个文件在缓存中未过期，但是源站上对应的文件已被更新，CDN 依然会将缓存的文件提供给用户。此时，如果您需要用户能获取源站上更新后的文件，您可以使用 CDN 提供的"缓存刷新"功能。

工作原理

您可以使用"缓存刷新"功能为特定文件或者目录提交刷新任务。

• 文件刷新：CDN 会删除缓存中指定的文件。之后，当收到对这些文件的请求时，CDN 会向源站请求文件。
• 目录刷新：CDN 会将指定目录下所有已缓存的文件，包括子目录中的文件，标记为已过期。当收到这些文件的请求时，CDN 会向源站发送文件校验请求。关于文件校验的流程，参见 缓存规则。

适用场景

"缓存刷新"功能适用于以下场景：

• 站点上有关键文件被更新，您需要用户能获取最新的文件。如果您站点上文件的更新频率是可预知的，建议您为站点文件 配置缓存规则。
• 源站上的特定文件由于某些原因需要被删除。但是，这些文件可能已被 CDN 缓存。您不希望用户访问到这些已被删除的文件。

最佳实践

CDN 可以与火山引擎函数服务配合使用，以实现以下功能：

• 如果您的源站包含火山引擎对象存储（TOS）中的存储桶，您可以使用函数服务实现在某些文件在 TOS 上发生变更时，自动触发内容分发网络对这些文件的刷新操作。详情参见 使用函数实现 TOS 触发 CDN 刷新预热。
• 使用函数服务实现定时触发 CDN 对特定文件的刷新操作。详情参见 使用函数服务定时触发 CDN 刷新预热。

注意事项

• "缓存刷新"可以确保用户获取最新版本的文件。但是当您对一个文件提交刷新任务并且任务成功执行后，该文件的首次访问是无法获得加速效果。如果您需要该文件的首次访问能被加速，在刷新任务成功执行后，您可以使用 文件预热 功能。关于如何了解任务的执行状态，参见 操作记录。
• 在您提交刷新任务后，任务生效时间大约是 5 分钟。
• 在您对大量文件提交刷新任务后，这些文件的首次请求都会触发回源请求。因此您的源站可能会在短期内承受流量压力，特别是在文件体积较大时。
• 您不能直接对泛域名下的文件和目录执行刷新操作。具体操作方法，参见 如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作。

刷新配额

您账号每日刷新配额如下：

• 如果您刷新的是 URL，您每天最多可以刷新 10,000 个 URL。每个刷新任务中最多可以包含 100 个 URL。如果您需要调整这些额度，参见 配额管理。
• 如果您刷新的是目录，您每天最多可以刷新 50 个目录。

:::tip
刷新配额是主账号和子账号共用的。

• 配额按您每次提交中包含的目录/URL 数量累计，与您提交操作的次数无关。
• 同一个 URL 在一天内被多次提交时，每次提交都会分别计入当日配额，并不会合并为一次。例如，您对同一个 URL 连续提交了 3 次刷新，将累计消耗 3 个 URL 配额。
  :::
  

操作步骤

1. 登录 火山引擎内容分发网络控制台。
2. 在左侧导航栏，点击 刷新预热。
3. 在 刷新预热 页面，点击 缓存刷新 标签页。
4. 按照 配置说明 进行操作。
5. 点击 提交。


配置说明

| | | \

配置	说明
任务类型	表示刷新任务的类型。该配置有以下选项：
	* URL 刷新：表示刷新的对象是一个或者多个文件。
	* 目录刷新：表示刷新的对象是一个或者多个目录。
	您账号下每天可刷新的文件和目录的数量是有限额的。参见 刷新配额。
前缀刷新	表示是否开启前缀刷新。该配置仅当 任务类型 是 目录刷新 时才会出现，默认是关闭。
URL	表示需要刷新的 URL。该配置有以下取值：
	* 手动输入：表示手动输入那些需要刷新的 URL。
	* 上传文件：表示上传一个 .txt 文本文件，包含需要刷新的 URL。
	URL 必须满足以下条件：
	* 如果 任务类型 是 URL 刷新，您可以指定最多 100 个文件的 URL。文件 URL 必须满足以下条件：
	* 文件 URL 必须 以 https:// 或者 http:// 开头。
	* 多个文件 URL 以换行分隔。
	* 如果 任务类型 是 目录刷新 时，有以下说明：
	* 如果 前缀刷新 未开启，您可以指定最多 100 个目录的 URL。目录 URL 必须满足以下条件：
	* 目录 URL 必须 以 https:// 或者 http:// 开头，并且以 / 结尾。
	* 多个目录 URL 以换行分隔。
	* 如果 前缀刷新 已开启，您可以指定最多 100 个用于匹配目录 URL 的前缀。例如 http://example.com/im 可用于匹配 http://example.com/image/ 和 http://example.com/imece。
刷新 HTTP 请求头	用于指定待刷新文件在缓存键中必须包含的请求头。只有当缓存文件的缓存键中完全包含了此处指定的请求头时，该文件才会被匹配并刷新。
	请求头有以下要求：
	* 您最多可以指定 10 个请求头。
	* 请求头不能为 User-Agent ，也不能以 x-bdcdn- 或 Volc-Cdn 开头。
	* 请求头和请求头的值均不能超过 1,024 个字符。
	此配置的常见使用场景如下：
	* 您使用规则引擎配置了参与缓存键构造的请求头列表。在执行刷新操作时，您希望只刷新缓存键中包含指定请求头的文件。

共享缓存场景下目录刷新的注意事项

在提交目录刷新任务时，如果目标域名在一个 共享缓存 配置中，您会收到以下截图中的提示：
提示页面中有一个 刷新共享缓存域名 开关，用于控制刷新操作的生效范围，具体描述如下：

• 开关关闭：刷新任务仅对任务中的目标域名生效。任务提交后，CDN 只会在收到目标域名下目录文件的请求时，才对相应文件执行刷新操作。
• 开关打开：刷新任务将对共享缓存配置中的所有域名生效。任务提交后，CDN 在收到任意域名下目录文件的请求时，就会对相应文件执行刷新操作。

示例

假设以下场景：在一个共享缓存配置中，b.example.com、c.example.com 共享 a.example.com 的缓存。您对 c.example.com 提交了一个目录刷新任务，目录路径是 /docs/。目录刷新任务提交后，CDN 陆续收到三个请求，请求 URL 分别是 http://a.example.com/docs/file、http://c.example.com/docs/file、http://a.example.com/docs/file。
下面分别对提交目录刷新任务时，开关打开和开关关闭两种情况下 CDN 的行为进行说明：

| | | | \

	开关关闭	开关打开
收到第一个请求	CDN 不会刷新缓存，返回旧的缓存文件	CDN 会刷新缓存，并返回更新的缓存文件
收到第二个请求	CDN 会刷新缓存，并返回更新的缓存文件	CDN 返回更新的缓存文件
收到第三个请求	CDN 返回更新的缓存文件	CDN 返回更新的缓存文件

白名单功能

您需要 提交工单 启用以下功能：

• 强制删除
• 正则刷新

强制删除

当 任务类型 是 目录刷新 时，该配置会出现，用以指定是否删除已缓存的文件。

• 默认情况下，当您提交目录刷新任务时，CDN 会将缓存中对应的文件标记为过期，而不是直接删除文件。当收到对这些文件的请求时，CDN 会向源站发送文件校验请求，而不是直接向源站请求文件。关于回源校验的更多信息，参见 缓存规则。
• 开启 强制删除 后，刷新任务会删除缓存中对应的文件。当收到对这些文件的请求时，CDN 会直接向源站请求文件。

正则刷新

在您指定文件 URL 时，您可以在 URL 中使用正则表达式来匹配需要刷新的文件。您可以输入一个或者多个 URL，多个 URL 使用换行分隔。每个 URL 不能超过 256 个字符。正则表达式在匹配时区分大小写。

您账号下每天可刷新 20 个包含正则表达式的 URL。您一次最多可以提交 10 个 URL。

在 URL 中，您可以指定的正则表达式有以下限制：

• 正则表达式匹配的是文件路径和查询字符串，但不包含路径开头的 /。URL 的格式必须是 http://host/regex 或者 https://host/regex。其中，host 表示加速域名，regex 表示正则表达式。
• 正则表达式中只能包含以下元字符：
  • [0-9]
  • [a-z]
  • [A-Z]
  • [a-zA-Z]
  • [^/]*
  • .*
  • [,?]
  • ?

注意事项

在您构建的包含正则表达式的文件 URL 中，除了路径开头的 /，整个路径都被认为是正则表达式。因此，只要正则表达式匹配了某个实际文件的 URL 中的部分路径，该文件就会被认为是匹配，从而被 CDN 刷新。

例如，https://www.example.com/dir2/.*\.js 可以匹配以下文件的 URL：

• http://www.example.com/dir2/img1.js
• http://www.example.com/dir2/img1.js?size=small
• http://www.example.com/dir1/dir2/img1.js
• http://www.example.com/dir1/dir2/img1.jsp