# Snowy-Cloud

**Repository Path**: xiaonuobase/snowy-cloud

## Basic Information

- **Project Name**: Snowy-Cloud
- **Description**: 💖工作流业务领先💖Snowy-Cloud是小诺团队下Snowy的微服务前后分离版，基础包含了所有日常使用的管理功能，企业版包括camunda引擎的工作流、多租户、多数据源、ureport报表；另外官网包含大屏数据可视化、数据中台、知识库、仪表盘等产品。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://xiaonuo.vip
- **GVP Project**: No

## Statistics

- **Stars**: 2873
- **Forks**: 993
- **Created**: 2020-12-23
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: authority-management

**Tags**: 前后分离, SpringCloud, Java, MyBatis

## README

<div align="center">
    <p align="center">
        <img src="./snowy-admin-web/public/img/logo.png" height="150" alt="logo"/>
    </p>
</div>

## 框架介绍

Snowy-Cloud（SnowyAdmin微服务版）是国内首个国密前后端分离快速开发平台，集成国密加解密插件，
软件层面完全符合等保测评要求，同时实现国产化机型、中间件、数据库适配，是您的不二之选！
将国密能力内置于技术框架底层，让密码技术从"专业门槛"变为"开箱即用"，真正实现业务安全从底层做起。
历经多年开源社区打磨与企业客户实践验证，新版本在大数据处理能力与安全体系方面实现了全面升级。

采用SpringCloud+SpringBoot+MybatisPlus+AntDesignVue+Vite 等更多优秀组件及前沿技术开发，注释丰富，代码简洁，开箱即用！

Snowy谐音“小诺”，恰应小诺团队名称；意思为”下雪的、纯洁的“，寓意框架追求简洁至上，大道至简。

<p align="center">     
    <p align="center">
        <a href="https://gitcode.com/xiaonuobase/Snowy-Cloud">
            <img src="https://gitcode.com/xiaonuobase/Snowy-Cloud/star/badge.svg" alt="bootstrap">
        </a>
        <a href="https://gitee.com/xiaonuobase/snowy">
            <img src="https://gitee.com/xiaonuobase/snowy/badge/star.svg?theme=dark" alt="Gitee star">
        </a>
        <a href="https://gitee.com/xiaonuobase/snowy">
            <img src="https://gitee.com/xiaonuobase/snowy/badge/fork.svg?theme=dark" alt="Gitee fork">
        </a>
        <a href="https://www.antdv.com/docs/vue/introduce-cn/">
            <img src="https://img.shields.io/badge/vue-3-blue.svg" alt="bootstrap">
        </a> 
        <a href="http://spring.io/projects/spring-boot">
            <img src="https://img.shields.io/badge/vite-5-green.svg" alt="spring-boot">
        </a>
        <a href="https://www.antdv.com/docs/vue/introduce-cn/">
            <img src="https://img.shields.io/badge/vue--ant--design-4-blue.svg" alt="bootstrap">
        </a> 
        <a href="http://spring.io/projects/spring-boot">
            <img src="https://img.shields.io/badge/spring--boot-3-green.svg" alt="spring-boot">
        </a>
        <a href="http://mp.baomidou.com">
            <img src="https://img.shields.io/badge/mybatis--plus-3-blue.svg" alt="mybatis-plus">
        </a>  
        <a href="./LICENSE">
            <img src="https://img.shields.io/badge/license-Apache%202-red" alt="license Apache 2.0">
        </a>
    </p>
</p>

## 快速链接

