Snail - 企业级微服务快速开发脚手架

快速开始 • 文档 • 贡献 •

🐌 Snail - 轻量级 Spring Boot 快速开发脚手架

Snail 是一个基于 Spring Boot 3

的现代化微服务快速开发框架，提供开箱即用的认证、授权、网关、资源服务等核心能力，助力企业快速构建安全、可扩展的云原生应用。

🚀 开箱即用 | 安全可靠 | 易于扩展 | 前后端一体化

🌟 特性

• ✅ 基于最新技术栈：Spring Boot 3.5.5 + Spring Cloud 2025.0.0 +

• 🔐 OAuth2 认证授权：集成 Spring Security + JWT，支持统一身份认证与细粒度权限控制
• 🌐 微服务架构：模块化拆分，包含认证、授权、网关、资源服务，支持独立部署与横向扩展
• ⚡ 高性能网关：基于 Spring Cloud Gateway 实现路由、限流、熔断、鉴权
• 🧩 云原生支持：兼容 Nacos、Sentinel、Seata，支持服务发现、配置中心、分布式事务
• 🎨 现代化管理后台：基于 shadcn-vue/ui

• 📚 完善文档：涵盖架构设计、部署指南、API 文档与二次开发说明

🛠 技术栈

| 类别 | 技术 | |-----------|-------------------------------------------------------------------| | 后端框架 | Spring Boot 3.5.5、Spring Cloud 2025.0.0、Spring Security、OAuth2 | | 微服务治理 | Nacos（注册中心 & 配置中心）, | | 网关 | Spring Cloud Gateway | | 数据库 | MySQL 8 | | 前端框架 | Vue 3 + Vite + TypeScript + shadcn/ui | | 构建工具 | Maven、Docker、Docker Compose | | 监控 | Spring Boot Actuator、Prometheus（可选）、Grafana（可选） |

🏗 项目结构

snail/
├── authentication/           # 认证服务（OAuth2 授权服务器）
├── authorization/          # 授权服务（权限管理、角色、菜单）
├── gateway/               # API 网关（路由、鉴权、限流）
├── resource/              # 资源服务（业务 API 示例）
├── snail-vue-app/          # 后台管理界面（Vue3 + shadcn/ui）
└── pom.xml                      # Maven 父工程