企业官网建设流程全解析

RuoYi-Vue-Plus 安装部署完整指南：从 0 到 1 搭建多租户后台管理系统

【免费下载链接】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 是一款开源的多租户后台管理系统框架，它在 RuoYi-Vue 基础上重写了全部原生业务，并针对分布式集群场景做了全方位升级。照本教程操作，你能拉起它的后端接口服务与官方前端，并用管理员账号完成首次登录。

项目速览

• 核心定位：多租户后台框架，租户隔离贯穿用户、菜单、数据权限等全部业务，同时支持分布式集群部署
• 相比基础版 RuoYi：后端采用插件化 + 扩展包架构，通用能力拆到ruoyi-common各子模块，增删能力不动核心代码
• 权限用 Sa-Token 替代 Spring Security，数据访问用 Mybatis-Plus 替代原生 MyBatis，原生支持 MySQL、Oracle、PostgreSQL、SQLServer 多库切换
• 内置工作流（WarmFlow）、代码生成器、Excel、OSS 文件存储等常用能力，开箱即用
• 适合场景：Spring Boot 快速搭建企业内部后台、多租户 SaaS 服务、前后端分离管理系统的二开脚手架

技术栈一览

后端

• Spring Boot 4.x：应用基座，统一容器、自动装配与生命周期
• Mybatis-Plus：对象化 ORM，几乎不用手写 SQL
• Sa-Token：轻量权限认证，登录态、角色与权限校验全靠它
• Redisson：Redis 客户端，支撑分布式锁与限流
• WarmFlow：工作流引擎，处理审批、转办、会签
• SpringDoc：基于 javadoc 生成接口文档，零注解侵入
• Hutool + Lombok：工具方法与样板代码简化

前端

• Vue 3 + TypeScript：前端框架，官方前端基于它重写
• Element Plus：Vue 3 组件库
• Vite：前端构建与开发服务器

动手前的准备

另外还需两个运行时依赖：MySQL 8 与 Redis 6+。可以本地自行安装，也可以直接用仓库里的 script/docker/docker-compose.yml 一键拉起 MySQL、Redis、Nginx。

安装主线

克隆仓库并初始化数据库

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

在 MySQL 中先创建数据库ry-vue，再导入script/sql/ry_vue.sql（主系统脚本，必导）；用到审批流程的再导入ry_workflow.sql。开发配置的默认库名、用户名、密码分别是ry-vue、root、root，本地环境与之对齐即可少改配置。

配置数据源并构建后端

🚀 打开ruoyi-admin/src/main/resources/application-dev.yml，把master数据源的 url、username、password 改成你自己的 MySQL 信息，同时确认同文件的redis地址与密码指向本地 Redis——Redis 是启动必需项，配置不通服务起不来。

mvn clean package -DskipTests

Maven 默认激活dev环境，产物位于ruoyi-admin/target/ruoyi-admin.jar，构建时不必再传环境参数。

拉起后端服务

java -jar ruoyi-admin/target/ruoyi-admin.jar

看到日志打印 "Started DromaraApplication" 即启动成功，后端默认监听 8080 端口，端口冲突时追加-Dserver.port=8081即可。需要后台常驻的，也可改用script/bin/ry.sh start脚本启停。

启动前端并联调

本仓库只包含后端，官方前端是独立的 plus-ui 项目（Vue 3 + Element Plus），需另行克隆，并将其.env.development中的接口地址指向http://localhost:8080。

npm install npm run dev

浏览器打开前端提示的本地地址，用admin/admin123登录，进入"系统管理"看到菜单数据即联调成功。

验证与排错

✅ 按顺序自检三项，全部通过即部署成功：

1. 后端：8080 端口有响应，接口文档http://localhost:8080/swagger-ui/index.html能列出系统模块接口
2. 前端：登录页正常渲染，admin 账号可登录，菜单与用户数据能正常加载
3. 数据库：ry-vue库中sys_user等表有数据，登录后sys_logininfor登录日志表新增一条记录

常见卡点与排查入口：

• 登录报错或菜单为空：优先核对是否完整导入ry_vue.sql，以及application-dev.yml数据源与实际数据库是否一致
• 启动时连接超时：通常是 Redis 地址、密码错误或版本低于 6
• 配置项全量说明与 Docker 部署细节，见仓库根目录的 官方 README

【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus