全部产品
Search
文档中心

视频点播:刷新预热

更新时间:Feb 10, 2026

当源站内容更新或需要清理违规资源时,需要强制CDN节点刷新缓存以确保用户访问最新内容。在活动发布或新内容上线前,提前预热资源到CDN节点,可以显著提升用户首次访问速度并降低源站压力。本文档将指导如何正确使用视频点播的缓存刷新与资源预热功能。

功能介绍

资源刷新

刷新操作的本质是向CDN边缘节点下发缓存失效指令,而非直接删除文件。边缘节点收到指令后,会将匹配的缓存资源标记为“失效”或“过期”。当用户再次请求该资源时,边缘节点发现缓存已失效,便会回源获取最新资源,并在返回给用户的同时重新缓存。

适用场景

  1. 资源更新和发布:源站的旧资源更新或升级后,为避免用户仍访问到旧的缓存资源,可通过提交对应资源的URL或目录进行刷新,确保用户访问到最新的资源并缓存至CDN边缘节点。

  2. 违规资源清理:如果您的源站存在不合规内容(如使用限制中提及的内容),删除源站资源后,由于CDN边缘节点仍可能存在缓存,资源仍可能被访问到。此时可通过URL刷新功能更新缓存资源,确保违规内容及时清除。

资源预热

预热操作是由CDN边缘节点根据您提交的URL列表,主动向源站发起请求,将资源缓存到CDN边缘节点上,而非由源站主动推送。预热可提升新资源或活动页面的首次访问速度,同时减少活动上线时的回源压力,保护源站。

适用场景

  1. 首次接入阿里云CDN:当您首次接入CDN后,可选择将热点静态资源提前预热至CDN边缘节点。用户访问时可直接由CDN边缘节点响应,避免初次访问速度慢的问题,提升用户体验。

  2. 运营活动:在运营大型活动时,提前将活动页涉及的静态资源预热至CDN边缘节点。活动开始后,用户访问的所有静态资源均已缓存至CDN边缘节点,由边缘节点直接响应,确保活动页面快速加载。

  3. 安装包或其他大文件发布:新版本安装包或升级包发布前,提前将资源预热至CDN边缘节点。产品正式上线后,用户的下载请求将直接由CDN边缘节点响应,提升下载速度,降低源站压力。

前提条件

  • 操作时机:刷新预热任务会产生回源流量,建议在业务流量低峰期执行大规模的刷新或预热任务。

  • URL 格式:提交的 URL 中若包含非 ASCII 字符(如中文、空格),必须先进行UTF-8百分号编码(Percent-encoding)。

  • 共享缓存:若域名配置了共享缓存,使用主域名或任一关联域名提交刷新任务,均可使所有关联域名的缓存失效。

操作步骤

刷新资源

  1. 登录视频点播控制台

  2. 在左侧导航栏选择配置管理 > 分发加速配置 > 刷新预热,进入到刷新预热页面。

  3. 刷新缓存页签,选择操作类型为刷新

  4. 根据需求,选择刷新方式并提交任务。

    刷新方式

    操作说明

    URL

    目的:刷新一个或多个具体文件的缓存。

    操作:URL输入框中,输入完整的URL(包含 http:// 或 https://),每行一个。例如:https://www.example.com/static/image.jpg

    目录

    目的:刷新CDN目录下所有文件和子目录的缓存。

    操作:输入完整的目录 URL,且必须以 / 结尾。例如:https://www.example.com/static/

    说明:此方式为变更刷新。若需强制刷新整个目录,请使用刷新缓存并设置 Force=true

  5. 单击提交,系统将开始执行刷新任务。

    说明
    • 刷新任务一旦提交成功,将无法中止。

    • 刷新任务通常需要 5-6 分钟在全网生效。如果缓存过期时间本身就小于此值,则无需手动刷新。

预热资源

  1. 登录视频点播控制台

  2. 在左侧导航栏选择配置管理 > 分发加速配置 > 刷新预热,进入到刷新预热页面。

  3. 刷新缓存页签,选择操作类型为预热

  4. URL输入框中,输入需要预热的完整文件URL,每行一个。不支持预热目录。例如:https://www.example.com/install/package.zip

  5. 单击提交,系统将开始执行预热任务。

    说明
    • 预热任务一旦提交成功,将无法中止。

    • 预热任务的完成时间取决于文件大小、数量和源站性能,通常需要 5-30 分钟。

验证结果

  • 手动查询

    操作记录页签中查看资源刷新或预热的详细记录和进度。进度为100%,表示任务执行完成。刷新或预热的数量过多,会影响任务的完成进度,请您耐心等待。

  • 接口查询

    调用查询视频刷新或预热任务信息接口,查询刷新或预热任务是否完成。

  • 命令行验证

    执行命令curl -I <资源链接>,系统显示结果如下:

    image

    存在X-Cache的情况:

    • X-CacheHIT,说明此次请求命中缓存,预热成功。

    • X-CacheMISS,说明此次请求未命中缓存,预热任务未完成或预热失败,请重新预热。

    不存在X-Cache的情况:

    如果不存在X-Cache,说明该资源未接入CDN,请参照接入域名配置该URL的域名,再进行资源的预热。

使用限制

操作类型

方式

配额限制

刷新

URL刷新

每个账号每日最多2000条,每次最多1000条。

目录刷新

每个账号每日最多100条,每次最多100条。

预热

URL预热

每个账号每日最多500条,每次最多100条。

计费说明

刷新和预热功能本身不收取任何操作费用

但是,这两种操作都会触发CDN边缘节点回源拉取资源,由此产生的回源流量和回源请求次数将会产生费用。计费标准遵循您所使用的源站类型:

重要

大规模的刷新或预热操作,尤其是在短时间内,可能会导致回源成本增加。请在操作前评估潜在的成本影响。

相关API

常见问题