URL 请求中 ? 后的参数可能影响缓存命中率。开启忽略参数功能后,DCDN 节点在匹配缓存时去除 URL 中 ? 后的参数,提高缓存命中率并减少回源次数。
注意事项
功能冲突
自定义Cachekey功能和忽略参数功能存在配置冲突,请勿同时开启。
开启忽略参数功能后,无论选择保留指定参数模式还是删除指定参数模式,DCDN 节点都会修改缓存键中的参数部分。此时自定义Cachekey功能中的请求参数设置将失效。
如需使用自定义Cachekey配置缓存键,请先关闭忽略参数功能。
使用自定义Cachekey替代
自定义Cachekey功能可实现忽略参数功能的所有缓存键配置效果,且支持更灵活的参数控制。推荐使用自定义Cachekey代替忽略参数。以下为两种功能的配置方式对比:
使用场景 | 忽略参数配置方式 | 自定义Cachekey配置方式 |
在缓存键中忽略所有请求参数 | 忽略参数设置为是,保留指定参数为空 | 添加一条请求参数处理策略:操作方式设置为保留,参数名设置为任意不存在的参数名 |
在缓存键中仅保留请求参数 | 忽略参数设置为是,保留指定参数设置为 | 添加一条请求参数处理策略:操作方式设置为保留,参数名设置为 |
在缓存键中仅删除请求参数 | 删除指定参数设置为 | 添加一条请求参数处理策略:操作方式设置为删除,参数名设置为 |
功能说明
忽略参数功能包含两个子功能:忽略参数和保留回源参数。
忽略参数
开启后,DCDN 节点匹配缓存时去除 URL 中
?后的参数。不同用户即使携带不同参数访问同一资源,也能命中同一缓存文件。场景
说明
URL 携带用户标识等参数,但参数与资源内容无关
例如 A 用户访问
http://example.com/1.jpg?uid=123,B 用户访问http://example.com/1.jpg?uid=654。开启忽略参数后,DCDN 节点使用http://example.com/1.jpg匹配缓存,两个请求均可命中同一缓存文件。保留回源参数
场景
说明
开启忽略参数后,需要将用户信息传递给源站
开启忽略参数后,DCDN 默认使用去除参数后的 URL 回源。开启保留回源参数后,DCDN 使用原始 URL(含
?后参数)回源,将用户信息传递给源站。
忽略参数包含两种模式(保留指定参数、删除指定参数),开启忽略参数处理流程图如下所示:
URL鉴权功能的优先级高于忽略参数。由于鉴权方式A中的鉴权信息包含HTTP请求的参数部分,所以全站加速优先进行鉴权判断,鉴权通过后在全站加速节点缓存一份副本。配置URL鉴权的操作方法,请参见配置URL鉴权。
操作步骤
登录DCDN控制台。
在左侧导航栏,单击域名管理。
在域名管理页面,单击目标域名对应的配置。
在指定域名的左侧导航栏,单击性能优化。
单击忽略参数区域的修改配置,根据实际需求选择模式并完成配置。
说明切换模式将删除原有配置。
模式:保留指定参数

参数
说明
示例
过滤参数
是:去除 URL 中
?后的参数,提高缓存命中率。说明如果仅配置忽略参数,不设置具体的保留指定参数时,表示去除
?之后的所有参数。否:需精确匹配 URL 中
?后的参数。
假设原始 URL 为
http://example.com/1.jpg?key1=1&key2=2&key3=3:忽略所有参数 + 使用处理后的 URL 回源
配置:忽略参数设置为是,保留指定参数为空,保留回源参数设置为否。
缓存 key:
http://example.com/1.jpg回源 URL:
http://example.com/1.jpg保留指定参数 + 使用处理后的 URL 回源
配置:忽略参数设置为是,保留指定参数设置为
key1,保留回源参数设置为否。缓存 key:
http://example.com/1.jpg?key1=1回源 URL:
http://example.com/1.jpg?key1=1忽略所有参数 + 使用原始 URL 回源
配置:忽略参数设置为是,保留指定参数为空,保留回源参数设置为是。
缓存 key:
http://example.com/1.jpg回源 URL:
http://example.com/1.jpg?key1=1&key2=2&key3=3保留指定参数 + 使用原始 URL 回源
配置:忽略参数设置为是,保留指定参数设置为
key1,保留回源参数设置为是。缓存 key:
http://example.com/1.jpg?key1=1回源 URL:
http://example.com/1.jpg?key1=1&key2=2&key3=3
保留指定参数
配置需要保留的参数,最多配置 10 个,多个参数用英文逗号(
,)分隔。设置保留指定参数为
key1后,URL 中仅保留key1参数用于缓存匹配。保留回源参数
是:回源请求中保留原始 URL 的所有参数。
否:回源请求中携带的参数与缓存 key 的参数一致(即仅保留指定的参数)。
参见上方示例三和示例四的回源 URL 差异。
模式:删除指定参数
参数
说明
示例
删除指定参数
配置需要删除的参数,最多配置 10 个,多个参数用空格分隔。
假设原始 URL 为
http://example.com/1.jpg?key1=1&key2=2&key3=3:删除指定参数 + 使用处理后的 URL 回源
配置:删除指定参数设置为
key1,保留回源参数设置为否。缓存 key:
http://example.com/1.jpg?key2=2&key3=3回源 URL:
http://example.com/1.jpg?key2=2&key3=3删除指定参数 + 使用原始 URL 回源
配置:删除指定参数设置为
key1,保留回源参数设置为是。缓存 key:
http://example.com/1.jpg?key2=2&key3=3回源 URL:
http://example.com/1.jpg?key1=1&key2=2&key3=3
保留回源参数
是:回源请求中保留原始 URL 的所有参数。
否:回源请求中携带的参数与缓存 key 的参数一致(即删除了指定的参数)。
参见上方示例一和示例二的回源 URL 差异。
单击确定。