# zuihou-admin-cloud **Repository Path**: lemonLove/zuihou-admin-cloud ## Basic Information - **Project Name**: zuihou-admin-cloud - **Description**: 基于SpringCloud(Finchley.M2) + SpringBoot(2.0.0.M2) 的微服务 SaaS 开发平台，具有统一授权、认证后台管理系统，其中包含具备用户管理、资源权限管理、网关API、OpenAPI管理、文件服务、邮件服务、短信服务等多个模块，可以作为后端服务的开发脚手架。代码简洁，架构清晰。核心技术采用Eureka、Fegin、Ribbon、Zuul、Hystrix、JWT Token、Mybatis、SpringBoot、Redis、RabbitMQ、FastDFS等主要框架和中间件。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://github.com/zuihou/zuihou-admin-cloud - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 2251 - **Created**: 2018-01-23 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # zuihou-admin-cloud ## 简介： 基于`SpringCloud(Finchley.M2)` + `SpringBoot(2.0.0.M2)` 的微服务 SaaS 开发平台， 具有统一授权、认证后台管理系统，其中包含具备用户管理、配置中心、存储系统、资源权限管理、 网关API、OpenAPI管理、日志分析、任务和通知等多个模块， 支持多业务系统并行开发，可以作为后端服务的开发脚手架。代码简洁，架构清晰，非常适合学习使用。 核心技术采用Eureka、Fegin、Ribbon、Zuul、Hystrix、JWT Token、Mybatis、SpringBoot、Redis、 RibbitMQ、FastDFS等主要框架和中间件。 希望能努力打造一套从 `前端模板` - `基础框架` - `分布式微服务架构` - `开源项目` - `持续集成` - `自动化部署` - `系统监测` 的解决方案。 该项目为本人在学习过程中通过一些其他的开源项目，资料，文章进行整合的一个项目。 目前国内的一些资料讲解和使用的SpringCloud版本都比较低，自己在基于现有的开源项目和资料学习的同时， 一边以自己的一些想法改造搭建一个相对较新版本的项目。 后期会引入`Docker`（慢慢学，还没到这一步） ## 架构详解: - 服务注册与调用： 基于Eureka来实现的服务注册与调用，在Spring Cloud中使用Feign, 我们可以做到使用HTTP请求远程服务时能与调用本地方法一样的编码体验，开发者完全感知不到这是远程方法，更感知不到这是个HTTP请求。 - 服务鉴权: 通过JWT的方式来加强服务之间调度的权限验证，保证内部服务的安全性。 - OpenAPI鉴权： 通过JWT的方式来加强对外暴露接口调度的权限验证，保证api接口的安全性。 - 负载均衡： 将服务保留的rest进行代理和网关控制，除了平常经常使用的node.js、nginx外，Spring Cloud系列的zuul和rebbion，可以帮我们进行正常的网关管控和负载均衡。其中扩展和借鉴国外项目的扩展基于JWT的Zuul限流插件，方面进行限流。 - 熔断机制： 因为采取了服务的分布，为了避免服务之间的调用“雪崩”，采用了Hystrix的作为熔断器，避免了服务之间的“雪崩”。 - 监控： 利用Spring Boot Admin 来监控各个独立Service的运行状态；利用turbine来实时查看接口的运行状态和调用频率；通过Zipkin来查看各个服务之间的调用链等。 ## 技术栈/版本介绍： - 所涉及的相关的技术有 ： - JSON序列化:Jackson - 缓存：Redis 3.0.500（待升级 4.0.6） - 消息队列：RibbitMQ - 数据库： MySQL 5.7.9(驱动6.0.6) - 定时器：Quartz Scheduler - Java模版：Thymeleaf 3.0.6.RELEASE - 前端：Bootstrap + Vue2.0 （期待前端大神参与） - API网关：Zuul - 服务注册与发现：Eureka - 服务消费：Ribbon、OpenFeign - 负载均衡：Ribbon - 配置中心：Config Server （git） - 服务熔断：Hystrix - 项目构建：Maven 3.3 - 文件服务器：FastDFS 5.0.5 - 服务器：centos - 后期引入： - Docker - Jenkins - nginx - keepalive 本代码采用示例采用 Intellij IDEA(2018.1 EAP) 来编写，但源码与具体的 IDE 无关。 ## 约定： - zuihou-xxx-api 项目中提供feign客户端，dto - 区分po、dto，不要把po中的所有字段都返回给前端。 前端需要什么字段，就返回什么字段 - 类名：首字母大写驼峰规则；方法名：首字母小写驼峰规则；常量：全大写；变量：首字母小写驼峰规则，尽量非缩写 - 模块命名为`项目`-`业务`，如`zuihou-admin` - 数据表命名为：`子系统`_`表`，如`b_role` - 更多规范，参考[[阿里巴巴Java开发手册] https://gitee.com/zuihou111/zuihou-admin-cloud/attach_files ## 期待您的加入： 1，前端哥哥 2，后端哥哥 3，土豪哥哥(求捐献服务器) 4，小姐姐 ## 启动指南 ## 环境须知： - nginx (暂时没用到) - mysql ，redis ，rabbitmq - jdk1.8 - IDE插件一个(Eclipse, IDEA都需要安装插件)，`lombok插件` ## 项目结构: ``` ├─zuihou-admin-cloud │ │ │ ├─zuihou-backend---------------------------后端服务 │ | ├─zuihou-admin--------------------------后端管理服务 │ | | ├─zuihou-admin-api------------------后端管理服务api接口 │ | | ├─zuihou-admin-repository------------后端管理业务/持久层 │ | | ├─zuihou-admin-server----------------后端管理服务 │ | |─zuihou-base---------------------------基础模块服务 │ | | ├─zuihou-base-api-------------------基础模块接口/dto │ | | ├─zuihou-base-repository-------------基础模块业务/持久层 │ | | ├─zuihou-base-server-----------------基础模块服务 │ | ├─zuihou-file---------------------------文件模块服务 │ | ├─zuihou-mail---------------------------邮件模块服务 │ | ├─zuihou-sms----------------------------短信模块服务 │ | ├─zuihou-auth---------------------------鉴权中心 │ | | |─zuihou-auth-client-----------------鉴权中心客户端 │ | | |─zuihou-auth-common-----------------鉴权中心公共包 │ | | |─zuihou-auth-server-----------------鉴权中心服务 │ | ├─zuihou-gateway------------------------统一网关负载中心 │ | | |─zuihou-gateway-ratelimit-----------网关限流插件 │ | | |─zuihou-gateway-server--------------项目网关服务 │ │ │ ├─zuihou-common----------------------------公共模块（这里一直没想好怎么调整，有想法的朋友可以给我留言） │ | ├─zuihou-commons------------------------项目公共包 │ | ├─zuihou-core---------------------------项目核心包 │ │ │ ├─zuihou-frontend--------------------------项目前端 │ | ├─zuihou-center-web----------------------项目前端 │ | ├─zuihou-sso-client---------------------项目单点登录client │ │ │ ├─zuihou-config-repo-----------------------远程配置文件仓库 │ │ │ ├─zuihou-service---------------------------服务模块 │ | ├─zuihou-config-------------------------配置中心 │ | ├─zuihou-eureka-------------------------注册中心 │ | ├─zuihou-monitor------------------------spring-boot-admin监控中心 │ | ├─zuihou-zipkin-------------------------zipkin分布式链路跟踪 │ │ │ │-... ``` ## 运行步骤: - （未完善 by 2018年1月17日 16:15:45） - 运行环境分为2个，开发环境(dev),生产环境(prod), 开发环境部署单机，生产环境统一每个服务部署2台服务器 - 开发环境(dev)Hosts文件配置： ``` 127.0.0.1 casserver.zuihou.com 127.0.0.1 eureka.zuihou.com 127.0.0.1 config.zuihou.com 127.0.0.1 admin.zuihou.com 127.0.0.1 open.zuihou.com 127.0.0.1 gateway.zuihou.com 127.0.0.1 auth.zuihou.com 127.0.0.1 monitor.zuihou.com 127.0.0.1 zipkin.zuihou.com 127.0.0.1 zuihou.rabbitmq.host 127.0.0.1 zuihou.mysql.host 127.0.0.1 zuihou.redis.host ``` - 生产环境(prod)Hosts文件配置： ``` 127.0.0.1 casserver.zuihou.com 127.0.0.1 eureka1.zuihou.com eureka2.zuihou.com 127.0.0.1 config.zuihou.com 127.0.0.1 admin.zuihou.com 127.0.0.1 open.zuihou.com 127.0.0.1 gateway.zuihou.com 127.0.0.1 auth.zuihou.com 127.0.0.1 monitor.zuihou.com 127.0.0.1 zipkin.zuihou.com 127.0.0.1 zuihou.rabbitmq.host 127.0.0.1 zuihou.mysql.host 127.0.0.1 zuihou.redis.host ``` - 依次运行数据库脚本： - zuihou-backend/zuihou-base/zuihou-base-server/init.sql - zuihou-backend/zuihou-admin/zuihou-admin-server/init.sql - 通过以下方法，进行密码加密： ``` public static void main(String[] args) throws Exception { System.out.println(ConfigTools.encrypt("your mysql password")); } ``` - 修改配置数据库配置： - zuihou-config-repo/zuihou-backend/zuihou-admin/application.yml - zuihou-config-repo/zuihou-backend/zuihou-base/application.yml - zuihou-config-repo/zuihou-service/zuihou-zipkin/application.yml - 按`顺序`运行main类： - ZuihouEurekaApplication（zuihou-eureka） - ZuihouOpenServerApplication（zuihou-open-server） - ZuihouAdminServerApplication（zuihou-admin-server） - ZuihouAuthApplication（zuihou-auth-server） - ZuihouGateServerApplication（zuihou-gateway-server） - MonitorApplication（zuihou-monitor） - ZipkinApplication（zuihou-zipkin） - 端口号介绍（dev）: | 服务 | 端口号 | |:----:|:----:| | zuihou-eureka | 8500 | ​ | zuihou-config | 8505 | ​ | zuihou-zipkin | 8510 | ​ | zuihou-monitor | 8515,8516 | ​ | - | - |​- | ​ | zuihou-auth | 9775 | ​ | zuihou-gateway | 9770 | ​ | zuihou-admin | 9765 | ​ | zuihou-base | 9760 | ​ | zuihou-file | 9755 | ​ | zuihou-sms | 9750 | ​ | zuihou-email | 9745 | ​ - 端口号介绍（prod）: | 服务 | 端口号1 | 端口号2 | |:----:|:----:|:----:| | zuihou-eureka | 8501 | 8502 | ​ | zuihou-config | 8506 | 8507 | | zuihou-zipkin | 8511 | 8512 | | zuihou-monitor | 8515,8516 | 8517,8518 | ​ | - | - |​- | | zuihou-auth | 9776 | 9777 | ​ | zuihou-gateway | 9771 | 9772 | | zuihou-admin | 9766 | 9767 | ​ | zuihou-base | 9761 | 9762 | ​ | zuihou-file | 9756 | 9757 | ​ | zuihou-sms | 9751 | 9752 | ​​ | zuihou-email | 9746 | 9747 | ​​