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

需要一套支持多租户、部门数据权限、审批工作流的后台管理系统时,不必自己从零搭——Dromara 开源的 RuoYi-Vue-Plus(v6.0.0)把这些都内置好了。这篇 RuoYi-Vue-Plus 安装教程只做一件事:让你的机器备好 JDK 21、Maven、MySQL、Redis 四样基础件,然后三条命令让后端在 8080 端口跑起来。

项目定位与技术选型

一句话定位:RuoYi-Vue 的全量重写版,面向分布式集群与多租户场景(与原框架不兼容)。模块拆成ruoyi-modules(系统、工作流、代码生成等业务)和ruoyi-common(一揽子可插拔能力包),本地开发只需启动聚合入口ruoyi-admin。注意前端是独立仓库(官方 plus-ui,Vue3 + ElementPlus),本仓库只含后端,所以验证部署是否成功看接口能否通即可。

角色技术为什么用它
运行时 / Web 容器JDK 21 + Jetty根 pom.xml 基线就是 21;Jetty 是 Spring 官方推荐的高性能容器
ORM / 数据访问Mybatis-Plus + dynamic-datasource几乎不写 SQL,内置分页与数据权限,yml 里可切换异构多数据源
权限认证Sa-Token + JWT登录、角色、权限校验全靠注解,比 Spring Security 轻得多
缓存 / 分布式锁Redis(≥6)+ Redisson官方推荐客户端,顺带支持分布式限流、队列
工作流WarmFlow审批、转办、会签、或签开箱即用
接口文档SpringDoc零注解,基于 Java 注释自动生成文档

环境准备清单

逐项跑一遍验证命令,能输出版本号就算就绪:

组件最低要求验证命令
JDK21java -version
Maven3.8+mvn -version
MySQL8.xmysql -V
Redis6+redis-cli -p 6379 -a ruoyi123 ping返回PONG
Git任意较新版本git --version

不想手动装这些依赖的话,仓库里现成的 docker-compose.yml 可一键拉起 MySQL、Redis、MinIO。

三步跑起来

第一步:克隆仓库并导入 SQL

做什么:克隆代码,建一个空库ry-vue,把初始化脚本导进去。脚本都在 script/sql/ 下。

git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus.git mysql -uroot -p -e "create database ry-vue character set utf8mb4"

✅ 成功现象:ry-vue库执行show tables;能看到sys_user等表。

第二步:改好数据库配置再构建后端

做什么:打开 application-dev.yml,默认值是jdbc:mysql://localhost:3306/ry-vue、账号root、密码root,Redis 密码ruoyi123。你本地的 MySQL/Redis 如果和这套默认一致,一行都不用改;不一致就只改url/username/password这几行。

mvn clean package -DskipTests

✅ 成功现象:结尾输出BUILD SUCCESS,并生成产物ruoyi-admin/target/ruoyi-admin.jar。

第三步:启动后端并确认端口

做什么:直接运行产物,端口来自 application.yml 的server.port: 8080。

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

✅ 成功现象:日志打印 Jetty 启动完成、无异常堆栈,8080 端口开始监听。

访问验证与常见问题

验证入口(后端起来后):

  • 健康检查:http://localhost:8080/actuator/health
  • 接口文档:http://localhost:8080/v3/api-docs(application.yml里springdoc.api-docs.enabled: true默认开启)
  • 前端登录(plus-ui 另属独立仓库):默认账号admin / admin123,见 ry_ai.sql 中"默认管理员"注释;测试账号test密码666666

新手最常卡的三个点:

1. 8080 端口被占用?改一行:把 application.yml 里的port: 8080换成空闲端口(如 8081)重启即可。

2. 数据库报Access denied或Public Key Retrieval is not allowed?前者是application-dev.yml里账号密码和实际 MySQL 不一致,改username/password两行;后者的原因参数allowPublicKeyRetrieval=true已在默认 url 里带上,手改 url 时别把它删掉。

3. Redis 连不上?配置期望的是localhost:6379且密码ruoyi123(对应 redis.conf 的requirepass)。先用清单里的验证命令确认,返回PONG就没问题。

首次构建要下载大量依赖,RuoYi-Vue-Plus 部署耗时几分钟属正常现象,第二次会快很多。

跑起来之后

先打开后台首页用admin / admin123登录,走一遍"系统管理 → 用户 / 角色 / 菜单"熟悉权限模型;再访问http://localhost:8080/v3/api-docs看各模块接口的组织方式。后面要做集群部署时,照着 docker-compose.yml 的多节点示例复制一份就行。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

AI协同开发STM32实战:从时钟配置到中断调试的效率提升指南

AI协同开发STM32实战:从时钟配置到中断调试的效率提升指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/21 1:19:57 阅读更多 →
显示驱动调试工具链全解析:从示波器到MIPI协议分析仪

