静态资源CDN海外节点缓存清理教程

当网站使用CDN加速海外访问时，静态资源（如图片、CSS、JS文件）被缓存到全球节点上。
如果更新了资源却没有清理海外节点的旧缓存，海外用户会一直加载旧版本，导致样式错乱或功能异常。
本文专门解决这个问题，从准备到操作再到验证，让零基础用户也能独立完成静态资源CDN海外节点缓存清理。

操作前必须确认的三件事

在动手清理前，请先检查以下信息是否齐全，否则可能清理不到正确位置：

1. CDN服务商账号权限：确保你拥有域名配置管理权限，以及缓存清理功能入口。常见服务商如阿里云CDN、腾讯云CDN、Cloudflare等都在“刷新预热”或“缓存管理”模块。
2. 待清理的资源URL列表：如果你只是想更新某个特定文件（例如 style.css?v=2），请准备好完整的URL地址；如果整个目录或全部文件都需要清理，确认目录路径。
3. 区分国内节点与海外节点：大部分CDN支持按区域刷新。请先查看你的域名是否已开启海外加速，并在清理时选择“海外”或“全球（含海外）”区域，避免只清理了国内节点。

分三步完成海外节点缓存清理

以下操作以主流CDN控制台为例，其他服务商大同小异。
如果遇到差异，可参考服务商官方文档。

第一步：登录控制台进入缓存刷新界面

1. 登录CDN服务商后台，找到你的加速域名。
2. 点击域名进入详情，找到刷新预热或缓存刷新菜单。
3. 确认你当前所在的区域范围是“全球”或至少勾选了“海外节点”。部分面板会默认只勾选“国内”，需要手动改为“海外”。

第二步：选择刷新方式并提交任务

大多数CDN支持两种刷新方式：

• URL刷新：精确指定一个或多个资源的完整URL（推荐）。

*示例*：https://cdn.yourdomain.com/images/banner.png

• 目录刷新：刷新某个目录下的全部文件（谨慎使用，可能触发较大回源压力）。

*示例*：https://cdn.yourdomain.com/static/

操作细节：

• 在输入框中粘贴你要刷新的资源URL（每行一个）。
• 如果资源带有动态参数（如 ?v=202501），清理时建议带上参数，否则旧版本的URL无参数可能仍然被缓存。
• 点击“提交”后，任务会进入队列。大多数服务商会显示“刷新任务已提交，预计5-10分钟生效”。

第三步：等待并确认任务执行状态

回到刷新记录页面，查看任务状态是否从“处理中”变为“已完成”。
如果超过30分钟仍是“处理中”，建议检查是否选择了正确的区域（海外节点）。
少数情况下，海外节点更新需10-20分钟。

常见错误与避坑指南

误区1：只清理国内节点，导致海外用户仍看到旧缓存

• 解决办法：提交刷新任务时必须明确选择“海外节点”或“全球”，不要勾选仅国内。

误区2：刷新整个目录导致大量回源请求，影响网站性能

• 解决办法：优先使用URL刷新，只更新修改过的文件；如果必须刷新整个目录，建议在访问低峰期操作，并关注回源带宽。

误区3：刷新后立刻验证发现没生效

• 原因：CDN节点有生效延迟（通常在5-10分钟）。部分服务商海外节点延迟可能更久。另外浏览器本地缓存也可能干扰验证。
• 解决办法：使用无痕模式或curl命令行验证：

  curl -I https://cdn.yourdomain.com/path/to/file.js

检查响应头中的 X-Cache（或 x-cache-status）字段，如果显示 MISS 或 HIT from origin 说明已更新；
若仍显示 HIT 且是旧版本，则可能未刷新成功，需重新提交任务并确认区域选择。

误区4：没有考虑HTTP缓存头

• CDN默认遵循源站的 Cache-Control。如果源站设置了强缓存（例如 max-age=86400），即使你刷新了CDN缓存，源站侧仍可能返回旧版本。建议同时清理源站上游的缓存（如若使用宝塔则清理Nginx缓存），或临时修改响应头。

验证缓存清理是否真的生效

验证是检验操作是否成功的最后一步，推荐以下两种方式：

方法一：使用在线检测工具

• 打开第三方网站（例如 ping.chinaz.com或ce.cloud.tencent.com），选择几个位于海外的节点（如美国、欧洲、新加坡）。
• 输入资源URL，检测其响应状态和文件内容。若显示最新内容，则清理成功。

方法二：本地curl命令带指定IP测试

如果你知道某个海外节点IP，可以直接指定验证：

curl -H "Host: cdn.yourdomain.com" http://海外节点IP/path/to/file.js

对比文件最后的修改时间或哈希值，判断是否已更新。

常见问题解答

Q：清除了海外节点缓存，为什么国内用户看到的内容也变了？
A：如果选择了“全球”区域刷新，国内和海外会被一起清理。如果你只想清理海外，务必在刷新页面选择“仅海外”。

Q：能否通过API自动执行海外节点缓存清理？
A：主流CDN都提供API。以阿里云CDN为例，调用 RefreshObjectCaches 接口时，参数 Area 设为 overseas 即可。具体API可以查看官方文档，通常需要在代码中传入AccessKey。

Q：海外节点缓存清理有数量限制吗？
A：每家服务商不同。例如腾讯云CDN海外节点每天有5000条URL刷新的免费额度，目录刷新300条。超出后可能收费或拒绝任务，请提前了解配额。

如果你正在处理类似的海外缓存问题，建议先按本文步骤完整执行一次，再根据你的CDN服务商做微调。
遇到异常时优先回看避坑和高频问题部分，一般都能解决。