You need to enable JavaScript to run this app.
导航

缓存刷新

最近更新时间2024.01.12 15:10:32

首次发布时间2021.08.12 16:35:16

缓存刷新概述

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

工作原理

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

  • 对于文件刷新,内容分发网络会从缓存中删除指定的文件。之后,当收到这些文件的请求时,内容分发网络会向源站请求文件。
  • 对于目录刷新,内容分发网络会将指定目录下已缓存的文件标记为已过期。当收到这些文件的请求时,内容分发网络会向源站发送文件校验请求。关于文件校验的流程,参见缓存规则

适用场景

"缓存刷新"适用于以下场景:

  • 站点上有关键文件被更新了。此时,您需要用户能获取最新的文件。如果您站点上文件的更新频率是可预知的,建议您为站点文件配置缓存规则

  • 源站上的特定文件由于某些原因需要被删除。然而,这些文件可能已被内容分发网络缓存了。您不希望用户访问这些文件。

注意事项

  • "缓存刷新"可以确保用户获取最新版本的文件。但是当您对一个文件提交刷新任务并且该任务成功执行后,该文件的第一次访问是无法获得加速的。如果您需要该文件的第一次访问能被加速,在刷新任务成功执行后,您可以使用"文件预热"功能。关于如何了解任务的执行状态,参见操作记录

  • 在您提交刷新任务后,生效时间大约是 5 分钟。

  • 在您对大量文件提交刷新任务后,这些文件的首次请求都会触发回源请求。因此您的源站可能会在短期内承受流量压力,特别是在文件体积较大的时候。

刷新配额

您账号下每天可刷新的文件和目录有以下限额:

  • 如果您刷新的是单个文件,您每天最多可以刷新 1,000 个文件。

  • 如果您刷新的是目录下的所有文件,您每天最多可以刷新 50 个目录。

说明

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

如果您需要更多的刷新配额,参见白名单功能

操作步骤

  1. 登录 火山引擎内容分发网络控制台

  2. 在左侧导航栏,点击 刷新预热

  3. 刷新预热 页面,点击 缓存刷新 标签页。

  4. 按照配置说明进行操作。

  5. 点击 提交

alt

配置说明

配置说明

任务类型

表示任务的类型。该配置有以下取值:

  • URL 刷新:表示刷新的对象是一个或者多个文件。

  • 目录刷新:表示刷新的对象是一个或者多个目录。

您账号下每天可刷新的文件和目录的数量是有限额的。参见 刷新配额

前缀刷新表示是否开启前缀刷新。该配置仅当 任务类型目录刷新 时才会出现,默认是关闭。

URL

表示需要刷新的 URL。该配置有以下取值:

  • 手动输入:表示手动输入那些需要刷新的 URL。

  • 上传文件:表示上传一个 .txt 文本文件。需要刷新的 URL 包含在该文本文件中。

URL 必须满足以下条件:

  • 如果 任务类型URL 刷新,您可以指定最多 1,000 个文件的 URL。文件 URL 必须满足以下条件:

    • 文件 URL 必须 以 https:// 或者 http:// 开头。

    • 多个文件 URL 以换行分隔。

    • 您一次最多可以提交 1,000 个 URL。

  • 如果 任务类型目录刷新 时,有以下说明:

    • 如果 前缀刷新 未开启,您可以指定最多 100 个目录的 URL。目录 URL 必须满足以下条件:

      • 目录 URL 必须 以 https:// 或者 http:// 开头,并且以 / 结尾。

      • 多个目录 URL 以换行分隔。

    • 如果 前缀刷新 已开启,您可以指定最多 100 个用于匹配目录 URL 的前缀。例如 http://example.com/im 可用于匹配 http://example.com/image/http://example.com/imece

白名单功能

您可以提交工单启用以下功能:

  • 提升刷新配额

  • 强制删除

  • 正则刷新

提升刷新配额

启用此功能后,可以增加您账户的每日刷新配额。 实际的刷新配额以控制台显示的额度为准。

强制删除

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

  • 默认情况下,当您提交缓存刷新任务时,内容分发网络会将缓存中相应的文件标记为过期,而不是删除。当收到这些文件的请求时,内容分发网络会向源站发送文件校验请求,而不是直接向源站请求文件。参见 回源校验
  • 开启 强制删除 后,刷新任务会删除缓存中相应的文件。当收到这些文件的请求时,内容分发网络会直接向源站请求文件。

正则刷新

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

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

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

  • 正则表达式匹配的是文件路径和查询字符串,但不包含路径开头的 /。也就是说,URL 的格式只能是 http://host/regex 或者 https://host/regexhost 表示加速域名,regex 表示正则表达式。

  • 正则表达式中只能包含以下元字符:

    • [0-9]

    • [a-z]

    • [A-Z]

    • [a-zA-Z]

    • [^/]*

    • .*

    • +

    • [,?]

    • ?

注意事项

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

例如 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

alt