文件更新与缓存刷新

操作入口与准备

进入「内容分发网络 → 刷新与预热」。页面上方的「可提交域名」列出当前可用域名；没有可用域名时，点击「去绑定域名」或「查看域名」处理接入和状态。

准备需要更新的完整资源 URL，并先确认源站返回的是新文件。下面使用 download.example.com 作为格式示例，不是可直接提交的测试域名。

什么时候需要刷新

源站覆盖了同一个 URL 的内容，但节点的旧缓存还没过期时，可提交刷新使旧副本失效。

刷新不会替你上传文件，也不清理用户浏览器已经保存的缓存。先确认源站的新版本正确，再操作刷新。

选择任务类型

刷新一个文件或目录

1. 打开「刷新与预热」，选择「URL 刷新」。
2. 单文件选择「链接」；确定要更新整个目录时才选择「目录」。
3. 每行填写一个完整 URL，包含 http:// 或 https://，域名必须属于当前账号且可用于该操作。当前页面每次最多提交 100 条。
4. 检查预览中的数量和域名，点击「提交任务」。
5. 在任务记录中查看是否已受理或提交失败；随后访问目标文件核对版本。

https://download.example.com/releases/demo.zip

示例中的域名与路径仅用于说明，使用时替换为你有权操作的实际资源。

「已受理」表示请求提交成功，不代表所有节点已清理完成。

刷新后的命中率为什么下降

旧缓存失效后，新请求需要重新回源，因此命中率可能暂时降低。目录刷新涉及更多文件，影响通常比刷新单个 URL 大。

若新版本即将集中下载，可在刷新之后再对重要文件做预热。不要用频繁全目录刷新代替合理的版本文件名。

刷新后仍看到旧文件

1. 直接检查源站是否已经更新，确认路径和文件大小。
2. 确认刷新的协议、域名、路径和实际下载 URL 一致。
3. 核对查询参数策略，确认访问命中了预期的版本。
4. 排除浏览器本地缓存和下载目录中的旧文件，必要时核对文件校验值。

提交预热任务

1. 选择「URL 预热」，在「任务路径」中每行填写一个完整文件 URL。
2. 检查 URL 数量、去重结果和域名预览；页面每次最多接受 100 条。
3. 点击「提交任务」，在下方「任务记录」查看本次操作类型与状态。
4. 使用测试文件验证可访问性。预热会向源站拉取内容，不会替你上传新文件。

任务状态如何判断

「已受理」表示平台接收了请求，不等于所有节点已更新。刷新或预热后仍需访问目标文件验证内容。

任务记录读取失败时点击「重试」；提交失败则先处理表单或接口返回原因，再重新提交。刷新不删除浏览器本地缓存，也不替代源站文件更新。