一、概述

您可以在 CDN 控制台 或 DRCDN 控制台中，查看域名的配置信息，然后根据需要对域名的 忽略参数 进行修改。

注意：我们推荐您使用 CDN 控制台 管理 DRCDN 动态加速服务，功能更齐全，能够一站式管理 CDN 和 DRCDN 服务。

忽略参数 是指忽略 URL 请求“?”后面的参数进行缓存，您可以使用忽略参数灵活的进行版本控制，提高 CDN 的缓存命中率。

二、注意事项

开启此功能可忽略 URL 缓存参数，提高文件缓存命中率，也有可能略过 Key 的重要信息，请根据业务需要合理设置。

三、通过 CDN 控制台配置忽略参数

1. 登录CDN 控制台，点击 域名管理 ，进入域名管理页面。
2. 选择需要修改源站配置的域名，在右侧操作列点击 管理 。
3. 进入“CDN域名详情”页，在页面上方导航栏选择 缓存配置 页签。
4. 在 忽略参数 模块中点击 编辑 ，按照下表说明设置忽略 URL 参数。

忽略URL参数状态	说明
全部忽略	在 CDN 生成和查找资源的缓存时，会去除 URL 中 ? 之后的部分。即 PATH 相同但请求参数不同的请求，会被 CDN 视为同一资源。 如果分发的内容为静态资源，且 URL 中的 HTTP 请求参数不会影响响应内容，开启该功能可以有效提高文件缓存命中率，提升分发效率。 若参数有重要含义，例如包含文件版本信息等，推荐设置“保留参数”。您也可以设置多个保留参数。如请求中包含任一“保留参数”，会携保留参数回源，未指定的参数将不会被保留。
不忽略	所有 HTTP 请求参数会参与缓存的存储和查找，带有不同请求参数的 URL ，即便 PATH 部分相同也会被视为不同资源。
保留指定参数	指定的部分参数参与缓存的存储和查找。
忽略指定参数	除了指定的部分参数外的其他参数参与缓存的存储和查找。

5. 您可以在开启中设置保留参数，配置完点击保存即可完成忽略参数的配置。

注：保留/忽略指定参数最多输入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：

  • 如果两个请求只是 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 视为不同的资源。
• 如果选择 不忽略 ，则 HTTP 请求参数不同的请求都会 CDN 被视为不同资源。

四、通过 DRCDN 控制台配置忽略参数

1. 登录 DRCDN 管理控制台，进入“动态加速”页面。
2. 在左侧导航栏，点击 域名管理 。
3. 进入域名管理页面，点击目标域名操作列的 管理 。
4. 进入“ CDN 域名详情”页，在页面上方导航栏选择 缓存配置 页签。
5. 在 忽略参数 模块中点击 编辑 ，设置忽略 URL 参数 开启 或 关闭 。

忽略 URL 参数状态	说明
开启	该请求到 CDN 节点后会截取到没有参数的 URL 向源站请求，且 CDN 节点仅保留一份副本。 由于 http 请求中大多包含参数，但往往参数内容优先级不高，可以忽略参数浏览文件，适合开启该功能；开启后可以有效提高文件缓存命中率，提升分发效率。 若参数有重要含义，例如包含文件版本信息等，推荐设置“保留参数”。您可以设置多个保留参数。如请求中包含任一“保留参数”，会携保留参数回源，未指定的参数将不会被保留。
关闭	每个不同的 URL 都缓存不同的副本在 CDN 的节点上。

6. 您可以在开启中设置保留参数，配置完点击 保存 即可完成忽略参数的配置。

注：保留指定参数最多输入 10 个，多个参数逗号隔开，未指定的参数将不会被保留。

配置举例

例如我们设定 http://www.bcecdn.com/1.jpg?test=1 请求 URL 到 CDN 节点：

• 开启 忽略URL参数 后，如果没有配置保留参数，用户第一次访问http://www.bccdn.com/1.jpg，CDN 没有缓存，直接回源访问数据；第二次访问http://www.bccdn.com/1.jpg?test=1，由于开启了过滤参数，所以“?”后的参数无需匹配，即可命中 CDN 缓存http://www.bccdn.com/1.jpg。
• 如果配置保留参数 test ，则请求中含有参数 test 的 URL 都会缓存不同的副本在 CDN 的节点上，http://www.bccdn.com/1.jpg?test=1 和 http://www.bccdn.com/1.jpg?test=2 会响应不同的内容。
• 关闭 忽略URL参数 功能，则 CDN 使用整个 URL 来计算命中缓存的 key ，每个不同的 URL 都缓存不同的副本在 CDN 的节点上，都会响应不同参数源站的内容。