十分钟从零跑通 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），仅供参考

十分钟从零跑通 RuoYi-Vue-Plus：本地部署与配置完整指南

相关推荐

【译】告知您的模型何时需要进行深度思考

基于SpringBoot+Vue的健身房会员管理系统（设计与实现）

Vue3——第 7 篇：组件基础——从注册到使用的完整流程

更多资讯

大模型推理的周期性建模：从循环检测到干预策略的工程实践

Delphi 12串口通信控件深度解析：线程安全、协议解析与Win11兼容

AI短剧创作系统自研与贴牌合作：技术拆解与变现全攻略

AI短剧平台抽成太狠？自研创作系统贴牌合作，把收益握在自己手里

Flutter鸿蒙跨平台适配实战：从零搭建到真机运行

Docker+WordPress阿里云部署实战：从零搭建高可用个人博客

今日更新

微信云开发旅游小程序实战：LBS打卡+UGC社交全栈方案

金融AI代理平台核心拆解：从多代理协作到财报分析实战

基于大数据的智慧旅游推荐与可视化平台架构实践

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

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

本月热门

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

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

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？