CDN缓存键规则配置

一、配置核心作用

二、两大核心配置功能

1. 忽略参数（核心）

• 不忽略：保留所有 URL 参数及值作为缓存键，适用于参数影响资源内容的场景（如1.jpg?version=1和1.jpg?version=2为不同资源）；
• 全部忽略：仅以?前的 URL 路径作为缓存键，适用于参数仅做认证 / 统计、不影响资源内容的场景（如音视频的签名 / 时间戳参数）；
• 保留指定参数：仅将指定的关键参数纳入缓存键，其余忽略；
• 忽略指定参数：排除指定的无用参数，其余参数纳入缓存键；
   

  后两种适用于 URL 同时包含影响资源的关键参数和无影响的冗余参数（如1.jpg?version=1&time=123，保留version、忽略time）。

2. 忽略大小写

三、配置操作基础

1. 查看 / 配置路径：登录 CDN 控制台→域名管理→选中域名点击「管理」→缓存配置标签页，找到缓存键规则配置；
2. 默认规则：添加域名时，默认规则随业务类型自动配置：
   • 网页小文件：默认不忽略参数、忽略大小写为否；
   • 下载大文件 / 音视频点播：默认全部忽略参数；
      

     默认规则不可删除 / 修改类型和内容，仅可修改忽略参数、忽略大小写配置；

    
3. 核心操作：支持新增 / 修改 / 删除自定义规则，可手动调整规则优先级。

四、核心配置约束

1. 数量约束：单个域名最多添加20 条规则（包含系统默认规则）；
2. 内容约束：单条规则的文件后缀 / 目录 / 全路径内容，最多填 100 组，多内容用英文分号； 分隔；
3. 参数约束：选择保留 / 忽略指定参数时，单条规则最多填 30 个参数名，每个参数名不超过 20 字符，多参数用；分隔；
4. 优先级约束：列表底部规则优先级高于顶部，默认规则不可调整优先级；
5. 规则修改：自定义规则可全量修改 / 删除，默认规则仅支持修改忽略参数、忽略大小写。

五、配置示例（生效逻辑）

• 默认规则：全部文件，不忽略参数，忽略大小写为否；
• 自定义规则：文件后缀jpg;png，全部忽略参数，忽略大小写为否。
   

  实际访问效果：

1. 请求abc.jpg?version=1&colour=red：因匹配 jpg 规则，全部忽略参数，缓存键为www.test.com/abc.jpg，回源缓存该资源；
2. 请求abc.JPG?version=1&colour=red：因未开启忽略大小写，无法匹配上述缓存键，且默认规则为不忽略参数，缓存键为www.test.com/abc.JPG?version=1&colour=red，重新回源缓存。

六、规则匹配逻辑