进入 CDN 缓存刷新设置
在 WordPress 后台进入「瓜奇 → CDN缓存刷新」。如果后台连接多个前端，先确认当前设置对应的网站。
CDN 会在网站外层保存内容副本，加快访问。启用自动刷新后，Node 会根据缓存事件先使本地页面缓存失效，再调用所选 CDN 的刷新接口。页面随后被访问时，再重新生成。
此处用于连接已有的 CDN 刷新服务，不负责开通 CDN 或修改 DNS。操作前需要有管理设置权限的后台账号，以及目标 CDN 站点的刷新凭据。
启用自动刷新并选择平台
- 打开「启用CDN自动刷新」。
- 在「CDN平台」中选择网站实际使用的平台：EdgeOne、Cloudflare 或自定义接口。
- 填写该平台对应的字段，再保存配置。
| 平台 | 字段 | 填写说明 |
|---|---|---|
| EdgeOne | EdgeOne Zone ID | 填写承载目标网站的 EdgeOne 站点 ID。 |
| EdgeOne | 腾讯云 SecretId、SecretKey | 填写配套的访问凭据，并确认账号有权刷新目标站点。 |
| EdgeOne | EdgeOne API 区域 | 按账号和服务选择「国际站」或「中国站」，默认是国际站。这里选择的是 API 站点，不是填写网站域名。 |
| Cloudflare | Cloudflare Zone ID | 填写目标域名所属区域的 Zone ID。 |
| Cloudflare | Cloudflare API Token | 令牌需要 Zone.Cache Purge 权限，区域资源选择目标域名对应的特定区域。 |
| 自定义 | 刷新API地址 | 填写使用 HTTPS 的刷新接口地址。系统会向该地址发送 POST 请求。 |
| 自定义 | Token | 可选。填写后，系统通过 Authorization: Bearer 方式传递。 |
自定义接口需要能接收瓜奇发送的 JSON 刷新计划，并按计划处理缓存。它不是填入任意平台 API 地址就能使用；应由接口提供方确认请求格式和认证方式。
保存后验证刷新是否生效
- 重新打开设置，确认平台、站点 ID 和相关字段已保存。
- 修改一篇容易识别的内容，记录保存时间，以及目标语言页面的完整网址。
- 确认运行前端的 Node 服务已经取得新内容或配置。
- 检查该服务处理缓存事件和调用 CDN 的结果，再打开实际网址验证。
- 同一后台连接多个网站时，分别检查受影响的域名和语言页面。
刷新失败时，先根据错误检查凭据、权限、站点 ID、API 区域或接口地址。当前机制会保留失败事件的处理进度，修复配置后可重新处理；保存设置本身不能证明 CDN 已刷新成功。
仍看到旧页面时按这个顺序检查
- 后台内容：重新打开编辑页，确认修改已经保存，目标语言记录也正确。
- 前端服务：确认 Node 返回的页面已经更新。如果源页面仍旧，CDN 刷新后也会再次取得旧内容。
- CDN 目标：核对刷新的是正确域名和路径。不同语言路径、不同前端域名不能当作同一个缓存对象。
- 浏览器与图片：页面更新后图片仍旧时，检查图片自身的缓存。替换同地址图片，不能只验证文章页面刷新。
注意刷新范围
系统按事件决定刷新指定路径还是整个目标前端的缓存，并非每次内容变化都会刷新所有网站。某个网站没有变化时，先检查它是否属于本次更新范围，以及是否使用正确的 CDN 配置。
关闭 CDN 自动刷新，不代表 Node 本地页面缓存也停止更新。两者属于不同处理环节；排查时应分别确认结果。