You need to enable JavaScript to run this app.
导航
多云CDN
  • 文档首页
    • /多云CDN/用户指南/刷新预热/提交文件预热任务
提交文件预热任务
最近更新时间：2025.09.22 15:02:10首次发布时间：2022.12.28 21:36:45
复制全文
我的收藏
有用
有用
无用
无用

您可以使用多云CDN的刷新预热功能，统一向云服务商加速产品（包含内置CDN加速服务、第三方云产品）提交文件预热任务。只需提交一次任务，便可在所有云服务商平台上对特定文件进行预热。该方式帮助您提升加速类服务日常运维的效率。

背景信息

云服务商提供文件预热功能。文件预热表示让加速服务（如 CDN、DCDN 等）节点主动从源站拉取特定文件（一般是大文件，如视频文件、安装包文件等），并将文件缓存在节点上。这样当用户请求对应文件时，加速服务节点可以直接返回文件。该方式减少了节点从源站获取文件带来的延时，避免了用户同时请求大文件时源站下载压力过大。
在以下场景，您可能需要执行文件预热：

  • 为新的域名开启加速服务后
  • 执行了缓存刷新后
  • 发布新的 App 或安装包前
  • 发布大型运营活动前

如果您的站点同时启用了多家云服务商的加速服务，而您希望在多家云服务商平台预热特定的文件，往往您需要分别登录不同云服务商平台进行操作。多云CDN的刷新预热功能使您可以通过多云CDN统一提交文件预热任务到多家云服务商平台。

影响与风险

使用多云CDN提交文件预热任务会使云服务商加速服务节点回源获取相关文件，可能导致回源请求数、回源流量、回源带宽突增等情形发生。

使用限制

  • 文件预热仅支持按 URL 缓存特定的文件，不支持按目录缓存文件夹下的所有文件。
  • 因云服务商平台的限制，您无法使用多云CDN向以下云服务商产品提交文件预热任务：
    • Akamai—AMD 和 DSA
    • Google Cloud—Media CDN
    • AWS—CloudFront
    • Cloudflare—CDN
      关于多云CDN支持的云服务商及产品的范围，请参见使用限制。

    说明

    针对海外云服务商，多云CDN提供统一文件预热方案。更多信息，请参见海外文件预热。

  • 不同云服务商产品对每日可执行的预热任务数量有限制。您通过多云CDN向指定云服务商产品提交的文件预热任务，不能超出对应限制。
  • 对于内置CDN加速服务，账号每日预热配额如下：
    每天最多可以预热 1,000 个 URL。每个预热任务中最多可以包含 100 个 URL。

    说明

    预热配额是主账号和子账号共用的。

前提条件

  • 要向内置CDN加速服务提交预热请求：
    • 您需要先添加域名到CDN加速服务。相关操作，请参见域名添加概述。
    • 在 CDN加速 域名列表中，加速域名的 加速状态 是 已启用 或 部署中。
  • 要向第三方云服务商加速产品提交预热请求：
    • 您需要先将云服务商账号添加到多云CDN，并且云服务商账号必须满足以下全部条件：
    • 第三方加速域名已经通过云服务商账号同步到多云CDN。更多信息，请参见数据同步。
    • 在多云管理的 域名管理 列表中，加速域名的 加速状态 是 已启用 或 部署中。

操作步骤

  1. 登录多云CDN控制台。
  2. 在左侧导航栏，单击 刷新预热。
  3. 单击 文件预热 页签。
  4. 根据配置说明完成预热任务设置。
  5. 单击 提交。

提交预热任务后，您可以在 执行状态 页面，查询预热任务在云服务商平台的执行结果。相关操作，请参见查看执行状态。

配置说明

说明

云服务商平台针对 URL 预热限制了任务配额。您可以在 配额管理 标签页了解具体的配额。

配置项

说明

下发方式

