开启忽略参数功能后,CDN节点在处理用户请求时,会去除请求URL中携带在?之后的参数(例如:用户身份信息、访问渠道信息),以原始URL来生成缓存hashkey。由此可以有效提高文件缓存命中率,提升分发效率。本文为您详细介绍配置忽略参数的方法。
功能对比与选择
自定义Cache Key与忽略参数存在冲突:同时配置忽略参数和自定义 Cache Key 的情况下,忽略参数功能将会失效。
自定义Cache Key可替代忽略参数的缓存键配置,且功能更全面,推荐优先使用。配置对比:
场景
忽略参数配置
自定义Cache Key配置
在缓存键中忽略所有请求参数
忽略参数设置为是,保留指定参数留空
添加一条请求参数处理策略:
操作方式:保留
参数名:设为任意不存在的参数名,例如 example-argument
在缓存键中仅保留请求参数key1
忽略参数设置为是,保留指定参数设置为
key1添加一条请求参数处理策略:
操作方式:保留
参数名:key1
在缓存键中仅删除请求参数key1
删除指定参数设置为
key1添加一条请求参数处理策略:
操作方式:删除
参数名:key1
重写回源参数可替代忽略参数的回源参数重写,且功能更全面,推荐优先使用。
功能介绍
忽略参数
作用 | 适用场景 |
去除请求 URL 参数( | 当 URL 参数与资源内容无关(如用户 UID、渠道来源、推荐码等),建议开启忽略参数。例如,以下两个请求访问同一资源但携带不同 UID: A 用户: B 用户: 未开启忽略参数时,CDN 节点会将 A、B 用户的 URL 视为不同资源,无法命中同一缓存,每次都需回源。开启忽略参数后,CDN 节点会去除 URL 参数,统一使用 |
配置URL鉴权的优先级高于忽略参数。鉴权方式A的鉴权信息包含URL参数部分,CDN会先完成鉴权判断,通过后再缓存副本。
保留回源参数
作用 | 适用场景 |
回源时保留原始 URL 全部参数,确保源站能接收到用户的关键信息。 | 开启忽略参数后,CDN 节点默认使用去除参数后的 URL 回源。以上述示例为例,A、B 用户的回源请求都使用 |
操作步骤
登录视频点播控制台。
在左侧导航栏选择配置管理 > 分发加速配置 > 域名管理,进入到域名管理页面。
在域名管理页面,单击目标域名操作列的配置。
在域名的左侧导航栏,单击性能优化。
在忽略参数区域,单击修改配置。
请根据您的实际需求配置过滤模式、过滤参数等配置项。
配置项和说明如下表所示。
重要切换过滤模式,原有配置会被删除。
过滤模式:保留指定参数
参数
说明
示例
忽略参数
是:开启忽略参数功能,用户请求回源时会去除URL中
?之后的参数。说明如果仅开启过忽略参数开关,不设置具体的保留指定参数时,表示去除
?之后的所有参数。否:关闭忽略参数功能。
假设原始URL为
http://example.com/1.jpg?key1=1&key2=2&key3=3,实现特定的功能场景,设置参数后,原始URL经CDN处理后结果如下:示例一,过滤所有参数+使用忽略参数处理后的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个保留参数,多个参数用英文逗号(,)分隔 。
保留回源参数
是:在回源请求中保留原始请求URL中的所有参数。
否:在回源请求中携带的参数与缓存hashkey的参数一致(即,保留了指定的参数)。
过滤模式:删除指定参数
参数
说明
示例
删除指定参数
配置需要删除的参数,最多可以配置10个参数,多个参数用空格作分隔符。
假设原始URL为
http://example.com/1.jpg?key1=1&key2=2&key3=3,实现特定的功能场景,设置参数后,原始URL经CDN处理后结果如下:示例一,删除指定参数+使用忽略参数处理后的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中的所有参数。
否:在回源请求中携带的参数与缓存hashkey的参数一致(即,删除了指定的参数)。
单击确定,完成配置。