插件系统

插件系统的插件能够在路由、服务、全局中配置。

若在多个模块配置了同一个插件，则配置优先级为：路由>服务>全局，且同个插件只生效一次。 即路由和服务均配置同一个插件，最终会以路由的配置为准

插件执行流程及其更多细节点此进行跳转。

备注：

插件名称	字段名	说明
额外参数	extra_params	转发时在请求中携带自定义参数
参数映射	params_transformer	转发时将请求中的原参数映射成自定义参数
转发重写	proxy_rewrite	转发时对请求的host、scheme、uri进行重写，同时能在请求头加入自定义参数
http-mocking	http-mocking	当执行该插件时，它将随机返回指定格式的模拟数据，并且请求不会转发到上游。
dubbo2协议转发重写	dubbo2-proxy-rewrite	转发时，对dubbo2协议请求的service_name、method_name进行重写，同时能对attachment加入自定义参数
http协议转dubbo2协议	http-to-dubbo2	将http请求转换成dubbo2请求
dubbo2协议转http协议	dubbo2-to-http	将dubbo2请求转换成http请求
IP黑白名单	ip_restriction	对访问的客户端ip进行黑白限制
流量控制	rate_limiting	控制请求在单位时间内的访问次数
鉴权	auth	对请求进行权限校验
响应重写	response_rewrite	用于重写网关返回的状态码、响应体、头部
API熔断	circuit_breaker	用于停止对不可用API的转发
跨域CORS	cors	设置跨域的头部字段，实现跨域功能
gzip压缩	gzip	将响应进行gzip压缩，以提高传输效率
access_log	access_log	记录到达网关的http请求的访问日志

全局插件可以声明在程序运行过程中加载插件的名称、顺序、插件的启用状态，也可以配置具体插件在全局范围生效。

以配置在全局范围生效的IP黑白名单插件为例：

在全局插件中启用了某个插件之后，可以在路由或上游服务中引用并配置它。

以在上游服务中配置IP黑白名单插件插件为例：

当一条转发路径配置多个插件时，对插件鼠标左键进行拖拉可以改变插件的执行顺序

# 插件系统