为预热任务选择一种提交方式。可选项：

  • 默认：表示向所有相关的云服务商提交预热任务。
    多云CDN会根据 URL 自动匹配云服务商，向匹配到的云服务商都提交预热任务。关于具体的匹配规则，请参见任务提交说明。
  • 指定云服务商：表示指定一个或多个云服务商，只向指定的云服务商提交预热任务。

URL

设置要缓存的 URL 列表。URL 列表包含待缓存的文件。您可以通过以下方式之一进行设置：

  • 手动输入：输入一个或多个 URL。输入要求如下：
    • URL 必须以http:// 或者 https:// 开头，只允许包含精确域名（如 mcdn.example.com）。
    • 每行输入一个 URL。
  • 上传文件：选择一个包含 URL 列表的本地 TXT 文件进行上传。
    TXT 文件中的 URL 列表也必须按照 手动输入 中的要求进行设置。否则，文件将会上传失败。

当 URL 中指定的 URL 数量超过 500 时，多云CDN将按照每个任务 200 个 URL，自动拆分出多个任务。

URL Encode

URL Encode 指自动将 URL 中的非 ASCII 字符和特殊字符（如汉字、空格）转换为浏览器可识别的形式，从而使 URL 能够在网络上安全传输。
具体来说，URL Encode 基于 UTF-8 字符集，它会自动将 URL 中的非保留字符转码为对应的 UTF-8 编码形式。这里的“非保留字符”指除字母、数字和以下字符外的所有字符：$&+,/:;=?@#
如果您使用由字符串拼接获得的 URL，建议您启用 URL Encode。

说明

多云CDN向华为云、腾讯云 API 提交您设置的原始 URL，不对 URL 转码。这是因为相应云服务商本身具备 URL Encode 的能力。

任务提交说明

如果您将 下发方式 设置为 默认，那么多云CDN会按照您提供的 URL 自动匹配所有相关的云服务商，并向匹配到的所有云服务商都提交预热/预热请求。

以一个 URL 为例，多云CDN首先提取 URL 中的域名，然后将该域名与多云CDN中的加速域名列表进行匹配。对于匹配到的加速域名，多云CDN向该加速域名所属的云服务商产品（如火山引擎 CDN、阿里云 DCDN等）提交预热/预热请求。

您指定的 URL 必须满足以下要求，才能确保任务提交成功：

  • URL 中的域名必须匹配多云CDN中的某个加速域名，且加速域名的 加速状态 为 已启用 或 部署中。
  • URL 中的域名必须匹配任务提交给的云服务商产品中的某个加速域名。

泛域名匹配规则
如果多云CDN中的加速域名是泛域名（如 **.*example.com 格式），那么只有 URL 中域名与泛域名匹配，URL 才允许预热。

加速域名

URL 示例

是否匹配（允许预热）

**.*example.com

http://example.com/1.mp4

❌

http://www.example.com/1.mp4

✅

http://l2.l1.example.com/1.mp4

✅

http://l3.l2.l1.example.com/1.mp4

❌（泛域名中的 * 最多能够匹配两层标签，如l2.l1）

示例
假设您分别从云服务商 A 和 B 的 CDN 同步了以下加速域名到多云CDN：

  • 云服务商 A：a.example.com 和 mcdn.example.com
  • 云服务商 B：b.example.com 和 mcdn.example.com

那么，

  • 如果 下发方式 为 默认，URL 为 http://mcdn.example.com/home/intro.video，多云CDN会向云服务商 A 和 B 提交对 http://mcdn.example.com/home/intro.video 的预热请求。
  • 如果 下发方式 为 默认，URL 为 http://a.example.com/home/intro.video 和 http://b.example.com/home/intro.video，多云CDN会按如下方式提交任务：
    • 向云服务商 A 提交对 http://a.example.com/home/intro.video 的预热请求。
    • 向云服务商 B 提交对 http://b.example.com/home/intro.video 的预热请求。
  • 如果 下发方式 为 指定云服务商 且 下发云服务商 为 A，URL 中将不允许出现 b.example.com 下的文件，否则多云CDN无法提交任务。这是因为云服务商 A 的 CDN 中没有加速域名 b.example.com。