# zr-sys-cloud

**Repository Path**: weirdo-dev/zr-sys-cloud

## Basic Information

- **Project Name**: zr-sys-cloud
- **Description**: 微服务架构,采用了 Spring Cloud 2023 & Alibaba、Spring Boot 3.2、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术，集成了注册中心、配置中心、监控中心、网关等系统功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-21
- **Last Updated**: 2025-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zr-sys-cloud

<p>
  <a href="https://gitee.com/weirdo-dev/zr-sys-cloud.githttps://gitee.com/weirdo-dev/zr-sys-cloud.git"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E7%A0%81%E4%BA%91-%E9%A1%B9%E7%9B%AE%E5%9C%B0%E5%9D%80-orange.svg" alt="gitee"></a>
</p>


## 项目简介

`zr-sys-cloud`是一套微服务脚手架，采用了 Spring Cloud 2023 & Alibaba、Spring Boot 3.2、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术。`集成了注册中心、配置中心、监控中心、网关等系统功能。


### 组织结构

``` lua
zr-sys-cloud
├── zr-auth      #权限模块
│   ├── zr-auth-interface
│   └── zr-auth-service
│
├── zr-common    #公共模块
│
├── zr-demo      #demo模块
│   ├── zr-demo-interface
│   └── zr-demo-service
│
├── zr-gateway   #网关模块
│
├── zr-generator #代码生成器
│   ├── src
│   └── target
│   
└── zr-user      #用户模块
    ├── zr-user-interface
    └── zr-user-service

```

## 技术选型

### 后端技术

| 技术                   | 说明                 | 官网                                                 |
| ---------------------- | -------------------- | ---------------------------------------------------- |
| Spring Cloud           | 微服务框架           | https://spring.io/projects/spring-cloud              |
| Spring Cloud Alibaba   | 微服务框架           | https://github.com/alibaba/spring-cloud-alibaba      |
| Spring Boot            | 容器+MVC框架         | https://spring.io/projects/spring-boot               |
| Sa-Token               | 认证和授权框架       | https://github.com/dromara/Sa-Token                   |
| MyBatis                | ORM框架              | http://www.mybatis.org/mybatis-3/zh/index.html       |
| MyBatisGenerator       | 数据层代码生成       | http://www.mybatis.org/generator/index.html          |
| PageHelper             | MyBatis物理分页插件  | http://git.oschina.net/free/Mybatis_PageHelper       |
| Knife4j                | 文档生产工具         | https://github.com/xiaoymin/swagger-bootstrap-ui     |
| Elasticsearch          | 搜索引擎             | https://github.com/elastic/elasticsearch             |
| RabbitMq               | 消息队列             | https://www.rabbitmq.com/                            |
| Redis                  | 分布式缓存           | https://redis.io/                                    |
| MongoDb                | NoSql数据库          | https://www.mongodb.com/                             |
| Docker                 | 应用容器引擎         | https://www.docker.com/                              |
| Druid                  | 数据库连接池         | https://github.com/alibaba/druid                     |
| OSS                    | 对象存储             | https://github.com/aliyun/aliyun-oss-java-sdk        |
| MinIO                  | 对象存储             | https://github.com/minio/minio                       |
| LogStash               | 日志收集             | https://github.com/logstash/logstash-logback-encoder |
| Lombok                 | 简化对象封装工具     | https://github.com/rzwitserloot/lombok               |



## 环境搭建

### 开发环境

| 工具          | 版本号 | 下载                                                         |
| ------------- | ------ | ------------------------------------------------------------ |
| JDK           | 17     | https://www.oracle.com/cn/java/technologies/downloads/#java17 |
| Mysql         | 5.7    | https://www.mysql.com/                                       |
| Redis         | 7.0    | https://redis.io/download                                    |
| Elasticsearch | 7.17.3 | https://www.elastic.co/cn/downloads/elasticsearch            |
| Kibana        | 7.17.3 | https://www.elastic.co/cn/downloads/kibana                   |
| Logstash      | 7.17.3 | https://www.elastic.co/cn/downloads/logstash                 |
| MongoDb       | 5.0    | https://www.mongodb.com/download-center                      |
| RabbitMq      | 3.10.5 | http://www.rabbitmq.com/download.html                        |
| nginx         | 1.22   | http://nginx.org/en/download.html                            |

### 搭建步骤

## 运行效果展示

- 查看注册中心注册服务信息，访问地址：http://127.0.0.1:8848/nacos/

![](./document/resource/nacos.png)

- 监控中心应用信息，访问地址：http://127.0.0.1:8101

![](./document/resource/monitor.png)


- API文档信息，访问地址：http://127.0.0.1:8201/doc.html

![](./document/resource/doc.png)