配置忽略参数
更新时间:2025-04-11
概述
HTTP请求参数是指URL中“?”后面的部分,您可以使用忽略参数缓存灵活的控制请求参数是否参与资源的缓存与查找,比如只保留对资源内容有影响的参数,将同一个资源的一类请求转化为统一的缓存键并命中同一份缓存,以提升命中率。
注意事项
- 开启此功能可忽略URL参数参与缓存,提高文件缓存命中率,也有可能略过Key的重要信息,请根据业务需要合理设置。
- 忽略参数功能不会修改回源的URL,仅会修改请求的缓存标识,回源的请求和客户端发起的请求内容会保持一致。
- 默认规则:全部文件默认全部忽略
- 功能冲突:忽略参数功能包含URL配置功能,不再支持URL配置新增忽略参数,原有配置不受影响,此处配置优先级高于URL配置功能。
- 匹配顺序:按照配置列表中的配置,从上到下顺序匹配,命中某一条以后就不再继续向下匹配。
- 配置数量:默认规则外,单个域名至多新增10条规则。
操作指南
- 登录CDN管理控制台,登录CDN管理控制台,在菜单栏里选择域名管理,单击对应域名右侧管理按钮,即可进入域名配置页面。
- 进入“CDN域名详情”页,在页面上方导航栏选择缓存配置页签。
- 在忽略参数配置模块中点击编辑,进行具体规则配置。
规则说明
条件参数
参数 | 说明 |
---|---|
类型 | 支持类型:URL、文件后缀、文件目录
|
内容 |
|
生效规则 | 包含条件值中任意一个 |
忽略URL参数
参数状态 | 说明 |
---|---|
全部忽略 | 在CDN生成和查找资源的缓存时,会去除URL中 ? 之后的部分。即PATH相同但请求参数不同的请求,会被CDN视为同一资源。
|
不忽略 | 所有HTTP请求参数会参与缓存的存储和查找,带有不同请求参数的URL,即便PATH部分相同也会被视为不同资源。 |
保留指定参数 | 指定的部分参数参与缓存的存储和查找。 |
忽略指定参数 | 除了指定的部分参数外的其他参数参与缓存的存储和查找。 |
注:保留/忽略指定参数最多输入30个,多个参数逗号隔开。
配置举例
例如我们设定 http://cloud.baidu.com/1.jpg?test=1
请求URL到CDN节点:
-
配置全部忽略:
- 用户第一次访问
http://cloud.baidu.com/1.jpg
,CDN没有缓存,直接回源访问数据;第二次访问http://cloud.baidu.com/1.jpg?test=1
,由于开启了过滤参数,所以“?”后的参数无需匹配,即可命中CDN缓存http://cloud.baidu.com/1.jpg
。
- 用户第一次访问
-
配置保留参数test:
- 带有不同test参数的请求,即便PATH部分相同,也会被视为不同资源。例如:请求
http://cloud.baidu.com/1.jpg?test=1
和http://cloud.baidu.com/1.jpg?test=2
会被CDN视为不同的资源。 - 其他未指定的保留参数则会被忽略,例如:请求
http://cloud.baidu.com/1.jpg?class=1
和http://cloud.baidu.com/1.jpg?class=2
会被CDN视为同一资源。
- 带有不同test参数的请求,即便PATH部分相同,也会被视为不同资源。例如:请求
-
配置忽略指定参数test:
- 如果两个请求只是test参数不同,仍然会被CDN视为同一资源。例如:
http://cloud.baidu.com/1.jpg?test=1
和http://cloud.baidu.com/1.jpg?test=2
会被CDN视为同一资源。 - 除了test外的其他参数不同的请求,都会被视为不同资源。例如:请求
http://cloud.baidu.com/1.jpg?class=1
和http://cloud.baidu.com/1.jpg?class=2
会被CDN视为不同的资源。
- 如果两个请求只是test参数不同,仍然会被CDN视为同一资源。例如:
- 如果选择不忽略,则HTTP请求参数不同的请求都会CDN被视为不同资源。