配置缓存函数¶
CDN 2.0 通过缓存函数(Cache Function)管理缓存规则。当前支持的类型为缓存键规则,可为不同文件后缀配置是否忽略查询参数等缓存行为。
说明:域名详情页的“缓存配置”Tab 当前已关闭,缓存规则请通过 CDN 2.0 → 函数管理 创建并关联到域名。
适用场景¶
- 希望静态资源(如图片、CSS、JS)被 CDN 长期缓存。
- 希望忽略 URL 中的部分查询参数,以提高缓存命中率。
- 希望不同文件后缀采用不同的缓存 TTL。
前提条件¶
- 已添加加速域名。
- 了解源站内容类型与缓存策略,避免误缓存动态内容。
创建缓存函数¶
- 进入 CDN 2.0 → 函数管理 页面。
- 单击 新增函数。
- 选择模板 缓存键规则。
- 填写函数信息:
- 名称
- 备注(可选)
- 配置缓存规则:
- 文件后缀:如
.jpg、.png、.css、.js。 - 忽略查询参数:开启后,URL 中的查询参数不会影响缓存键。
- 缓存时间:内容在 CDN 边缘的缓存时长。
- 单击下一步并保存。
验证结果:函数管理列表中显示新创建的缓存函数。
关联缓存函数到域名¶
- 在函数管理列表中,找到目标缓存函数。
- 单击 编辑 或进入详情。
- 在关联域名区域,选择需要应用该缓存规则的域名。
- 保存配置。
注意:关联域名后,域名会重新同步到 CDN。同步期间域名状态可能短暂显示为 部署中。
验证结果:域名详情中显示已关联的缓存函数,或访问对应文件时响应头体现缓存规则(具体以控制台实现为准)。
编辑与删除缓存函数¶
编辑¶
- 在函数管理列表中,单击目标函数的 编辑。
- 修改缓存规则或关联域名。
- 保存。
删除¶
- 在函数管理列表中,单击目标函数的 删除。
- 确认删除。
警告:删除缓存函数会解除其与所有域名的关联,已应用的缓存规则将被移除。删除前请确认业务影响。
注意事项¶
- 缓存规则对所有关联域名生效,请确保规则适用于这些域名。
- 缓存时间越长,回源请求越少,但内容更新后生效时间也越长。对于经常更新的内容,建议缩短缓存时间或配合 清除缓存 使用。
- 忽略查询参数可能会影响依赖查询参数返回不同内容的动态接口,请谨慎配置。
常见问题¶
修改缓存函数后多久生效¶
修改缓存函数会触发关联域名重新同步,同步完成后规则生效。通常需要几分钟到十几分钟。
能否为不同域名设置不同缓存规则¶
可以。创建多个缓存函数,分别关联不同的域名即可。
缓存规则未生效如何排查¶
- 确认缓存函数已关联目标域名。
- 确认域名已完成部署,状态为 开启。
- 使用浏览器开发者工具查看响应头,确认缓存相关字段。
- 若仍不生效,请联系技术支持。