youlai-boot-tenant

🖥️ 在线预览  |  📑 阅读文档  |  🌐 官网

📢 项目简介

youlai-boot-tenant 是 youlai-boot 的多租户版本，基于 Spring Boot 3, Spring Security, Mybatis-Plus, JWT, Redis 构建，专为 SaaS 应用提供后端支持。

• 🏢 多租户架构: 基于 Mybatis-Plus 的单库多租户方案，通过租户 ID 实现数据隔离。
• 🚀 最新技术栈: 采用 Spring Boot 3 和 JDK 17，享受最新的性能优化和语言特性。
• 🔐 企业级安全: 深度整合 Spring Security，提供 JWT 无状态认证和 Redis 会话管理双重机制。
• 🔑 精细化权限: 内置经典的 RBAC 模型，权限控制可精确到菜单、按钮及后端 API 接口。

🌈 项目源码

项目类型	Gitee	Github	GitCode
✅ Java 多租户	youlai-boot-tenant	youlai-boot-tenant	youlai-boot-tenant
vue3 前端	vue3-element-admin	vue3-element-admin	vue3-element-admin
uni-app 移动端	vue-uniapp-template	vue-uniapp-template	vue-uniapp-template

📚 项目文档

文档名称	访问地址
项目介绍与使用指南	https://www.youlai.tech/youlai-boot-tenant

📁 项目目录

目录结构

youlai-boot-tenant/
├─ docker/                    # Docker 编排
├─ sql/                       # 数据库脚本
├─ src/                       # 核心业务源码
│  ├─ auth/                   # 认证模块
│  ├─ common/                 # 公共模块
│  ├─ config/                 # 配置模块
│  ├─ core/                   # 核心模块
│  ├─ platform/               # 平台模块
│  ├─ plugin/                 # 插件模块
│  ├─ security/               # 安全模块
│  └─ system/                 # 系统模块
└─ pom.xml                    # Maven 构建配置

🚀 快速启动

1. 环境准备

要求	说明
JDK 17	17+ LTS
MySQL	5.7+ 或 8.x
Redis	7.x 稳定版

⚠️ 重要提示：MySQL 与 Redis 为项目启动必需依赖，请确保服务已启动。

2. 数据库初始化

推荐使用 Navicat、DBeaver 或 MySQL Workbench 执行 sql/mysql/youlai_admin_tenant.sql 脚本，完成数据库和基础数据的初始化。

3. 修改配置

编辑 src/main/resources/application-dev.yml 文件，根据实际情况修改 MySQL 和 Redis 的连接信息。

4. 启动项目

运行 YouLaiBootApplication.java 的 main 方法启动项目。

启动成功后，访问 http://localhost:8000/doc.html 验证项目是否成功。

🧪 多租户测试

• 预置租户: 平台默认租户 (tenant_id=0) 和演示租户 (tenant_id=1)。
• 预置账号: 平台租户 (root/admin) 和演示租户 (admin)，默认密码 123456。
• 本地测试: 修改本地 hosts 文件，添加 127.0.0.1 vue.youlai.tech 和 127.0.0.1 demo.youlai.tech，通过不同域名访问即可自动切换租户。

🐳 项目部署

1. Jar 部署

# 打包
mvn -DskipTests package

# 运行
java -jar target/youlai-boot-tenant.jar --spring.profiles.active=prod

2. Docker 部署

# 构建镜像
docker build -t youlai-boot-tenant:latest .

# 运行容器
docker run -d -p 8000:8000 --name youlai-boot-tenant youlai-boot-tenant:latest

💖 技术交流

• 问题反馈：Gitee Issues
• 技术交流群：QQ 群：950387562
• 博客教程：https://www.youlai.tech