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 是一套面向分布式集群场景的开源多租户后台管理系统,完整重写了 RuoYi-Vue 的全部功能,开箱即用。用户、角色、部门、菜单、字典、通知公告这些传统系统模块一应俱全,还内置了多租户隔离、WarmFlow 工作流审批、代码生成器、分布式任务调度、OSS 文件存储等进阶能力。简单说,你想快速搭一套企业级管理后台,又不想从零写框架层,选它做底座再写业务代码,能省下大量重复劳动。

技术栈一览

  • Spring Boot 4.x:整体骨架,应用启动与自动装配全靠它
  • JDK 21:后端最低运行版本,用上了虚拟线程等新特性
  • Sa-Token:轻量级权限认证,登录校验、角色与按钮级权限控制
  • Mybatis-Plus:ORM 层,几乎不用手写 SQL,附带分页、数据权限等插件
  • Redis + Redisson:缓存、分布式锁、限流等分布式能力底座
  • WarmFlow:轻量工作流引擎,支撑复杂审批流
  • SpringDoc:接口文档自动生成,零注解入侵
  • Hutool / Lombok:工具方法与样板代码简化,日常开发提效

动手前的环境检查清单

  • ✅JDK 21(java -version确认,低于 21 无法编译)
  • ✅Maven 3.8+(仓库自带mvnw包装器,没有 Maven 也能构建)
  • ✅MySQL 8.x(默认数据源,其他数据库需自行改配置)
  • ✅Redis 6+(登录认证依赖缓存,必装)

分步把项目跑起来

一键拉取代码

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

拉下来就是一个标准多模块 Maven 工程,ruoyi-admin/ 是可执行的主应用模块。

初始化数据库

在 MySQL 中建库并导入脚本,默认配置连的库名是ry-vue:

mysql -uroot -p -e "create database \`ry-vue\` default charset utf8mb4"

然后执行 script/sql/ry_vue.sql(用到审批功能再导入ry_workflow.sql)。表结构和默认账号数据都在脚本里,导入即可。

启动后端服务

修改ruoyi-admin下application-dev.yml中的数据库账号密码为你本机实际值(默认 dev 配置是 root/root),然后:

mvn clean install -DskipTests

首次构建会拉大量依赖,耐心等待。构建成功后启动主应用:

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

看到日志出现启动成功、端口 8080 被监听,后端就算就位了。本项目前端是独立的 plus-ui 工程,仓库内不含前端代码,本文只跑通后端。

跑通了没?这样确认

浏览器访问http://localhost:8080,不再报 404/502 而是有 JSON 响应,说明服务已起。再访问接口文档http://localhost:8080/v3/api-docs,能返回 OpenAPI JSON(或 swagger-ui 页面),RuoYi-Vue-Plus 安装即告完成。用 SQL 脚本里的 admin 账号走登录接口,能拿到 token 就彻底通了。

卡住了先查这里

  1. 8080 端口被占用:启动日志报Port 8080 was already in use,改application.yml里的server.port,或停掉占用端口的进程。
  2. 数据库连不上:启动即抛Communications link failure,检查 MySQL 是否在跑、ry-vue库是否导入、yml 里的账号密码与useSSL=true参数是否和本机 MySQL 匹配。
  3. 依赖下载失败:Maven 拉包报超时/401,优先检查镜像源配置(settings.xml),国内网络建议换成阿里云或腾讯云镜像仓库。
  4. JDK 版本不对:编译报invalid target release: 21,说明当前 JDK 低于 21,切换或升级 JDK 后重新构建。

想省事的话,仓库还带了 script/docker/docker-compose.yml,一条命令拉起 MySQL、Redis、MinIO 等全套环境,适合不想本机装依赖的同学。

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

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

相关新闻

永磁同步电机MTPA弱磁前馈补偿双闭环控制全解析

永磁同步电机MTPA弱磁前馈补偿双闭环控制全解析

/* 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:40:26 阅读更多 →
汽车电子压电陶瓷选型指南:从材料参数到失效排查

汽车电子压电陶瓷选型指南:从材料参数到失效排查

/* 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:40:26 阅读更多 →
AI芯片软硬件协同设计:算子映射与性能验证的关键路径

AI芯片软硬件协同设计:算子映射与性能验证的关键路径

/* 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:40:26 阅读更多 →

最新新闻

腾讯云ASR实时语音识别前端接入:WebSocket签名与音频处理实战

腾讯云ASR实时语音识别前端接入:WebSocket签名与音频处理实战

前阵子我在给一个内部工具加“实时转写”功能,要把对话语音实时转成文字用于内容分析。调研了一圈,最后选了腾讯云 ASR 实时语音识别。原本以为就是“拿麦克风录音,发到 WebSocket,收文本”三件事,实际做下来发现每个环…

2026/10/21 3:54:34 阅读更多 →
Linux V4L2视频采集四步流程:打开→查询→设置→启动

Linux V4L2视频采集四步流程:打开→查询→设置→启动

1. 项目概述:为什么V4L2是Linux视频设备的“底层语言”在Linux系统里,但凡你接触过USB摄像头、树莓派CSI模组、工业面阵相机,甚至某些PCIe采集卡,几乎绕不开一个词:V4L2。它不是某个具体软件,也不是命令行工…

2026/10/21 3:54:34 阅读更多 →
Flutter GestureDetector 手势系统深度解析:从原理到高性能实践

Flutter GestureDetector 手势系统深度解析:从原理到高性能实践

1. 为什么说 GestureDetector 是 Flutter 手势世界的“总开关”在 Flutter 开发中,你写过多少次onTap?又是否曾疑惑:明明只是点了一下屏幕,背后却触发了onTapDown、onTapUp、onTapCancel一整套回调?或者,你…

2026/10/21 3:54:34 阅读更多 →
Qwen2.5-VL跨硬件微调:LoRA与OFT在昇腾910B与4090上的实战

Qwen2.5-VL跨硬件微调:LoRA与OFT在昇腾910B与4090上的实战

这个项目的起因很现实:手上的多模态微调代码在单张4090上调得好好的,业务方突然要求国产算力平台也能跑,而基于Qwen2.5-VL的私域图像理解任务又必须保留原有效果。于是就有了标题里那条主线——从LoRA到OFT,从昇腾910B到4090&…

2026/10/21 3:54:34 阅读更多 →
深入Linux内存管理:伙伴系统与slab分配器核心原理

深入Linux内存管理:伙伴系统与slab分配器核心原理

前段时间在压测一个存储服务时,我发现一个奇怪的现象:明明内存总量还很充足,但每次接口申请一个8KB的连续块时,耗时总会偶发冲到几百微秒甚至毫秒级。查到最后,问题不在业务代码,而在内存管理这一层——更具…

2026/10/21 3:54:34 阅读更多 →
FFmpeg输入源处理:本地文件与网络流读取的底层逻辑与实战

FFmpeg输入源处理:本地文件与网络流读取的底层逻辑与实战

FFmpeg 这个工具,刚接触音视频开发的人往往会被它庞大的参数体系劝退,但真正用起来之后又会发现,很多看似复杂的需求,其实一条命令就能搞定。这次要聊的是 FFmpeg 读取本地文件和网络流这两种输入源的处理方式,属于系列…

2026/10/21 3:53:34 阅读更多 →

日新闻

统一内存+量化:锐龙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 阅读更多 →