跳转至

配置缓存函数

CDN 2.0 通过缓存函数(Cache Function)管理缓存规则。当前支持的类型为缓存键规则,可为不同文件后缀配置是否忽略查询参数等缓存行为。

说明:域名详情页的“缓存配置”Tab 当前已关闭,缓存规则请通过 CDN 2.0 → 函数管理 创建并关联到域名。

适用场景

  • 希望静态资源(如图片、CSS、JS)被 CDN 长期缓存。
  • 希望忽略 URL 中的部分查询参数,以提高缓存命中率。
  • 希望不同文件后缀采用不同的缓存 TTL。

前提条件

  • 已添加加速域名。
  • 了解源站内容类型与缓存策略,避免误缓存动态内容。

创建缓存函数

  1. 进入 CDN 2.0 → 函数管理 页面。
  2. 单击 新增函数
  3. 选择模板 缓存键规则
  4. 填写函数信息:
  5. 名称
  6. 备注(可选)
  7. 配置缓存规则:
  8. 文件后缀:如 .jpg.png.css.js
  9. 忽略查询参数:开启后,URL 中的查询参数不会影响缓存键。
  10. 缓存时间:内容在 CDN 边缘的缓存时长。
  11. 单击下一步并保存。

验证结果:函数管理列表中显示新创建的缓存函数。

关联缓存函数到域名

  1. 在函数管理列表中,找到目标缓存函数。
  2. 单击 编辑 或进入详情。
  3. 在关联域名区域,选择需要应用该缓存规则的域名。
  4. 保存配置。

注意:关联域名后,域名会重新同步到 CDN。同步期间域名状态可能短暂显示为 部署中

验证结果:域名详情中显示已关联的缓存函数,或访问对应文件时响应头体现缓存规则(具体以控制台实现为准)。

编辑与删除缓存函数

编辑

  1. 在函数管理列表中,单击目标函数的 编辑
  2. 修改缓存规则或关联域名。
  3. 保存。

删除

  1. 在函数管理列表中,单击目标函数的 删除
  2. 确认删除。

警告:删除缓存函数会解除其与所有域名的关联,已应用的缓存规则将被移除。删除前请确认业务影响。

注意事项

  • 缓存规则对所有关联域名生效,请确保规则适用于这些域名。
  • 缓存时间越长,回源请求越少,但内容更新后生效时间也越长。对于经常更新的内容,建议缩短缓存时间或配合 清除缓存 使用。
  • 忽略查询参数可能会影响依赖查询参数返回不同内容的动态接口,请谨慎配置。

常见问题

修改缓存函数后多久生效

修改缓存函数会触发关联域名重新同步,同步完成后规则生效。通常需要几分钟到十几分钟。

能否为不同域名设置不同缓存规则

可以。创建多个缓存函数,分别关联不同的域名即可。

缓存规则未生效如何排查

  • 确认缓存函数已关联目标域名。
  • 确认域名已完成部署,状态为 开启
  • 使用浏览器开发者工具查看响应头,确认缓存相关字段。
  • 若仍不生效,请联系技术支持。