当您需要改写用户回源请求URL中的参数时,可以配置回源参数改写功能。通过本文档,您可以了解配置回源参数改写功能的操作方法。

背景信息

当用户请求URL中携带的参数信息与您需要发送给源站的参数信息不一致时,您可以配置多个回源参数改写规则,实现忽略、添加、删除、保留、修改等多种操作。

操作步骤

  1. 登录CDN控制台
  2. 在左侧导航栏,单击域名管理
  3. 域名管理页面,单击目标域名对应的管理
  4. 在指定域名的左侧导航栏,单击回源配置
  5. 单击回源参数改写
  6. 回源参数改写页签,打开使用回源参数改写开关。
    回源参数改写
  7. 配置回源参数改写操作。

    您可以根据需求配置不同的操作类型,也可以在一种操作类型的参数框里面添加多个参数。

    回源参数改写
  8. 单击确定,使改写操作开始执行和生效。

    您也可以在回源参数改写页面,单击修改配置,对当前配置的规则进行修改操作。

    回源参数改写

    改写回源参数需要注意如下事项:

    • 改写规则的优先级为:添加参数删除参数仅保留修改参数
    • 忽略参数功能和仅保留功能互斥,要避免出现两个功能同时配置的情况,以免出现功能冲突。
    • 开启忽略参数功能(同时仅保留功能的输入框留空)的情况下,将会忽略原始URL中携带的所有参数,但是由于添加参数和删除参数操作的优先级更高,添加参数和删除参数操作仍会生效。
    • 仅保留功能的输入框内填写需要保留的参数(同时关闭忽略参数功能),将只会保留原始URL中携带的指定参数,但是由于添加参数和删除参数操作的优先级更高,添加参数和删除参数操作仍会生效。
    说明

    与其他功能的冲突说明如下:

    • 回源参数改写功能对URL中参数的改写,可能会与回源URI改写功能在配置执行规则“enhance_break”的情况下相冲突,这两个功能同时配置的时候,需要注意避免配置冲突。
    • 回源参数改写功能对URL中参数的改写,可能会与域名管理 > 性能优化页签下的保留参数忽略参数功能相冲突,这三个功能同时配置的时候,需要注意避免配置冲突。
    • 回源参数改写功能的作为位置是在CDN回源节点上面,不影响CDN内部链路,不改写缓存key,而保留参数忽略参数功能的作用位置是在CDN边缘节点上面,会影响CDN内部链路,也会改写缓存key。

操作样例

样例一:

忽略参数 开启
添加参数
删除参数
仅保留
修改参数
结果说明 原始请求:http://domain.com/index.html?code1=1&code2=2&code3=3

改写后的回源请求:http://domain.com/index.html

样例二:

忽略参数
添加参数
删除参数
仅保留 code2
修改参数
结果说明 原始请求:http://domain.com/index.html?code1=1&code2=2&code3=3

改写后的回源请求:http://domain.com/index.html?code2=2

样例三:

忽略参数
添加参数 code4=4
删除参数 code2
仅保留
修改参数 code3=0
结果说明 原始请求:http://domain.com/index.html?code1=1&code2=2&code3=3

改写后的回源请求:http://domain.com/index.html?code1=1&code3=0&code4=4