显示驱动调试工具链全解析:从示波器到MIPI协议分析仪

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/21 1:19:57 阅读更多 →
JavaScript专项算法题(1):回调和高阶函数

JavaScript专项算法题(1):回调和高阶函数

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/21 1:18:57 阅读更多 →

最新新闻

Terminal-Bench完整指南:4步跑通你的第一个AI终端评测

Terminal-Bench完整指南:4步跑通你的第一个AI终端评测

Terminal-Bench完整指南:4步跑通你的第一个AI终端评测 【免费下载链接】terminal-bench-1 A benchmark for LLMs on complicated tasks in the terminal 项目地址: https://gitcode.com/GitHub_Trending/tb/terminal-bench-1 你的Agent演示很精彩&#xff0c…

2026/10/21 2:02:39 阅读更多 →
免 root 三步跑通 WorkTool:你的企业微信自动回复机器人

免 root 三步跑通 WorkTool:你的企业微信自动回复机器人

免 root 三步跑通 WorkTool:你的企业微信自动回复机器人 【免费下载链接】worktool 一款安全稳定的Android无障碍服务工具,支持控制企微/微信来运行的无人值守群管理企业微信机器人 项目地址: https://gitcode.com/GitHub_Trending/wo/worktool W…

2026/10/21 2:02:39 阅读更多 →
STM32驱动W25Q64 SPI Flash实战:从硬件连接到代码实现

STM32驱动W25Q64 SPI Flash实战:从硬件连接到代码实现

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/21 2:02:39 阅读更多 →
如何用 Jasna 自动修复 VR180 视频:从分眼处理到投影选择的完整新手教程

如何用 Jasna 自动修复 VR180 视频:从分眼处理到投影选择的完整新手教程

如何用 Jasna 自动修复 VR180 视频:从分眼处理到投影选择的完整新手教程 【免费下载链接】jasna Video restoration tool 项目地址: https://gitcode.com/GitHub_Trending/ja/jasna Jasna 是一款面向 GPU 的视频修复工具,内置 VR180 自动修复能力…

2026/10/21 2:02:39 阅读更多 →
gamdl:Apple Music 无损下载工具完全指南,一键收藏歌曲与 4K 音乐视频

gamdl:Apple Music 无损下载工具完全指南,一键收藏歌曲与 4K 音乐视频

gamdl:Apple Music 无损下载工具完全指南,一键收藏歌曲与 4K 音乐视频 【免费下载链接】gamdl A command-line app for downloading Apple Music songs, music videos and post videos. 项目地址: https://gitcode.com/GitHub_Trending/ga/gamdl …

2026/10/21 2:02:39 阅读更多 →
Django数据可视化实践:超市销售系统全流程开发与热词分析

Django数据可视化实践:超市销售系统全流程开发与热词分析

毕业设计做到一半才意识到"选对题"比“写代码”重要得多——这是我在带几个应届生做完整套毕设流程后最深的体会。今天这篇想好好拆解一个很有代表性的题目:基于PythonDjango的超市销售系统,以及其中数据可视化模块的具体实现。这个选题好在哪…

2026/10/21 2:01:38 阅读更多 →

日新闻

统一内存+量化:锐龙AI Max PRO 400如何本地跑320B大模型

统一内存+量化:锐龙AI Max PRO 400如何本地跑320B大模型

这段时间硬件圈和AI圈都在传一个事:AMD锐龙AI Max PRO 400系列把最高192GB统一内存搬进了PC形态的产品里,按宣传口径,本地跑320B参数的大家伙不再是纸面概念。我第一反应倒不是“内存真大”,而是这话背后的含金量——它把过去只能…

2026/10/21 0:00:11 阅读更多 →
AI助手深度使用体验:对话质量、长文本处理与指令遵循如何留住用户

AI助手深度使用体验:对话质量、长文本处理与指令遵循如何留住用户

1. 从“封号重开”这个行为说起:用户到底在追求什么“封号重开”这四个字,放在任何产品语境里都带着一股决绝的味道。一个账号从零开始积累使用记录、调教偏好、沉淀工作流,背后是大量的时间和精力成本。正常情况下,没有人愿意主动…

2026/10/21 0:00:11 阅读更多 →
ROS中YOLOv3工程落地:通信同步、坐标变换与性能调优

ROS中YOLOv3工程落地:通信同步、坐标变换与性能调优

1. 为什么在ROS里硬刚YOLOv3不是“炫技”,而是工程落地的必经之路我第一次在某高校机器人实验室看到那台搭载Jetson TX2的移动底盘原地打转、反复识别错垃圾桶时,就意识到:单纯跑通darknet_ros demo和真正让YOLOv3在ROS里“干活”&#xff0c…

2026/10/21 0:00:11 阅读更多 →

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/20 10:02:13 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/20 20:43:59 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/20 2:50:50 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 10:02:08 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:17 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:45 阅读更多 →