转发重写

插件信息

名称字段属性
转发重写proxy_rewrite参数处理

功能描述

该插件用于对上游代理信息进行重写,支持对 urihost 的重写,同时支持对转发请求头部header的值进行新增,修改或者删除。

注意事项:

  • 对uri的重写支持静态重写,正则替换

配置参数说明

参数名说明是否必填默认值值可能性
uri设置转发请求的新uri地址string
regex_uri对原uri进行正则替换并将其设置到转发请求的新uri地址。该字符串数组有两个值,第一个表示匹配请求的uri所需要的正则表达式,第二个表示匹配成功后所需要的uri替换正则表达式。array_string
host设置转发请求的新host地址string
headers能对转发请求的头部值进行新增或删除object

注意事项

  • uri和regex_uri均用于修改uri,若都配置了,则uri的值优先。
  • headers配置字段:能对转发请求的头部值进行新增,修改或删除
    • 新增,修改:直接设置键值对即可。需要注意的是对以下特殊头部的修改只会在原有值的末尾添加上新值,除此之外的头部值会直接进行覆盖。

      • Content-Type
      • Content-Length
      • Connection
      • Cookie
      • Transfer-Encoding
      • Host
      • User-Agent
    • 删除:配置的键值对里的值为空字符串时,即为删除指定头部

全局开启转发重写插件

配置带有转发重写插件的服务

配置说明:将转发请求的路径uri设置为/apinto/demo ,host设置为 127.0.0.1,同时请求头部中新增apinto:demo