RuoYi-Vue-Plus 3 步跑起来的多租户后台管理系统完整指南
【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus
RuoYi-Vue-Plus 是一套面向分布式集群与多租户场景重写的 Java 后台管理系统，内置 Sa-Token 权限认证、Mybatis-Plus、WarmFlow 工作流、SpringDoc 接口文档和 OSS 文件存储，帮你跳过权限、分页、脱敏、代码生成这些"每次都要重复造"的轮子，直接专注业务本身。
先说清楚：这套系统能帮你干什么
如果你正在做企业级后台（ERP、OA、业务中台），或者想拿一套现成的权限体系当项目骨架，RuoYi-Vue-Plus 能省掉大量基础工作量：
- 权限与安全：基于 Sa-Token + JWT，登录校验、角色校验、权限注解、二级认证开箱即用，比 Spring Security 的繁琐配置清爽很多
- 多租户 + 数据权限：租户隔离、按部门/角色过滤数据，只需给 Mapper 加注解即可无感生效
- 企业级基础设施：分布式锁、分布式限流、SnailJob 定时任务、MinIO/S3 文件存储、接口传输加密、数据脱敏与加解密
- 效率工具：设计好表结构后一键生成前后端 CRUD 代码，官方估算可降低约 80% 的重复开发量；WarmFlow 工作流支持转办、会签、加减签等复杂审批
它和原版 RuoYi不兼容——不是补丁式升级，而是整体重写，模块采用插件化解耦结构（common 公共包、modules 业务模块、extend 扩展服务），方便你按需裁剪。
环境要求：一张清单看明白
后端是 Maven 多模块工程（当前版本 6.0.0，基于 Spring Boot 4.1），依赖如下：
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| JDK | 21+（README 标注支持 21/25） | 注意不是 Java 8 |
| Maven | 3.6+ | 仓库自带mvnw包装器可直接用 |
| MySQL | 5.7+ / 8.x | 默认连接localhost:3306 |
| Redis | 6+ | 缓存、分布式锁、限流都依赖它 |
| 前端工程 | Node.js + pnpm | 官方前端是独立仓库（Vue3 + TS + ElementPlus），不在本仓库内 |
前端地址、社区和部署文档的入口都写在根目录 README.md 里，本指南只讲后端主线。
快速上手：从 clone 到启动
整条主线是：克隆代码 → 初始化数据库 → 改一行配置 → 启动，前后端各走各的步骤。
1. 克隆代码
git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus2. 初始化数据库
在 MySQL 里建库后导入 SQL 脚本，主库脚本是ry_vue.sql，工作流和定时任务按需导入：
create database `ry-vue` default charset utf8mb4;mysql -uroot -p ry-vue < script/sql/ry_vue.sql # 需要工作流/定时任务时再导入： mysql -uroot -p ry-vue < script/sql/ry_workflow.sql mysql -uroot -p ry-vue < script/sql/ry_job.sqlOracle、PostgreSQL、SQLServer 用户可以在 script/sql/ 下找到对应方言的脚本。
3. 只改一行配置
后端数据库连接配置在 ruoyi-admin/src/main/resources/application-dev.yml，默认值如下，如果你的账号密码不同就只改这里：
spring: datasource: dynamic: datasource: master: url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&... username: root password: root同文件里还有一段 Redis 配置，默认localhost:6379、密码ruoyi123，本地 Redis 若没设密码，把password清空即可。
4. 构建并启动
mvn clean package -DskipTests java -jar ruoyi-admin/target/ruoyi-admin.jar也可以进ruoyi-admin模块直接mvn spring-boot:run，开发时更省事。
5. 前端（独立工程）
从 README 指引处获取官方 plus-ui 前端仓库后：
npm install npm run dev前端默认把请求代理到http://localhost:8080的后端。
怎么验证跑成功了
启动日志看到 Spring Boot 启动完成、无 ERROR 后：
- 浏览器访问
http://localhost:8080，后端接口服务已就绪 - 前端页面默认端口（一般为
http://localhost或http://localhost:80）打开后应看到登录页，使用内置账号admin/admin123登录（SQL 脚本中已预置超级管理员） - 登录成功后进入管理后台，能看到用户、角色、菜单、部门等系统管理菜单，说明权限体系已正常加载
- 接口文档由 SpringDoc 生成（基于 javadoc 注释、零文档注解），可直接在浏览器里调试接口
常见坑与延伸阅读
- 启动报数据库连接失败：90% 是
application-dev.yml里的 url/账号没改成你自己的，先确认 MySQL 已导入ry_vue.sql - Redis 连不上：本地没装 Redis 时，可用 script/docker/docker-compose.yml 里的
redis服务快速拉起一个 - JDK 版本不对：低于 21 会直接编译失败，
java -version确认一下 - 前端 404 / 跨域：确认前端代理指向的是 8080 后端，且后端已在运行
- 想用 Docker 一键部署：参考 script/docker/ 下的编排文件，包含 MySQL、Redis、MinIO、Nginx 和双节点后端实例
- 深入功能差异：README 里有完整的框架功能对比表；ruoyi-demo 模块提供了缓存、限流、加密、Excel 等特性的 Demo Controller，照着读比看文档更快
<输出文章>
【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
