穗驰CDN

缓存规则配置

使用穗驰 CDN 缓存开关、场景预设和规则顺序控制边缘缓存行为。

缓存规则位于站点详情页的“缓存规则”。规则按列表顺序匹配,命中后执行强制缓存、遵循源站或不缓存动作。修改后平台会自动保存并同步到边缘节点。

默认策略

规则数量和默认策略会随站点配置变化,建议先查看列表顺序,再确认每条规则的匹配条件和动作:

内容默认动作默认时间
/admin//api/不缓存-
图片、字体强制缓存30 天
CSS、JS、Map强制缓存7 天
音视频、文档下载强制缓存7 天
HTML、站点根路径强制缓存1 小时

动态接口、后台路径和带用户状态的页面不要直接设置成长时间缓存。

配置步骤

1. 打开缓存规则

进入站点详情页,点击左侧“缓存规则”。先确认“启用边缘缓存”处于开启状态;关闭总开关只会停止写入边缘缓存,现有规则仍会保留。

2. 选择场景预设

“场景预设”适合新站点快速建立基础规则。应用预设会完整替换当前规则列表,不会自动合并旧规则,已有自定义规则时应先记录配置。

3. 添加或调整规则

点击“添加规则”,按业务选择后缀、目录前缀或路径匹配,再选择缓存动作和时间。规则从上到下优先匹配,因此更具体的路径应放在通用后缀规则之前。

例如 /api/ 不缓存应排在通用的 json 或静态资源规则之前,避免接口响应被错误缓存。

4. 发布后验证

保存后等待边缘节点同步,再通过响应头或访问日志确认命中情况。修改缓存时间后,旧节点内容不会自动立即消失,需要配合刷新与预热清理旧缓存。

配置注意事项

  • 用户登录态、购物车、订单和管理后台页面通常应设置为不缓存。
  • 文件名带版本号或内容哈希的静态资源适合长缓存;文件名不变的资源应使用较短时间。
  • 规则模板会覆盖现有列表,误应用前先确认当前规则是否需要保留。
  • 缓存命中率异常时,先检查规则顺序、查询参数策略和源站响应头。

On this page