v2.4.0

changelog:

支持公网专线功能
支持自定认文档集包含接口
支持配置重试
支持网关分组级别的插件
支持按服务名进行网关分组
支持配置没有请求的空步骤
支持在固定值里配置JSON数据
支持配置服务编排接口的HTTP状态码
支持配置网关的错误码字段名和发生错误时响应HTTP状态
新增公共资源管理并支持在服务编排里引用
新增appID的IP白名单的格式校验
新增replace/replaceAll/replaceFirst字符串函数
新增rename和removeFields列表函数
修复join列表函数因目标列表不包含源列表部分数据导致报错的问题
修复匹配不到有多个IP的网关节点问题

Support internet dedicated line function
Support customing API in document set
Support configuring retry
Support configuringplugins at the gateway group level
Support grouping by service name in gateway group
Support configuring empty steps without requests
Support to configure JSON data in fixed values
Support configuring HTTP status in aggregation
Support configuring the gateway's error code field name and HTTP status when an error occurs
Add global resource management and support refering global resource in aggregation
Add format verification of the appID IP address whitelist
Add replace/replaceAll/replaceFirst string functions
Add rename and removeFields list functions
Fix join list function issue that it will cause error while target list does not contain part of source list data
Fix the issue that the gateway node with multiple IP addresses can not be matched

Fizz Gateway是什么？

An Aggregation API Gateway in Java . Fizz Gateway 是一个基于 Java开发的微服务聚合网关，能够实现热服务编排聚合、自动授权选择、线上服务脚本编码、在线测试、高性能路由、API审核管理、回调管理等目的，拥有强大的自定义插件系统可以自行扩展，并且提供友好的图形化配置界面，能够快速帮助企业进行API服务治理、减少中间层胶水代码以及降低编码投入、提高 API 服务的稳定性和安全性。

演示环境（Demo）

http://demo.fizzgate.com/

账号/密码:admin/Aa123!

健康检查地址：http://demo.fizzgate.com/admin/health (线上版本请限制admin路径的外网访问)

API地址：http://demo.fizzgate.com/proxy/[服务名]/[API_Path]

Fizz的设计

Fizz典型应用场景

产品特性

• 集群管理：Fizz网关节点是无状态的，配置信息自动同步，支持节点水平拓展和多集群部署。
• 安全授权：支持内置的key-auth, JWT, basic-auth授权方式，并且可以方便控制。
• 服务编排：支持HTTP、Dubbo、gRPC、Soap协议热服务编排能力，支持前后端编码，支持JSON/XML输出，随时随地更新API。
• 负载均衡：支持round-robin负载均衡。
• 服务发现：支持从Eureka或Nacos注册中心发现后端服务器。
• 配置中心：支持接入apollo配置中心。
• HTTP反向代理：隐藏真实后端服务，支持 Rest API反向代理。
• 访问策略：支持不同策略访问不同的API、配置不同的鉴权等。
• IP黑白名单：支持配置IP黑白名单。
• 自定义插件：强大的插件机制支持自由扩展。
• 可扩展：简单易用的插件机制方便扩展功能。
• 高性能：性能在众多网关之中表现优异。
• 版本控制：支持操作的发布和多次回滚。
• 管理后台：通过管理后台界面对网关集群进行各项配置。
• 回调管理：支持回调的管理、订阅、重放、以及日志。
• 多级限流：细颗粒度的限流方式包含服务限流，接口限流，APP_ID限流，IP限流。
• 微服务文档：企业级管理开放微服务文档管理，系统集成更方便。
• 公网专线：独特的公网专线功能保证两点间网站、接口通讯安全可靠

基准测试

我们将Fizz与市面上主要的网关产品进行比较，使用相同的环境和条件，测试对象均为单个节点。Mock接口模拟20ms时延，报文大小约2K。

• Intel(R) Xeon(R) CPU E5-2650 v3 @ 2.30GHz * 4
• Linux version 3.10.0-957.21.3.el7.x86_64
• 8G RAM

版本对照

• Fizz-gateway-community： 社区版

• Fizz-manager-professional：管理后台专业版（服务端）

• Fizz-admin-professional：管理后台专业版（前端）

从v1.3.0开始管理后台的前端和服务端合并成一个包

• Fizz-gateway-community： 社区版

• Fizz-manager-professional：管理后台

请根据社区版的版本下载对应的管理后台版本

部署说明

详细部署教程>>>

安装依赖

安装以下依赖软件：

• Redis 2.8或以上版本
• MySQL 5.7或以上版本
• Apollo配置中心 (可选)
• Eureka或Nacos服务注册中心(可选)

依赖的安装可参考详细部署教程

安装Fizz

一、安装管理后台

