RuoYi-Vue 本地部署指南从克隆到跑通权限管理后台【免费下载链接】RuoYi-Vue:tada: (RuoYi)官方仓库 基于SpringBootSpring SecurityJWTVue Element 的前后端分离权限管理系统同时提供了 Vue3 的版本项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue假设你要给团队搭一个内部后台要有登录、用户管理、角色权限还要能在线改代码生成 CRUD 页面但又不想从零写这些基础功能。RuoYi-Vue若依就是干这个的一套基于 SpringBoot Spring Security JWT 的后端配一套 Vue 前端把登录认证、菜单权限、代码生成这些每个后台都绕不开的功能全部做完了。你跟着这篇做完本地会有一个可以登录、可以分配权限的权限管理后台后面开发业务功能时只写自己的表和业务代码即可。快速开始从克隆到跑通这一节解决环境怎么配、命令怎么敲、怎么确认启动成功的问题。环境要求组件版本说明JDK17 或更高当前 master 分支基于 Spring Boot 4.xpom.xml 里java.version17/java.versionMySQL8.0存储用户、菜单、字典等基础数据Redis6.x存登录令牌和验证码地址默认localhost:6379Maven3.6构建后端Node.js16前端项目是独立仓库本地联调时需要获取项目与构建克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue cd RuoYi-Vue先建库再导数据。sql/目录下的ry_20260417.sql是系统主数据表quartz.sql是定时任务表两个都要导入缺了后者定时任务模块会报错CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE ry-vue; SOURCE sql/ry_20260417.sql; SOURCE sql/quartz.sql;注意application-druid.yml 里默认库名就是ry-vue建库时保持一致可以少走一步改配置的弯路。确认 MySQL 和 Redis 都起来了构建后端mvn clean install -Dmaven.test.skiptrue看到BUILD SUCCESS即构建成功。然后启动服务Windows 双击 ry.batLinux/Mac 用cd ruoyi-admin/target sh ry.sh start启动成功的验证标志终端日志出现 Spring Boot 启动完成信息Tomcat started on port 8080接着浏览器访问前端页面前端仓库另起见 README.md 的版本分支表用admin / admin123能登录进系统首页就算跑通了。核心能力拆解这一节挑三个最影响日常开发效率的功能说明怎么用、代码在哪。登录认证JWT 无状态登录系统登录走 JWTJSON Web Token一种服务端签发的令牌客户端每次请求带上它服务端验签就知道你是谁不用每次查会话表。认证逻辑集中在 ruoyi-framework/src/main/java/com/ruoyi/framework/security/其中 TokenService.java 负责生成、刷新、校验令牌。打开登录页输入admin / admin123和图形验证码默认是数学运算题类型在 application.yml 的captchaType: math配置登录成功后请求头会带Authorization后续接口靠它识别身份令牌有效期在 application.yml 的token.expireTime默认 30 分钟配置过期会静默续期。权限管理细到按钮的 RBAC权限模型是 RBACRole-Based Access Control基于角色的访问控制用户挂角色角色挂菜单/按钮权限。相关代码在 ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysRoleServiceImpl.java前端页面在独立的 ruoyi-ui 仓库的views/system/下。用 admin 登录后进入「系统管理 → 部门管理」搭好公司/部门树「角色管理」里新建角色勾选它能看到的菜单和按钮比如只给查看不给删除「用户管理」里新建测试账号并分配该角色另开浏览器登录它只能看到和角色匹配的菜单——看到按钮消失了说明权限生效。代码生成一张表变一套 CRUDruoyi-generator/ 是代码生成模块能把一张数据库表变成后端 Controller/Service/Mapper 加前端页面省掉重复的增删改查。核心逻辑在 GenTableServiceImpl.java模板用 Velocity 渲染VelocityInitializer.java。把你的业务表导入 MySQL登录后台进入「系统工具 → 代码生成」点「导入」选表在生成配置里调整字段类型、是否查询条件、表单控件然后「预览」点「下载」得到 zip解压后按提示把 java 代码、vue 页面、sql 各自放入对应位置并执行 sql重启即可在菜单里看到新模块。进阶配置按需修改这一节覆盖两个几乎人人都要改的配置服务端口和数据源。改后端端口端口被占用是最常见的启动失败原因直接改配置最干净。编辑 ruoyi-admin/src/main/resources/application.ymlserver: port: 9090 # 原来是 8080改完重启sh ry.sh restart浏览器访问http://localhost:9090/captchaImage能返回验证码图片 JSON说明端口已切换。注意前端项目里代理的后端地址也要同步改否则前后端对不上。换数据库地址与账号数据源配置在 ruoyi-admin/src/main/resources/application-druid.yml最小改动就是 master 这三行master: url: jdbc:mysql://192.168.1.100:3306/ry-vue?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLtrueserverTimezoneGMT%2B8 username: root password: 你的密码Redis 地址在 application.yml 的spring.data.redis段默认localhost:6379无密码远程部署时记得改。改完重启用 admin 登录能看到用户列表数据说明数据源切换成功。常见问题排查现象 → 原因 → 解决启动报Access denied for user或Unknown database→ 数据库没建库导数据或账号密码与 application-druid.yml 不一致 → 按「快速开始」一节建ry-vue库并导入两个 sql确认用户名密码一致。启动卡在 Redis 连接超时报错→ 本机 Redis 没启动或端口不是 6379 → 启动 Redis 服务远程 Redis 则改 application.yml 中host和password。登录一直提示验证码错误→ 验证码存 RedisRedis 挂了或captchaType配成了char而你按数字算 → 确认 Redis 存活查看 application.yml 里captchaType是math数学题还是char字符。改完端口或数据源不生效→ 改了配置文件但没重启或改错了文件application.yml与application-druid.yml分工不同→ 重启服务数据源相关确认改的是 druid 那个文件。上传头像/附件报路径不存在→ application.yml 里ruoyi.profile默认是D:/ruoyi/uploadPathLinux 上没有这个目录 → 改成实际存在的路径如/home/ruoyi/uploadPath并提前创建。小结到这里你已经在本地跑起来一套带登录认证、角色权限、代码生成的管理后台数据库和 Redis 配好了端口、数据源、上传路径这几个高频配置点也知道了在哪里改。下一步可以看看 ruoyi-quartz/ 里的定时任务模块怎么在线配置 cron 任务或者照着代码生成流程把你自己的第一张业务表变成可操作的页面。更多功能列表和版本分支说明见 README.md环境细节可参考 doc/若依环境使用手册.docx。有踩坑经验欢迎在评论区聊聊。【免费下载链接】RuoYi-Vue:tada: (RuoYi)官方仓库 基于SpringBootSpring SecurityJWTVue Element 的前后端分离权限管理系统同时提供了 Vue3 的版本项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/20 1:46:20 · 阅读 1.2k RuoYi-Vue 本地部署指南：从克隆到跑通权限管理后台
RuoYi-Vue 本地部署指南从克隆到跑通权限管理后台【免费下载链接】RuoYi-Vue:tada: (RuoYi)官方仓库 基于SpringBootSpring SecurityJWTVue Element 的前后端分离权限管理系统同时提供了 Vue3 的版本项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue假设你要给团队搭一个内部后台要有登录、用户管理、角色权限还要能在线改代码生成 CRUD 页面但又不想从零写这些基础功能。RuoYi-Vue若依就是干这个的一套基于 SpringBoot Spring Security JWT 的后端配一套 Vue 前端把登录认证、菜单权限、代码生成这些每个后台都绕不开的功能全部做完了。你跟着这篇做完本地会有一个可以登录、可以分配权限的权限管理后台后面开发业务功能时只写自己的表和业务代码即可。快速开始从克隆到跑通这一节解决环境怎么配、命令怎么敲、怎么确认启动成功的问题。环境要求组件版本说明JDK17 或更高当前 master 分支基于 Spring Boot 4.xpom.xml 里java.version17/java.versionMySQL8.0存储用户、菜单、字典等基础数据Redis6.x存登录令牌和验证码地址默认localhost:6379Maven3.6构建后端Node.js16前端项目是独立仓库本地联调时需要获取项目与构建克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue cd RuoYi-Vue先建库再导数据。sql/目录下的ry_20260417.sql是系统主数据表quartz.sql是定时任务表两个都要导入缺了后者定时任务模块会报错CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE ry-vue; SOURCE sql/ry_20260417.sql; SOURCE sql/quartz.sql;注意application-druid.yml 里默认库名就是ry-vue建库时保持一致可以少走一步改配置的弯路。确认 MySQL 和 Redis 都起来了构建后端mvn clean install -Dmaven.test.skiptrue看到BUILD SUCCESS即构建成功。然后启动服务Windows 双击 ry.batLinux/Mac 用cd ruoyi-admin/target sh ry.sh start启动成功的验证标志终端日志出现 Spring Boot 启动完成信息Tomcat started on port 8080接着浏览器访问前端页面前端仓库另起见 README.md 的版本分支表用admin / admin123能登录进系统首页就算跑通了。核心能力拆解这一节挑三个最影响日常开发效率的功能说明怎么用、代码在哪。登录认证JWT 无状态登录系统登录走 JWTJSON Web Token一种服务端签发的令牌客户端每次请求带上它服务端验签就知道你是谁不用每次查会话表。认证逻辑集中在 ruoyi-framework/src/main/java/com/ruoyi/framework/security/其中 TokenService.java 负责生成、刷新、校验令牌。打开登录页输入admin / admin123和图形验证码默认是数学运算题类型在 application.yml 的captchaType: math配置登录成功后请求头会带Authorization后续接口靠它识别身份令牌有效期在 application.yml 的token.expireTime默认 30 分钟配置过期会静默续期。权限管理细到按钮的 RBAC权限模型是 RBACRole-Based Access Control基于角色的访问控制用户挂角色角色挂菜单/按钮权限。相关代码在 ruoyi-system/src/main/java/com/ruoyi/system/service/impl/SysRoleServiceImpl.java前端页面在独立的 ruoyi-ui 仓库的views/system/下。用 admin 登录后进入「系统管理 → 部门管理」搭好公司/部门树「角色管理」里新建角色勾选它能看到的菜单和按钮比如只给查看不给删除「用户管理」里新建测试账号并分配该角色另开浏览器登录它只能看到和角色匹配的菜单——看到按钮消失了说明权限生效。代码生成一张表变一套 CRUDruoyi-generator/ 是代码生成模块能把一张数据库表变成后端 Controller/Service/Mapper 加前端页面省掉重复的增删改查。核心逻辑在 GenTableServiceImpl.java模板用 Velocity 渲染VelocityInitializer.java。把你的业务表导入 MySQL登录后台进入「系统工具 → 代码生成」点「导入」选表在生成配置里调整字段类型、是否查询条件、表单控件然后「预览」点「下载」得到 zip解压后按提示把 java 代码、vue 页面、sql 各自放入对应位置并执行 sql重启即可在菜单里看到新模块。进阶配置按需修改这一节覆盖两个几乎人人都要改的配置服务端口和数据源。改后端端口端口被占用是最常见的启动失败原因直接改配置最干净。编辑 ruoyi-admin/src/main/resources/application.ymlserver: port: 9090 # 原来是 8080改完重启sh ry.sh restart浏览器访问http://localhost:9090/captchaImage能返回验证码图片 JSON说明端口已切换。注意前端项目里代理的后端地址也要同步改否则前后端对不上。换数据库地址与账号数据源配置在 ruoyi-admin/src/main/resources/application-druid.yml最小改动就是 master 这三行master: url: jdbc:mysql://192.168.1.100:3306/ry-vue?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLtrueserverTimezoneGMT%2B8 username: root password: 你的密码Redis 地址在 application.yml 的spring.data.redis段默认localhost:6379无密码远程部署时记得改。改完重启用 admin 登录能看到用户列表数据说明数据源切换成功。常见问题排查现象 → 原因 → 解决启动报Access denied for user或Unknown database→ 数据库没建库导数据或账号密码与 application-druid.yml 不一致 → 按「快速开始」一节建ry-vue库并导入两个 sql确认用户名密码一致。启动卡在 Redis 连接超时报错→ 本机 Redis 没启动或端口不是 6379 → 启动 Redis 服务远程 Redis 则改 application.yml 中host和password。登录一直提示验证码错误→ 验证码存 RedisRedis 挂了或captchaType配成了char而你按数字算 → 确认 Redis 存活查看 application.yml 里captchaType是math数学题还是char字符。改完端口或数据源不生效→ 改了配置文件但没重启或改错了文件application.yml与application-druid.yml分工不同→ 重启服务数据源相关确认改的是 druid 那个文件。上传头像/附件报路径不存在→ application.yml 里ruoyi.profile默认是D:/ruoyi/uploadPathLinux 上没有这个目录 → 改成实际存在的路径如/home/ruoyi/uploadPath并提前创建。小结到这里你已经在本地跑起来一套带登录认证、角色权限、代码生成的管理后台数据库和 Redis 配好了端口、数据源、上传路径这几个高频配置点也知道了在哪里改。下一步可以看看 ruoyi-quartz/ 里的定时任务模块怎么在线配置 cron 任务或者照着代码生成流程把你自己的第一张业务表变成可操作的页面。更多功能列表和版本分支说明见 README.md环境细节可参考 doc/若依环境使用手册.docx。有踩坑经验欢迎在评论区聊聊。【免费下载链接】RuoYi-Vue:tada: (RuoYi)官方仓库 基于SpringBootSpring SecurityJWTVue Element 的前后端分离权限管理系统同时提供了 Vue3 的版本项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考