一、概述
proxy-rewrite 官方的定义是上游代理信息重写插件（请求方是下游，服务方是上游）。
举个例子就是你的应用服务（用于认证的）接口各式各样的REST API，我现在就可以通过proxy-rewrite 插件给他们统一加一个前缀auth来方便管理和使用而你应用代码不需要任何改变。以前访问你应用使用/sso/check api，现在就是/auth/sso/check api了，而这个转换过程就是proxy-rewrite的功能了。
这里是官方的介绍：https://github.com/apache/incubator-apisix/blob/master/doc/zh-cn/plugins/proxy-rewrite.md
官方主要以REST接口形式来说明的，这里主要说下页面配置。
二、使用
参数概念
这个插件有如下四个参数：
- scheme 就是选择下访问你上游服务的协议是HTTP还是HTTPS
- uri 表示转发到哪个REST API 上
- regex_uri 有两个参数，第一个使用正则匹配你请求的API，第二个参数 是在匹配成功时转发到哪个REST API上
- host 转发到上游的新 host 地址，例如：iresty.com
- headers 转发请求的时候可以设置下header内容。如果想要删除某个 header 的话，把对应的值设置为空字符串即可。
示例
1、创建Upstream
这个就是你上游服务配置,它根据配置规则在给定的一组服务节点上执行负载平衡
2、创建Service
创建个Service,为上游服务提供了抽象，都是在router使用的，里面配置了服务的upstream。
3、创建个Route
可以看到，这里我们使用了service。注意，如果你在router同时配置了upstream 和service,会使用upstream的配置。
4、编写测试类
@RestController
@RequestMapping("/check")
@CrossOrigin
public class CheckController {
/**
* 获取基础信息 /check/getIp
* @param request
* @return
*/
@RequestMapping("/getIp")
public String getIp(HttpServletRequest request) {
Map<String, Object> datas = new HashMap<>(16);
datas.put("OsName", OSUtil.getOsName());
datas.put("ProcessNo", OSUtil.getProcessNo());
datas.put("RealIp", OSUtil.getRealIp(request));
datas.put("HostName", OSUtil.getHostName());
datas.put("x-forwarded-for", request.getHeader("x-forwarded-for") == null ? "No x-forwarded-for" : request.getHeader("x-forwarded-for")
);
return JSON.toJSONString(datas);
}
/**
* 默认返回 /check/def
* @return
*/
@RequestMapping("/def")
public String def() {
return "this is def msg";
}
/**
* 转发请求 /check/rewrite/getIp
* @return
*/
@RequestMapping("/rewrite/getIp")
public String rewrite() {
return "我被转发到这里了 /rewrite/getIp， cat:"+request.getHeader("cat");
}
}
这时候我调用接口 check/getIp 返回如下信息：
{"ProcessNo":89159,"OsName":"Mac OS X","x-forwarded-for":"172.21.13.65, 172.21.13.68","HostName":"luqiangdeMacBook-Pro.local","RealIp":"172.21.13.65"}
这时候我添加插件
5、添加插件 proxy-rewrite
点击添加插件，选择proxy-rewrite，填写请求转发
这时候在调用 check/getIp ,返回如下信息：
我被转发到这里了 /rewrite/getIp， cat:123
这时其实就是将/check/getIp 的请求转发到了 /check/rewrite/getIp 上。
「当然我们还可以使用另一种方式，入配置了uri参数，会优先使用uri的配置」
这时候在调用 check/getIp ,返回如下信息： this is def msg
6、给请求添加统一的前缀
上面的例子就是给某一个接口进行转发，但如果要像开始说的给我的应用增加一个公共的前缀路径
这时我访问/matrix/check/getIp 接口，就会返回如下数据：
{"ProcessNo":89332,"OsName":"Mac OS X","x-forwarded-for":"172.21.13.65, 172.21.13.68","HostName":"luqiangdeMacBook-Pro.local","RealIp":"172.21.13.65"}
完美的对我们的请求进行了转发。
三、总结
- 1、proxy-rewrite 插件可以针对我们的请求进行各种策略的转发。
- 2、要记住 regex_uri 和 uri是互斥的，一起配置后regex_uri 是无效的。
- 3、可以从regex_uri 第一个参数中提取数据用于第二个参数
- 4、proxy rewrite 插件也支持REST API的形式
- 5、可以通过proxy rewrite 插件 增加公共的header
本文使用 mdnice 排版
