全部产品
Search
文档中心

:改写回源参数

更新时间:Nov 15, 2024

如果用户发起的原始请求URL中携带的参数与需要发送给源站的参数不一致,您可以通过回源参数改写功能改写回源请求URL中携带的参数。实现忽略所有参数、添加参数、删除参数、保留参数、修改参数等操作。

背景信息

回源参数改写,改写的是回源请求URL的查询参数,支持配置多个改写规则,优先级为添加参数删除参数忽略参数仅保留修改参数。当不同的改写规则作用于同一个参数时,只有高优先级的规则会生效。

说明

忽略参数仅保留参数互斥,不要同时配置这两个参数。

改写参数图

冲突说明

回源参数改写回源URI改写enhance break规则、以及过滤参数功能可能会冲突,配置时注意避免,且后配置的功能生效。

说明
  • 回源参数改写是在全站加速回源节点上完成,不影响全站加速的内部链路,且不改写缓存key。

  • 过滤参数是在全站加速边缘节点上完成,会影响全站加速的内部链路,且会改写缓存key。

操作步骤

  1. 登录DCDN控制台

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

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

  4. 在指定域名的左侧导航栏,单击回源配置

  5. 单击回源参数改写

  6. 回源参数改写页签,打开使用回源参数改写开关。

  7. 配置需要改写的回源参数。

    根据实际业务需求,按照界面提示配置不同的改写操作,您也可以在一种操作类型的文本框中添加多个参数。更多信息,请参见配置示例

    回源参数改写

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

    您也可以在回源参数改写页面,单击修改配置,修改已配置的规则。

    回源参数改写

配置示例

  • 配置示例一:忽略所有参数。

    1

    配置项

    填写示例

    忽略参数

    开启

    添加参数

    删除参数

    仅保留

    修改参数

    结果说明

    原始请求:http://example.com/index.html?code1=1&code2=2&code3=3

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

  • 配置示例二:保留指定参数。

    2

    配置项

    填写示例

    忽略参数

    开启

    添加参数

    删除参数

    仅保留

    code2

    修改参数

    结果说明

    原始请求:http://example.com/index.html?code1=1&code2=2&code3=3

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

  • 配置示例三:添加参数+删除参数+修改参数。

    3

    配置项

    填写示例

    忽略参数

    开启

    添加参数

    code4=4

    删除参数

    code2

    仅保留

    修改参数

    code3=0

    结果说明

    原始请求:http://example.com/index.html?code1=1&code2=2&code3=3

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