RuoYi-Vue-Plus 多租户后台管理框架实践指南：本地启动与最短部署路径-育师

RuoYi-Vue-Plus 多租户后台管理框架实践指南：本地启动与最短部署路径

【免费下载链接】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 把这套多租户后台管理做成了可直接运行的后端工程：基于 Spring Boot 的框架，内置 Sa-Token 权限、Mybatis-Plus 持久层与 WarmFlow 审批工作流，并给出从本地启动到容器化部署的完整路径。本文按"它是什么 → 能力在哪 → 怎么跑起来 → 适不适合你"的顺序，把新手关心的部分讲清楚。

它定位在哪

RuoYi-Vue-Plus 是 RuoYi-Vue 的重写版，面向分布式集群场景，与旧版 RuoYi 不兼容。判断它是否合适前，可以先核对几个可验证的事实：

当前版本 6.0.0，后端基于 Spring Boot 4.1.0，要求 JDK 21；
关系数据库原生支持 MySQL、Oracle、PostgreSQL、SQLServer，配合 dynamic-datasource 可做异构切换；
结构是单体 + 插件化扩展包，默认不是微服务，按需加载各个 common 包；
前端是独立项目（基于 Vue3 + TS + ElementPlus 的 plus-ui），本仓库只包含纯后端；
提供 Docker Compose 编排 MySQL、Redis、MinIO、Nginx 等依赖环境，见 script/docker/docker-compose.yml。

上手成本有多高

仓库按职责分成四层，新手不必一次读完。ruoyi-admin/ 是唯一启动入口，ruoyi-modules/ 放业务（system、workflow、gen、job、ai 等），ruoyi-common/ 是二十多个通用扩展包（redis、oss、excel、sensitive、encrypt、log 等），ruoyi-extend/ 是监控与调度等独立可运行服务。第一次跑起来，你只需要关注 admin 启动类和 system 业务模块，其余扩展包按需引用即可，不会被迫读完全部源码。

数据与权限怎么管

权限基于 Sa-Token，支持登录校验、角色校验、权限校验与二级认证，角色和权限可写AND、OR这类组合表达式。数据权限由 Mybatis-Plus 插件按 Mapper 上的注解条件自动拼接过滤，不依赖手工改 SQL；数据脱敏、存取加解密、字段翻译同样走注解，在序列化或持久化阶段自动完成。多租户是核心能力，各租户拥有独立的数据空间，适合一套代码服务多个客户。

扩展方式怎么接

新增业务通常放进 ruoyi-modules/ruoyi-system/ 或新建同构模块，通用横切能力则归到 ruoyi-common 下独立成包，保持解耦。代码生成器 ruoyi-modules/ruoyi-gen/ 依据表结构生成前后端 CRUD 代码，支持多数据源。复杂审批走 ruoyi-modules/ruoyi-workflow/，底层是 WarmFlow，支持转办、委派、会签、加签等流程操作。

走最短启动路径

最短可复现路径分四步，先看环境，再初始化，后启动。

第一步，克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus

第二步，用仓库自带编排拉起 MySQL、Redis、MinIO、Nginx：

cd script/docker && docker compose up -d

第三步，初始化数据库。按你选的数据库，到 script/sql/ 下导入对应脚本（MySQL 用根目录的ry_vue.sql、ry_workflow.sql等，Oracle/PostgreSQL/SQLServer 各有子目录）。导入后修改ruoyi-admin的application-dev.yml，把数据源、Redis 地址改成上一步容器对应的连接。

第四步，启动服务。在仓库根目录执行./mvnw -pl ruoyi-admin spring-boot:run，或直接运行 ruoyi-admin/DromaraApplication.java。启动后由 Nginx 代理到后端，再配合独立的前端项目 plus-ui 即可访问完整后台。