v2.5.2

changelog:

修复当Eureka使用登录验证时注册中心健康状态显示为异常的问题
修复接口文档查看、编辑页面提示'registryName:注册中心名称不能为空'的问题

Fix the issue that the registry health status was displayed as abnormal when Eureka used login authentication
Fix the issue that the interface document viewing and editing page prompts registryname cannot be null

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]