bxy-open-cloud是国内基于Spring Cloud(Hoxton.SR1)+ SpringBoot(2.2.2.RELEASE)微服务化开发平台,具有统一授权、认证后台管理系统,其中包含具备用户管理、资源权限管理、 网关API管理、分布式事务、大文件断点分片续传等多个模块,支持多业务系统并行开发,可以作为后端服务的开发脚手架。代码简洁,架构清晰,适合学习和直接项目中使用。 核心技术采用Nacos、Fegin、Ribbon、Zuul、Hystrix、JWT Token、Mybatis、SpringBoot、Redis、RibbitMQ等主要框架和中间件。
#### 简介 搭建基于OAuth2的开放平台、为APP端、应用服务提供统一接口管控平台、为第三方合作伙伴的业务对接提供授信可控的技术对接平台 + 分布式架构,Nacos(服务注册+配置中心)统一管理 + 统一API网关(参数验签、身份认证、接口鉴权、接口调试、接口限流、接口状态、接口外网访问) + 统一oauth2认证协议- 后台默认账号:admin 123456
- 后台测试账号:test 123456
- SpringBootAdmin账号:sba 123456
学习交流(群):807571015
open-cloud
├── docs -- 文档及脚本
├── bin -- 执行脚本
├── config -- 公共配置,用于导入到nacos配置中心
├── sql -- sql文件
├── data -- 增量数据
├── bxy-commons -- 公共组件
├── open-cloud-common-core -- 提供微服务相关依赖包、工具类、全局异常解析等
├── open-cloud-common-starter -- SpringBoot自动配置扫描
├── open-cloud-tenant-starter -- 多租户模块,多数据源自动切换(完善中...)
├── open-cloud-java-sdk -- 开放平台api集成SDK(完善中...)
├── bxy-platform -- 平台服务
├── bxy-gateway-server -- API开放网关-基于SpringCloudGateway[port = 8760](推荐)
├── bxy-api-zuul-server -- API开放网关-基于Zuul[port = 8888](功能完善)
├── open-cloud-base-client -- 平台基础服务接口
├── bxy-base-server -- 平台基础服务器[port=8764]
├── bxy-base-file-server -- 平台用户认证服务器[port = 8765]
├── bxy-gateway-server -- 门户开发者认证服务器[port = 8760]
├── bxy-generator-server -- 在线代码生成服务器[port = 5555]
├── bxy-support -- 通用微服务
├── open-cloud-msg-client -- 消息服务接口
├── open-cloud-msg-server -- 消息服务器[port = 8266]
├── open-cloud-task-client -- 任务调度接口
├── open-cloud-task-server -- 调度服务器[port = 8501]
├── open-cloud-sba-server -- SpringBootAdmin监控服务[port = 8849]
├── open-cloud-sso-ui-demo -- SSO单点登录演示demo[port = 8849]
本项目基于springCloud打造的分布式快速开发框架. 需要了解SpringCloud,SpringBoot,分布式原理。
-
准备环境
- Java1.8 (v1.8.0_131+)
- Nacos服务注册和配置中心(v1.0.0+) 阿里巴巴nacos.io
- Redis (v3.2.00+)
- RabbitMq (v3.7+)(需安装rabbitmq_delayed_message_exchange插件 下载地址)
- Mysql (v5.5.28+)
- Maven (v3+)
- Nodejs (v10.14.2+)
-
执行创建数据库open-platform并执行sql脚本
- docs/sql/base.sql
- docs/sql/gateway.sql
- docs/sql/msg.sql
- docs/sql/quartz.sql && task.sql ...
-
启动nacos服务发现&配置中心,新建公共配置文件
- 访问 http://localhost:8848/nacos/index.html
- 导入配置 /docs/config/DEFAULT_GROUP.zip(nacos1.0.3以上版本支持一键导入)
- 新建配置文件 (nacos1.0.3以下版本)
- 项目目录/docs/config/db.properties > db.properties
- 项目目录/docs/config/rabbitmq.properties > rabbitmq.properties
- 项目目录/docs/config/redis.properties > redis.properties
- 项目目录/docs/config/common.properties > common.properties
-
修改主pom.xml
初始化maven项目
maven clean install
本地启动,默认不用修改
<!--Nacos配置中心地址--> <config.server-addr>127.0.0.1:8848</config.server-addr> <!--Nacos配置中心命名空间,用于支持多环境.这里必须使用ID,不能使用名称,默认为空--> <config.namespace></config.namespace> <!--Nacos服务发现地址--> <discovery.server-addr>127.0.0.1:8848</discovery.server-addr>
-
本地启动(按顺序启动)
- [必需]BaseApplication(平台基础服务)
- [必需]UaaAdminApplication(平台用户认证服务器)
- [必需]GatewaySpringApplication(推荐)或GatewayZuulApplication
访问 http://localhost:8888
4.[非必需]SpringBootAdmin(监控服务器)(非必需)
访问 http://localhost:8849
-
前端启动
npm install npm run dev
-
项目打包部署
- maven多环境打包,替换变量
mvn clean install package -P {dev|test|online}
- 项目启动
./docs/bin/startup.sh {start|stop|restart|status} open-cloud-base-server.jar ./docs/bin/startup.sh {start|stop|restart|status} open-cloud-uaa-admin-server.jar ./docs/bin/startup.sh {start|stop|restart|status} open-cloud-api-spring-server.jar
-
技术栈/版本介绍:
- 所涉及的相关的技术有:
JSON序列化:Jackson 消息队列:RabbitMQ 缓存:Redis 缓存框架:J2Cache 数据库: MySQL 8 (驱动8.0.6) 定时器:采用xxl-jobs项目进行二次改造 前端:vue 持久层框架: Mybatis-plus 代码生成器:基于Mybatis-plus-generator自定义 [https://github.com/zuihou/zuihou-generator.git] API网关:Zuul 服务注册与发现:Eureka -> Nacos 服务消费:OpenFeign 负载均衡:Ribbon 配置中心:Nacos 服务熔断:Hystrix 项目构建:Maven 3.3 分布式事务: seata 分布式系统的流量防卫兵: Sentinel 监控: spring-boot-admin 2.x 链路调用跟踪: zipkin 2.x 文件服务器:FastDFS 5.0.5/阿里云OSS/本地存储 Nginx