十分钟从零跑通 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-PlusRuoYi-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官方独立前端项目需单独获取这里要提醒一句前端是一个独立仓库并不包含在本后端项目里所以「克隆后端 → 启动前端」其实是两套代码后面会分别处理。动手前环境与依赖核对清单 ✅先花一分钟把环境对齐能省掉后面大半的报错。依赖项版本建议用途JDK2125 亦可编译与运行后端Maven3.6或直接用仓库自带 mvnw管理依赖、打包MySQL8.x主数据库Redis6 以上建议 8.x缓存与会话Node.js最新 LTS构建前端Git最新稳定版拉取源码仓库自带了 Maven Wrappermvnw即使本机没装 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://localhostNginx 默认 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），仅供参考