十分钟从零跑通 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 的多租户后台管理系统，面向分布式集群场景做了全方位升级。这篇新手教程带你从零开始完成本地部署与环境搭建：克隆代码、配置数据库、构建后端并拉起前端，一步步把整套系统跑起来。
项目速览：一张表看懂前后端选型
在动手前，先搞清楚这套系统由哪些部分组成，避免装错环境。
| 层次 | 技术选型 | 通俗解释 |
|---|---|---|
| 后端运行时 | Java 21 + Spring Boot 4.1 | 系统核心，负责所有接口与业务逻辑 |
| 持久层 | Mybatis-Plus | 几乎不用手写 SQL 就能完成增删改查 |
| 权限认证 | Sa-Token | 管登录、鉴权、角色权限 |
| Web 容器 | Jetty | 处理 HTTP 请求的高性能服务器 |
| 缓存 | Redis + Redisson | 加速查询、支撑分布式锁与限流 |
| 接口文档 | SpringDoc | 自动把代码注释变成在线文档 |
| 前端 | Vue 3 + TypeScript + Element Plus | 官方独立前端项目，需单独获取 |
这里要提醒一句：前端是一个独立仓库，并不包含在本后端项目里，所以「克隆后端 → 启动前端」其实是两套代码，后面会分别处理。
动手前：环境与依赖核对清单 ✅
先花一分钟把环境对齐，能省掉后面大半的报错。
| 依赖项 | 版本建议 | 用途 |
|---|---|---|
| JDK | 21（25 亦可） | 编译与运行后端 |
| Maven | 3.6+，或直接用仓库自带 mvnw | 管理依赖、打包 |
| MySQL | 8.x | 主数据库 |
| Redis | 6 以上，建议 8.x | 缓存与会话 |
| Node.js | 最新 LTS | 构建前端 |
| Git | 最新稳定版 | 拉取源码 |
仓库自带了 Maven Wrapper（mvnw），即使本机没装 Maven 也能正常构建，这点后面会用到。
部署全流程
下面按「克隆 → 配库 → 构建 → 前端」的顺序推进，每一步都给出最小必要命令。
第一步：一键克隆代码
把后端项目拉到本地：
git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus进入项目根目录后，你可以先翻一眼 script/sql/ry_vue.sql，这是初始化系统要用的数据库脚本。
第二步：数据库配置最小改动
系统默认连 MySQL，库名为ry-vue。先建库并导入脚本：
mysql -uroot -proot -e "CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4;" mysql -uroot -proot ry-vue < script/sql/ry_vue.sql项目默认激活dev环境，application-dev.yml里主库账号是root/root、连localhost。如果本机的 MySQL 账号密码不同，只需改这一处：
datasource: master: username: 你的账号 password: 你的密码同理，Redis 默认密码在配置里是ruoyi123，若你的 Redis 密码不同，也在这里一并改掉。
第三步：构建并启动后端
用仓库自带的 Wrapper 打包，跳过测试可加快首次构建：
./mvnw clean package -DskipTests java -jar ruoyi-admin/target/ruoyi-admin.jar如果你更希望以开发态热启动，也可以直接：
./mvnw -pl ruoyi-admin spring-boot:run看到启动日志出现端口 8080 且没有异常，说明后端已经就绪。
第四步：启动前端 🚀
前端是独立的 plus-ui 项目，需要从官方渠道单独获取后，再进入它的目录执行：
npm install npm run dev若只想用容器一把梭，仓库也提供了 script/docker/docker-compose.yml，可一键拉起 MySQL、Redis、MinIO、Nginx 与后端服务，适合不想逐个装环境的你。
首次访问与自检
两个默认地址记好：
- 后端：
http://localhost:8080 - 前端：
http://localhost（Nginx 默认 80 端口）
怎么确认真的部署成功了？做三件小事即可：
- 打开前端首页，能看到登录框并弹出图形验证码，说明前后端已打通；
- 访问后端的接口文档路径（
/api-docs），能列出接口列表，说明 SpringDoc 正常； - 用默认账号登录，能进入系统首页且菜单加载出来，说明数据库脚本导入无误。
踩坑提示 ⚠️
- JDK 版本不对：很多人习惯用 8 或 17，但本项目要求 21，启动会直接报版本不兼容。用
java -version确认一下。 - 数据库 / Redis 连不上：启动日志里报连接超时，多半是服务没起、或
dev配置里的账号密码与你本机不一致，回头核对第二步。 - 8080 端口被占用：报
Port already in use时，改一下配置里的server.port，或用命令查出并停掉占用进程。
跑通之后，建议先别急着改代码，先花几分钟把登录、菜单、代码生成几个基础功能点一遍，心里有数后再展开自己的业务。
【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
