全部产品
Search
文档中心

视频点播:忽略参数

更新时间:Sep 15, 2026

开启忽略参数功能后,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 用户:http://example.com/1.jpg?uid=123***

B 用户:http://example.com/1.jpg?uid=654***

未开启忽略参数时,CDN 节点会将 A、B 用户的 URL 视为不同资源,无法命中同一缓存,每次都需回源。开启忽略参数后,CDN 节点会去除 URL 参数,统一使用 http://example.com/1.jpg 匹配缓存。

说明

配置URL鉴权的优先级高于忽略参数。鉴权方式A的鉴权信息包含URL参数部分,CDN会先完成鉴权判断,通过后再缓存副本。

保留回源参数

作用

适用场景

回源时保留原始 URL 全部参数,确保源站能接收到用户的关键信息。

开启忽略参数后,CDN 节点默认使用去除参数后的 URL 回源。以上述示例为例,A、B 用户的回源请求都使用 http://example.com/1.jpg,UID 等关键信息会丢失。开启保留回源参数后,CDN 节点将使用原始 URL 回源,确保 UID 等参数传递给源站。

操作步骤

  1. 登录视频点播控制台。

  2. 在左侧导航栏选择配置管理 > 分发加速配置 > 域名管理,进入到域名管理页面。

  3. 在域名管理页面,单击目标域名操作列的配置。

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

  5. 在忽略参数区域,单击修改配置。

  6. 请根据您的实际需求配置过滤模式、过滤参数等配置项。

    配置项和说明如下表所示。

    重要

    切换过滤模式,原有配置会被删除。

    • 过滤模式:保留指定参数

      参数

      说明

      示例

      忽略参数

      • 是:开启忽略参数功能,用户请求回源时会去除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的参数一致(即,删除了指定的参数)。

  7. 单击确定,完成配置。