com.github.wehotel:fizz-spring-boot-starter

fizz gateway community

License

License

Categories

Categories

Spring Boot Container Microservices
GroupId

GroupId

com.github.wehotel
ArtifactId

ArtifactId

fizz-spring-boot-starter
Last Version

Last Version

1.5.0.2
Release Date

Release Date

Type

Type

jar
Description

Description

fizz gateway community

Download fizz-spring-boot-starter

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.wehotel/fizz-spring-boot-starter/ -->
<dependency>
    <groupId>com.github.wehotel</groupId>
    <artifactId>fizz-spring-boot-starter</artifactId>
    <version>1.5.0.2</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.wehotel/fizz-spring-boot-starter/
implementation 'com.github.wehotel:fizz-spring-boot-starter:1.5.0.2'
// https://jarcasting.com/artifacts/com.github.wehotel/fizz-spring-boot-starter/
implementation ("com.github.wehotel:fizz-spring-boot-starter:1.5.0.2")
'com.github.wehotel:fizz-spring-boot-starter:jar:1.5.0.2'
<dependency org="com.github.wehotel" name="fizz-spring-boot-starter" rev="1.5.0.2">
  <artifact name="fizz-spring-boot-starter" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.wehotel', module='fizz-spring-boot-starter', version='1.5.0.2')
)
libraryDependencies += "com.github.wehotel" % "fizz-spring-boot-starter" % "1.5.0.2"
[com.github.wehotel/fizz-spring-boot-starter "1.5.0.2"]

Dependencies

compile (33)

Group / Artifact Type Version
org.springframework.boot : spring-boot-starter-webflux jar 2.2.13.RELEASE
org.springframework.boot : spring-boot-starter-log4j2 jar 2.2.13.RELEASE
com.alibaba : fastjson jar 1.2.75
com.google.code.gson : gson jar 2.8.6
net.minidev : json-smart jar 2.3
org.codehaus.jettison : jettison jar 1.3.8
org.json : json jar 20190722
org.apache.tapestry : tapestry-json jar 5.4.5
org.apache.commons : commons-lang3 jar 3.12.0
org.codehaus.groovy : groovy-all jar 2.4.21
commons-io : commons-io jar 2.8.0
com.ctrip.framework.apollo : apollo-client jar 1.5.1
org.springframework.cloud : spring-cloud-starter-netflix-eureka-client jar 2.2.7.RELEASE
com.alibaba.boot : nacos-config-spring-boot-starter jar 0.2.7
com.alibaba.boot : nacos-discovery-spring-boot-starter jar 0.2.7
org.apache.commons : commons-pool2 jar 2.7.0
org.springframework.boot : spring-boot-starter-data-redis-reactive jar 2.2.13.RELEASE
org.noear : snack3 jar 3.1.6.4
org.springframework.session : spring-session-data-redis jar 2.3.0.RELEASE
com.auth0 : java-jwt jar 3.12.1
org.apache.dubbo : dubbo jar 2.7.5
io.grpc : grpc-all jar 1.16.1
io.grpc : grpc-services jar 1.16.1
org.projectlombok : lombok jar 1.18.18
org.apache.curator : curator-client jar 4.0.1
org.apache.curator : curator-framework jar 4.0.1
org.apache.curator : curator-recipes jar 4.0.1
org.apache.zookeeper : zookeeper jar 3.5.9
commons-codec : commons-codec jar 1.15
org.bouncycastle : bcpkix-jdk15on jar 1.64
com.github.wehotel : fizz-common jar 1.5.0.2
com.github.wehotel : fizz-core jar 1.5.0.2
com.github.wehotel : fizz-plugin jar 1.5.0.2

test (6)

Group / Artifact Type Version
org.springframework.boot : spring-boot-starter-test jar 2.2.13.RELEASE
io.projectreactor : reactor-test jar 3.3.15.RELEASE
it.ozimov : embedded-redis jar 0.7.3
org.mockito : mockito-core jar 3.4.6
org.mockito : mockito-inline jar 3.4.6
junit : junit jar 4.12

import (1)

Group / Artifact Type Version
org.springframework.session : spring-session-bom pom Dragonfruit-RELEASE

Project Modules

There are no modules declared in this project.

English | 简体中文

Welcome to Fizz Gateway

Version Documentation License: GPL--3.0 Java CI with Maven

  • 最新QQ交流群: 512164278

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黑白名单。
  • 自定义插件:强大的插件机制支持自由扩展。
  • 可扩展:简单易用的插件机制方便扩展功能。
  • 高性能:性能在众多网关之中表现优异。
  • 版本控制:支持操作的发布和多次回滚。
  • 管理后台:通过管理后台界面对网关集群进行各项配置。
  • 回调管理:支持回调的管理、订阅、重放、以及日志

基准测试

我们将Fizz与Spring官方spring-cloud-gateway进行比较,使用相同的环境和条件,测试对象均为单个节点。

  • Intel(R) Xeon(R) CPU X5675 @ 3.07GHz * 4
  • Linux version 3.10.0-327.el7.x86_64
  • 8G RAM
产品 QPS 90% Latency(ms)
直接访问后端服务 9087.46 10.76
fizz-gateway 5927.13 19.86
spring-cloud-gateway 5044.04 22.91

版本对照

  • Fizz-gateway-community: 社区版

  • Fizz-manager-professional:管理后台专业版(服务端)

  • Fizz-admin-professional:管理后台专业版(前端)

Fizz-gateway-community Fizz-manager-professional Fizz-admin-professional
v1.0.0 v1.0.0 v1.0.0
v1.1.0 v1.1.0 v1.1.0
v1.1.1 v1.1.1 v1.1.1
v1.2.0 v1.2.0 v1.2.0

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

  • Fizz-gateway-community: 社区版

  • Fizz-manager-professional:管理后台

Fizz-gateway-community Fizz-manager-professional
v1.3.0 v1.3.0
v1.4.0 v1.4.0
v1.4.1 v1.4.1
v1.5.0 v1.5.0
v1.5.1 v1.5.1
v2.0.0 v2.0.0

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

部署说明

详细部署教程>>>

安装依赖

安装以下依赖软件:

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

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

安装Fizz

一、安装管理后台

从github的releases(https://github.com/wehotel/fizz-gateway-community/releases) 下载 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. 执行 ./boot.sh 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]

官方技术交流群

Fizz官方技术交流①群(已满)

Fizz官方技术交流②群(已满)

Fizz官方技术交流③群:512164278

相关文章

服务器减少50%,研发效率提高86%,我们的管理型网关Fizz自研之路

简单易用的微服务聚合网关首选:Fizz Gateway安装教程

大厂推荐使用的网关解密:Fizz Gateway管理后台使用教程

架构师效率快的终极原因:Fizz Gateway网关之服务编排

高阶架构师支招:Fizz Gateway的插件开发

高阶程序员必备技能:Fizz Gateway网关的二次开发

授权说明

  1. 网关核心项目fizz-gateway-community社区版本以GNU v3的方式进行的开放,可以免费使用。

  2. 管理后台项目(fizz-manager-professional)作为商业版本仅开放二进制包 免费下载,而商业项目请联系我们([email protected])进行授权。

系统截图

com.github.wehotel

FizzGate

Versions

Version
1.5.0.2
1.5.0.1
1.5.0