从github的releases(https://wj.qq.com/s2/8682608/8fe2/) 下载 fizz-manager-professional 安装包

管理后台（fizz-manager-professional）

说明：

1. 以下安装步骤出现的{version}表示所使用管理后台的版本号，例如1.3.0。

安装方式一：二进制安装包

1. 解压fizz-manager-professional-{version}.zip安装包
2. 首次安装执行fizz-manager-professional-{version}-mysql.sql数据库脚本，从低版本升级至高版本选择执行update目录下对应升级脚本
3. 修改application-prod.yml文件，将相关配置修改成部署环境的配置
4. Linux启动 执行 chmod +x boot.sh 命令给boot.sh增加执行权限；执行 ./boot.sh start 命令启动服务，支持 start/stop/restart/status命令
5. Windows启动 执行.\boot.cmd start 命令启动服务，支持 start/stop/restart/status命令

安装方式二（v2.0.0或以上版本）：docker:

1. 下载对应版本的镜像：docker pull fizzgate/fizz-manager-professional:{version}
2. 通过环境变量方式修改redis配置、database配置（其它配置同理）并运行镜像

docker run --rm -d -p 8000:8000 \
-e "spring.redis.host={your redis host IP}" \
-e "spring.redis.port={your redis port}" \
-e "spring.redis.password={your redis password}" \
-e "spring.redis.database={your redis database}" \
-e "spring.datasource.url=jdbc:mysql://{your MySQL database host IP}:3306/fizz_manager?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&serverTimezone=GMT%2B8&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true" \
-e "spring.datasource.username={your MySQL database username}" \
-e "spring.datasource.password={your MySQL database password}" \
fizzgate/fizz-manager-professional:{version}

或通过映射目录方式使用外部配置文件和输出日志到宿主机, 配置文件可从安装包里获取，在宿主机创建fizz-manager-professional/config和fizz-manager-professional/logs目录，把application-prod.yml配置文件放置config下，在fizz-manager-professional目录下运行镜像

cd fizz-manager-professional
docker run --rm -d -p 8000:8000 \
-v $PWD/config:/opt/fizz-manager-professional/config \
-v $PWD/logs:/opt/fizz-manager-professional/logs fizzgate/fizz-manager-professional:{version}

服务启动后访问 http://{部署机器IP地址}:8000/#/login，使用超级管理员账户admin密码Aa123!登录

二、安装fizz-gateway-community社区版

说明：

1. 支持配置中心：apollo、nacos，支持注册中心：eureka、nacos，详细配置方法查看application.yml文件。
2. 如果使用apollo配置中心，可把application.yml文件内容迁到配置中心（apollo上应用名为：fizz-gateway）；如果不使用apollo可去掉下面启动命令里的apollo参数。
3. 以下安装步骤出现的{version}表示所使用网关的版本号，例如1.3.0。

安装方式一：二进制安装包

1. 下载fizz-gateway-community的二进制安装包，解压修改application.yml配置文件里配置中心、注册中心、redis(redis配置需与管理后台一致)的配置
2. 根据需要修改boot.sh脚本的apollo连接，不使用apollo配置中心可跳过
3. Linux启动 执行 ./boot.sh start 命令启动服务，支持 start/stop/restart/status命令
4. Windows启动 执行.\boot.cmd start 命令启动服务，支持 start/stop/restart/status命令

安装方式二：源码安装:

1. 本地clone仓库上的最新代码，修改application.yml配置文件里配置中心、注册中心、redis(redis配置需与管理后台一致)的配置
2. 在项目根目录fizz-gateway-community下执行Maven命令mvn clean package install -DskipTests=true
3. 在项目目录fizz-gateway-community/fizz-bootstrap下执行Maven命令mvn clean package -DskipTests=true
4. 进入fizz-gateway-community/fizz-bootstrap/target/fizz-gateway-community目录，执行 ./boot.sh start 命令启动服务，支持 start/stop/restart/status命令

安装方式三（v2.0.0或以上版本）：docker:

1. 下载对应版本的镜像：docker pull fizzgate/fizz-gateway-community:{version}
2. 通过环境变量方式修改redis配置（其它配置同理）并运行镜像

docker run --rm -d -p 8600:8600 \
-e "aggregate.redis.host={your redis host IP}" \
-e "aggregate.redis.port={your redis port}" \
-e "aggregate.redis.password={your redis password}" \
-e "aggregate.redis.database={your redis database}" \
fizzgate/fizz-gateway-community:{version}

或通过映射目录方式使用外部配置文件和输出日志到宿主机, 配置文件可从安装包或源码里获取，在宿主机创建fizz-gateway-community/config和fizz-gateway-community/logs目录，把application.yml和log4j2-spring.xml配置文件放置config下，在fizz-gateway-community目录下运行镜像

cd fizz-gateway-community
docker run --rm -d -p 8600:8600 \
-v $PWD/config:/opt/fizz-gateway-community/config \
-v $PWD/logs:/opt/fizz-gateway-community/logs fizzgate/fizz-gateway-community:{version}

最后访问网关，地址形式为：http://127.0.0.1:8600/proxy/[服务名]/[API_Path]