gitee下载地址：[https://gitee.com/xiaonuobase/snowy-cloud](https://gitee.com/xiaonuobase/snowy-cloud)

github下载地址（镜像）：[https://github.com/xiaonuobase/Snowy-Cloud](https://github.com/xiaonuobase/Snowy-Cloud)

gitcode下载地址：[https://gitcode.com/xiaonuobase/Snowy-Cloud](https://gitcode.com/xiaonuobase/Snowy-Cloud)

演示地址：[https://snowy.xiaonuo.vip](https://snowy.xiaonuo.vip)

文档地址：[https://xiaonuo.vip/doc](https://xiaonuo.vip/doc)

别划走，您以为这就完了？微服务仅仅是我们体系中的一个版本，我们还有其他版本，例如单体分离版：

下载地址：[https://gitee.com/xiaonuobase/snowy](https://gitee.com/xiaonuobase/snowy)

## 商业产品

- 如果开源版本不能满足您的需求，还可以看看我们官方推出的基于开源版开发的商业化产品

<table>
    <colgroup>
        <col style="width: 25%"/>
        <col style="width: 20%"/>
        <col style="width: 55%"/>
    </colgroup>
    <thead>
        <tr><th>产品名称</th><th>演示</th><th>用途</th></tr>
    </thead>
    <tbody>
        <tr>
            <td>AI智能化零代码开发平台</td>
            <td><a href="https://alsc.xiaonuo.vip">https://alsc.xiaonuo.vip</a></td>
            <td>AI智能驱动，拖拉拽即可搭建业务系统，无需编写一行代码。</td>
        </tr>
        <tr>
            <td>国产数据中台</td>
            <td><a href="https://data.xiaonuo.vip">https://data.xiaonuo.vip</a></td>
            <td>覆盖数据采集、存储、治理、安全、资产化、服务全流程的一站式数据管理平台。</td>
        </tr>
        <tr>
            <td>统一身份认证平台</td>
            <td><a href="https://iam.xnark.com">https://iam.xnark.com</a></td>
            <td>一款企业级统一身份认证平台，全面支持 OAuth、SAML、JWT、CAS 等主流协议，既可作为 IDP 构建企业统一认证中心，也可作为 SP 对接第三方身份源，一个平台统管身份认证、单点登录与权限体系。</td>
        </tr>
        <tr>
            <td>AI大模型平台</td>
            <td><a href="https://ai.xnark.com">https://ai.xnark.com</a></td>
            <td>一站式企业级AI应用平台，覆盖从大模型接入、智能体搭建、知识库管理到应用发布的全链路，让企业零门槛构建和运营自己的AI能力。</td>
        </tr>
    </tbody>
</table>

## 快速启动

全栈工程师推荐idea

### 前端支撑

| 插件      | 版本  | 用途             |
|---------|-----|----------------|
| node.js | ≥18 | JavaScript运行环境 |

### 启动前端

```
npm install
```

```
npm run dev
```

### 后端支撑

| 插件     | 版本        | 用途     |
|--------|-----------|--------|
| jdk    | 17        | java环境 |
| lombok | idea内     | 代码简化插件 |
| maven  | 最新版       | 包管理工具  |
| redis  | 最新版       | 缓存库    |
| mysql  | 8.0 / 5.7 | 数据库    |

### 启动后端

开发工具内配置好maven并在代码中配置数据库，按顺序以此即可启动

|         应用         |       启动类        | 端口号  |
|:------------------:|:----------------:|:----:|
|  snowy-nacos-app   |  SnowyNacosApp   | 8848 |
| snowy-actuator-app | SnowyActuatorApp | 9001 |
| snowy-sentinel-app | SnowySentinelApp | 9002 |
| snowy-gateway-app  | SnowyGatewayApp  | 9003 |
| snowy-xxl-job-app  |  SnowyXxlJobApp  | 9004 |
|   snowy-web-app    |   SnowyWebApp    | 9101 |
|   snowy-biz-app    |   SnowyBizApp    | 9102 |

## 代码结构

Snowy-Cloud3.0框架对代码以插件化的模式进行分包，使得包层级结构更加清晰合理，同时降低了耦合度，关于插件模块化开发的规范请查阅文档【SNOWY-CLOUD开源文档——前端手册or后端手册——开发规范】板块。

```
snowy-cloud
  |-snowy-admin-web == 前端
    |-public == 基础静态文件
    |-src == 前端源代码
      |-api == API接口转发
      |-assets == 静态文件
      |-components == VUE组件
      |-config == 基础配置
      |-layout == 基础布局
      |-locales == 多语言配置
      |-router == 基础路由配置
      |-store == Pinia缓存配置
      |-style == 样式风格配置
      |-utils == 工具类
      |-views == 所有视图界面
  |-snowy-base == 基础组件
    |-snowy-common == 基础通用模块
  |-snowy-modules == 应用组件
    |-snowy-biz-app == 业务应用模块
    |-snowy-web-app == 主应用模块
  |-snowy-plugin == 插件组件
    |-snowy-plugin-auth == 登录鉴权插件
        |-snowy-plugin-auth-api == 登录鉴权插件api接口
        |-snowy-plugin-auth-feign == 登录鉴权插件feign接口
        |-snowy-plugin-auth-func == 登录鉴权插件func实现
    |-snowy-plugin-biz == 业务功能插件
        |-snowy-plugin-biz-api == 业务功能插件api接口
        |-snowy-plugin-biz-func == 业务功能插件func实现
    |-snowy-plugin-client == C端功能插件
        |-snowy-plugin-client-api == C端功能插件api接口
        |-snowy-plugin-client-func == C端功能插件func实现
    |-snowy-plugin-dev == 开发工具插件
        |-snowy-plugin-dev-api == 开发工具插件api接口
        |-snowy-plugin-dev-feign == 开发工具插件feign接口
        |-snowy-plugin-dev-func == 开发工具插件func实现
    |-snowy-plugin-gen == 代码生成插件
        |-snowy-plugin-gen-api == 代码生成插件api接口
        |-snowy-plugin-gen-func == 代码生成插件func实现
    |-snowy-plugin-sys == 系统功能插件
        |-snowy-plugin-sys-api == 系统功能插件api接口
        |-snowy-plugin-sys-feign == 系统功能插件feign接口
        |-snowy-plugin-sys-func == 系统功能插件func实现
    |-snowy-plugin-mobile == 移动端管理插件
        |-snowy-plugin-mobile-api == 移动端管理插件api接口
        |-snowy-plugin-mobile-func == 移动端管理插件func实现
  |-snowy-server == 服务组件
    |-snowy-actuator-app == 监控服务模块
    |-snowy-gateway-app == 网关服务模块
    |-snowy-nacos-app == 注册中心/配置中心模块
    |-snowy-sentinel-app == 限流服务模块
    |-snowy-xxl-job-app == 分布式任务调度服务模块

```

## 分支说明

- master

正式稳定版本，具体版本升级内容看更新标签

- dev

团队开发的分支（代码可能随时会推，不保证运行和使用）

- snowy-cloud1.8

1.x分支，目前已停止新增功能，只限于bug的维护，推荐使用2x版本

- snowy-cloud2.5

2.x分支，目前已停止新增功能，只限于bug的维护，可以平滑过渡至3x版本

## 视频教程

教程地址（免费开放）：[https://space.bilibili.com/50101698/channel/collectiondetail?sid=739071](https://space.bilibili.com/50101698/channel/collectiondetail?sid=739071)

<img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mhLatA%7D%2F&_etag=1730700699-816553&shareID=-9mhLatA"/>

作者也在上班工作，所以在利用休息时间为大家创作，录制视频的目的也是为各位小伙伴提供文档跟技术交流群聊之外的上手学习资料

## 架构原理图

* 业务架构

<p align="center">
    <img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mQYKqQ%7D%2F&_etag=1730691771-199603&shareID=-9mQYKqQ"/>
</p>

* 应用架构

<p align="center">
    <img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mQl1yQ%7D%2F&_etag=1730691771-325352&shareID=-9mQl1yQ"/>
</p>

* 数据架构

<p align="center">
    <img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mQz_8w%7D%2F&_etag=1730691771-337804&shareID=-9mQz_8w"/>
</p>

* 技术架构

<p align="center">
    <img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mRCSoA%7D%2F&_etag=1730691771-114558&shareID=-9mRCSoA"/>
</p>

* 部署架构

<p align="center">
    <img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mROhLg%7D%2F&_etag=1730691771-235717&shareID=-9mROhLg"/>
</p>

## 效果图例

<table>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lSg_Dw%7D%2F&_etag=1730384489-1272624&shareID=-9lSg_Dw"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lTCIQQ%7D%2F&_etag=1730384527-354571&shareID=-9lTCIQQ"/></td>
    </tr>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lTUROA%7D%2F&_etag=1730384568-327201&shareID=-9lTUROA"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lTdB3A%7D%2F&_etag=1730384595-160612&shareID=-9lTdB3A"/></td>
    </tr>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lTp1iw%7D%2F&_etag=1730384617-182491&shareID=-9lTp1iw"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lTyI5g%7D%2F&_etag=1730384636-144484&shareID=-9lTyI5g"/></td>
    </tr>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lUAj9A%7D%2F&_etag=1730384732-148422&shareID=-9lUAj9A"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lUWvfg%7D%2F&_etag=1730384836-112114&shareID=-9lUWvfg"/></td>
    </tr>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9lUuk7g%7D%2F&_etag=1730384925-320963&shareID=-9lUuk7g"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mJCOTw%7D%2F&_etag=1730385032-172917&shareID=-9mJCOTw"/></td>
    </tr>
    <tr>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mJSKTQ%7D%2F&_etag=1730385077-142012&shareID=-9mJSKTQ"/></td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mJfjcg%7D%2F&_etag=1730385168-168192&shareID=-9mJfjcg"/></td>
    </tr>
</table>

## 密码分步

| 功能     | 算法类型                 |
|--------|----------------------|
| 登录     | SM2前端加密，后端解密         |
| 登录登出日志 | SM2对登录登出日志做签名完整性保护存储 |
| 操作日志   | SM2对操作日志做签名完整性保护存储   |
| 用户密码   | SM3完整性保护存储，登录时做完整性校验 |
| 用户手机号  | SM4（cbc模式）加解密使用字段脱敏  |

## 官方群聊

QQ技术群：732230670（已满）、685395081

微信技术群：

因群达到200人以上，需加微信拉群，禁止群内艾特群主及管理员，私信提问技术问题无时间精力回答，请群内互动互助交流技术才是建群的意义

<table>
    <tr>
        <td>微信群</td>
        <td><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mUnPEw%7D%2F&_etag=1730699307-193261&shareID=-9mUnPEw" width="120"/></td>
    </tr>
</table>

## 示例代码

从 v3.6.0，我们把前端示例的一些界面文件拿到了另外一个仓库，使用时可以自行下载：[https://gitee.com/xiaonuoadmin/snowy-exm](https://gitee.com/xiaonuoadmin/snowy-exm)

## 代码贡献

近期有很多热心开源的小伙伴陆续为咱们Snowy框架提交PR或者提出好的建议，基本合格的PR我们都接受，这样您的头像就列入到咱们Snowy仓库的贡献者列表啦！

如何贡献

1、fork一份代码至自己的账号下，本地修改您要提的代码，提交至您fork的仓库

2、登录gitee后到Snowy仓库下创建Pull Requests,选择您的仓库到Snowy的dev分支，提交即可

因为dev分支是团队开发分支，并不是统一发版本的测试过的，所以我们建议提代码至dev即可

## 外包开发

如果您（或您公司）有外包开发需求，可以通过联系客服方式，提交您的需求，经过工作量分析，出具合适的报价，合作开发并交付。

本团队具备雄厚的技术人才力量，均跟随小诺团队发展至今，已完全熟练每一处细节代码，您的产品自然也是由Snowy平台进行开发并交付。

1、工期保障
2、源码质量保障
3、节点按时汇报

## 团队成员

| 成员  | 技术 |  昵称   | 
|:---:|:--:|:-----:| 
| 俞宝山 | 全栈 |  俞宝山  | 
| 徐玉祥 | 全栈 | 就是那个锅 | 
| 董夏雨 | 全栈 |  阿董   | 
| 王 鹏 | 全栈 | 每天一点  |
| 陈心雨 | 前端 |   .   |

## 曾获荣誉

🔥 **2021年度OSC中国开源项目评选-最受欢迎项目**

🔥 **2022年度OSC中国开源项目评选-最火热中国开源项目社区**

🔥 **2024 GitCode项目毕业认证-G-Star优秀毕业项目**

🔥 **2024 GitCode开源共创大会-十大新锐项目**

🔥 **2024中国互联网发展创新与投资大赛（开源）-优秀奖**

🔥 **2025年度GitCode百大开源项目**

🔥 **2025年度Gitee开源项目Web应用开发赛道Top3**

<table>
    <tr>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mLM-zg%7D%2F&_etag=1730698398-294375&shareID=-9mLM-zg"/></td>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9mLtqmQ%7D%2F&_etag=1730698444-77496&shareID=-9mLtqmQ"/></td>
    </tr>
    <tr>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A-9nmI4yQ%7D%2F&_etag=1730707931-764633&shareID=-9nmI4yQ"/></td>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/fileOut&path=%7BshareItemLink%3A_COsphyQ%7D%2F&_etag=1732688010-447888&shareID=_COsphyQ"/></td>
    </tr>
    <tr>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/file&hash=5f35-ed_a3_uGz1INMaJhSNbI6ixk370tTV5JR0whVe5n8ALraGqmEvRQQMoqeV-Gbs"/></td>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/file&hash=f6618VQ6vkSFTY9v8sg-7ahUp0Zj6Q33y2zL6LUL63_yDOa0xN4TW31IRrrBZZ836AE"/></td>
    </tr>
    <tr>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/file&hash=6dc31rfG5KA1l0nQukMmUm7gEufv6r5Q98iTgZyHbaPhjvGR-h6h77cvZ1DmBC5D_rY"/></td>
        <td style="width: 50%"><img src="https://pan.xiaonuo.vip/?explorer/share/file&hash=d7cfk0ftuw2tl1bAL42bl2wgk7sgcm-Z4ULwZu5TIjp4zsvmKBkYfGIoY48Buc4H0s0"/></td>
    </tr>
</table>

## 版权说明

- Snowy生态技术框架全系版本采用 Apache License2.0协议

- 代码可用于个人项目等接私活或企业项目脚手架使用，Snowy全系开源版完全免费

- 二次开源不可参与同类竞争，可在其他赛道进行，有好的案例可以提供，我们会挂在本页进行宣传

- 请不要删除和修改Snowy源码头部的版权与作者声明及出处