# miracle-cloud

**Repository Path**: miracle-peak/miracle-cloud

## Basic Information

- **Project Name**: miracle-cloud
- **Description**: 一个小型springcloud项目，可进行快速开发，适合新手，基于spring cloud alibaba，采用Nacos注册和配置中心，集成流量卫兵Sentine，zipkin链路跟踪，路由网关使用gateway
- **Primary Language**: Java
- **License**: MulanPSL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2020-08-09
- **Last Updated**: 2025-02-14

## Categories & Tags

**Categories**: code-generator

**Tags**: None

## README

# miracle-cloud

#### 介绍
一个小型springcloud项目，可进行快速开发，适合新手，基于spring cloud alibaba，采用Nacos注册和配置中心，集成流量卫兵Sentine，zipkin链路跟踪,路由使用gateway，ribbon负载

#### 技术架构

- 后端：springcloud + mybatis-plus + redis + mysql + nacos + zipkin + sentinel + ribbon + gateway + jwt;
- [前端](https://gitee.com/miracle-peak/miracle-vue)：vue + axios + element-ui;


#### 安装教程

1.  [官网下载sentinel控制台jar包](https://github.com/alibaba/Sentinel/releases)或者使用项目[sentinel目录下的sentinel-dashboard-1.8.0](https://gitee.com/miracle-peak/miracle-cloud/blob/master/sentinel/sentinel-dashboard-1.8.0.jar)，[制作镜像并启动](https://gitee.com/miracle-peak/miracle-cloud/blob/master/sentinel/sentinel.md)
2.  启动nacos端口：8848
3.  启动redis，zipkin

#### 使用说明

1.  miracle-system:系统模块，包含角色管理，用户管理，菜单管理;
2.  miracle-common:公共模块，提供工具如jwt工具，加盐加密工具等工具，包含zikpin链路跟踪，以及全局异常处理，其他模块使用需要在启动类扫包加上公告模块的"pers.miracle.miraclecloud.common"，参考system系统模块的启动类;
4.  miracle-gateway:网关路由模块,根据路由匹配分发到相应的服务;
5. [sentinel限流使用](https://gitee.com/miracle-peak/miracle-cloud/blob/master/sentinel/sentinel.md)