v2.6.5
changelog:

修复一些安全漏洞
更新一些后台文案提示
优化统计数据上报接口

Fix some security vulnerabilities
Update some tips messages of fizz manager
Optimize reporting interfaces of statistics

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 网关节点是无状态的，配置信息自动同步，支持节点水平拓展和多集群部署。
• 安全授权：支持内置的 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]