CDN
清除Kapsule CDN缓存
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
清除 Kapsule CDN 缓存
清除操作会删除边缘节点上存储的内容副本，以便下一位访问者获得从源站新获取的版本。当您发布了更改但旧版本仍在显示时，您就需要进行清除操作。
缓存是使 CDN 快速运行的原因，也是您刚刚所做的更改可能不会立即显示的原因。与其将缓存生命周期设置为零，不如保持缓存生命周期较长，然后按需清除。本指南涵盖了这两方面的内容，以及如何区分边缘缓存和浏览器缓存，这样您就不会在错误的地方浪费时间。
何时需要清除
在您更改了访问者通过 URL 获取的内容后进行清除：
- 您替换了一个 CSS 或 JavaScript 文件，旧文件仍在被提供。
- 您将新版本的图像上传到了现有文件名上方。
- 您修复了页面上的错误，希望立即全局删除损坏的版本。
- 您更改了页面内容，无法等待边缘 TTL 过期。
当您添加了全新页面或新文件名时，您不需要进行清除。从未被请求过的 URL 不会被缓存。
如果您对资源文件名进行了版本管理（style.a1b2c3.css 而不是 style.css），您几乎不需要进行清除。新文件名就是新 URL，因此它从您的源站新获取并在其自己的密钥下缓存。
清除控制的位置
- 登录 KPanel。
- 在左侧边栏中点击网站，然后点击您的站点。
- 在站点的菜单中，打开性能，然后打开 Kapsule CDN。
- 滚动到清除缓存卡片。
直接地址是 /websites/<site-id>/cdn。
清除控制只有在为站点启用 CDN 后才会显示。如果页面显示此站点的 CDN 已关闭横幅，或要求您连接自定义域，则边缘节点上没有任何内容可以清除。Kapsule CDN 也是一个计划权限，因此运行 Orbit 或容器托管计划的站点根本没有 CDN。在您的站点上启用 Kapsule CDN列出了包含它的确切计划。
清除单个 URL
- 在清除缓存卡片中，将完整的公共 URL 输入要清除的 URL（留空则清除整个站点）。该字段的占位符显示了预期的格式：
https://your-domain.tld/path。 - 点击清除。
- 出现确认信息，显示"已清除"，后跟您输入的 URL。
使用访问者会请求的确切 URL，包括方案（https://）、主机和路径。清除操作是基于 URL 匹配的，因此 https://example.com/about 和 https://example.com/about/ 是两个不同的缓存条目，附加查询字符串的同一页面也是如此。
当您确切知道什么被更改了时，清除单个 URL 是正确的第一步。它是即时的，并且使您的其余缓存保持完整，因此站点的其余部分保持快速。
清除整个站点
- 将要清除的 URL 字段完全留空。
- 点击清除。
- 确认信息显示"已清除完整缓存"。
完整清除会删除每个边缘位置处站点的所有缓存对象。在每个 URL 被再次请求之前，每位访问者都从您的源站获得服务，因此源站会承受一波流量突增，并且每个页面的第一位访问者会等待完整往返。在流量繁忙的站点上，建议仅清除您更改的特定 URL。
您运行的每次清除都会记录在账户的活动日志中，包含 URL 或完整区域标记，因此您可以看到谁、何时清除了什么。
缓存生命周期及其相互作用
同一页面上的缓存 TTL 卡片控制内容在清除前能存活多久：
| 设置 | 它控制的内容 | 默认值 |
|---|---|---|
| 边缘 TTL（秒） | 边缘在从源站重新获取之前保留副本的时长 | 3600（1 小时） |
| 浏览器 TTL（秒） | 访问者的浏览器保留其自己的本地副本的时长 | 3600（1 小时） |
两者是独立的，这是最常见的混淆来源。清除操作清除的是边缘。它无法到达访问者的浏览器内。如果您清除后仍看到旧版本，您几乎肯定是在查看您自己的浏览器缓存。
要排除这一点，在隐私或无痕窗口中加载页面，或进行硬刷新。如果隐私窗口显示新版本，则清除有效，您只需等待您自己的浏览器和其他访问者的浏览器，它们将在各自的浏览器 TTL 过期后刷新。
如果您频繁发布且无法对文件名进行版本管理，请将浏览器 TTL 降低到较短的时间（几分钟），并保持边缘 TTL 较长。您保留了大部分边缘优势，同时为访问者提供了一个更短的时间窗口，在此窗口内他们可能会停留在旧副本上。
图像优化和清除
如果实时图像优化已启用，边缘会与原始图像一起存储每个图像的优化派生版本。清除图像 URL 也会清除派生版本，因此替换的图像会在下次请求时重新优化。优化图像没有单独的清除。
这同样适用于为支持的浏览器提供 WebP：WebP 变体存储在相同 URL 下，由相同的清除删除。
故障排除
"此站点未配置 CDN。" 该站点还没有边缘区域。首先启用 CDN，并等待证书完成配置。
"清除失败。" 清除请求未到达边缘。等待一段时间后重试。如果持续失败，边缘区域可能正在配置中；检查页面是否显示 CDN 已启用横幅。
我清除后页面仍然是旧版本。 首先在隐私窗口中检查。如果隐私窗口也显示旧版本，请确认您清除的是确切的 URL（包括任何尾部斜杠和查询字符串），然后尝试完整清除。
只有某些访问者看到更新。 他们的浏览器仍在浏览器 TTL 内。没有问题：当 TTL 过期时或立即硬刷新时，他们会获取新版本。
完整清除后源站出现故障。 这是上述未缓存流量突增导致的。提高边缘 TTL，下次仅清除更改的 URL。提高网站速度涵盖了使源站本身更具弹性的方法。
如果清除成功但边缘在数分钟后仍继续提供旧内容，请发送电子邮件至 support@kapsulehost.com，包含确切的 URL 和清除的时间。