忽略参数

更新时间:
复制为 MD 格式

URL 请求中 ? 后的参数可能影响缓存命中率。开启忽略参数功能后,DCDN 节点在匹配缓存时去除 URL 中 ? 后的参数,提高缓存命中率并减少回源次数。

注意事项

功能冲突

重要

自定义Cachekey功能和忽略参数功能存在配置冲突,请勿同时开启。

开启忽略参数功能后,无论选择保留指定参数模式还是删除指定参数模式,DCDN 节点都会修改缓存键中的参数部分。此时自定义Cachekey功能中的请求参数设置将失效。

如需使用自定义Cachekey配置缓存键,请先关闭忽略参数功能。

使用自定义Cachekey替代

自定义Cachekey功能可实现忽略参数功能的所有缓存键配置效果,且支持更灵活的参数控制。推荐使用自定义Cachekey代替忽略参数。以下为两种功能的配置方式对比:

使用场景

忽略参数配置方式

自定义Cachekey配置方式

在缓存键中忽略所有请求参数

忽略参数设置为,保留指定参数为空

添加一条请求参数处理策略:操作方式设置为保留,参数名设置为任意不存在的参数名

在缓存键中仅保留请求参数key1

忽略参数设置为,保留指定参数设置为key1

添加一条请求参数处理策略:操作方式设置为保留,参数名设置为key1

在缓存键中仅删除请求参数key1

删除指定参数设置为key1

添加一条请求参数处理策略:操作方式设置为删除,参数名设置为key1

功能说明

忽略参数功能包含两个子功能:忽略参数和保留回源参数。

  • 忽略参数

    开启后,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(含 ? 后参数)回源,将用户信息传递给源站。

忽略参数包含两种模式(保留指定参数、删除指定参数),开启忽略参数处理流程图如下所示:

image
说明

URL鉴权功能的优先级高于忽略参数。由于鉴权方式A中的鉴权信息包含HTTP请求的参数部分,所以全站加速优先进行鉴权判断,鉴权通过后在全站加速节点缓存一份副本。配置URL鉴权的操作方法,请参见配置URL鉴权

操作步骤

  1. 登录DCDN控制台

  2. 在左侧导航栏,单击域名管理

  3. 域名管理页面,单击目标域名对应的配置

  4. 在指定域名的左侧导航栏,单击性能优化

  5. 单击忽略参数区域的修改配置,根据实际需求选择模式并完成配置。

    说明

    切换模式将删除原有配置。

    • 模式:保留指定参数

      image

      参数

      说明

      示例

      过滤参数

      • :去除 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 差异。

  6. 单击确定