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 的分布式多租户后台管理系统集成 Sa-Token、Mybatis-Plus、WarmFlow 工作流。跟完本文做一次 RuoYi-Vue-Plus 部署你得到的是一套能登录的管理后台用户、角色、菜单、字典、代码生成、流程审批全部可用接口文档页面同步打开Redis 里实时记录着每个在线会话。️ 部署效果预览跑起来后你能访问三个地址后端接口http://localhost:8080默认端口 8080Jetty 容器接口文档http://localhost:8080/api-docs按演示模块/系统模块/工作流模块分组展示全部 API前端界面官方前端项目 plus-ui 单独部署后指向 8080默认账号admin/ 密码admin123带数学验证码登录后端支持多实例同时启动Docker 编排里就有ruoyi-server1、ruoyi-server2两个实例分别占 8080、8081 端口同一账号在两台机器上登录互不冲突这就是分布式会话的实际形态。 开工前体检对照下表确认环境缺哪项补哪项依赖版本要求是否必须用途JDK21 及以上是运行与编译6.0.0 版已不支持 JDK 8Maven3.6是构建仓库自带mvnw可免装MySQL5.7 / 8.x是主数据库也支持 Oracle、PostgreSQL、SQLServerRedis6.0是缓存、分布式会话、分布式锁Lock4j/RedissonNode.js14可选本地跑前端 plus-ui 时需要Docker可选可选用 script/docker/docker-compose.yml 一键拉起全套环境 快速通道最短路径把服务跑起来第 1 步拉代码git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus做完的标志目录里能看到ruoyi-admin、ruoyi-common、ruoyi-modules、ruoyi-extend四个模块。第 2 步构建打包mvn clean package -DskipTests做完的标志终端出现BUILD SUCCESS且ruoyi-admin/target/下生成了可执行 jar。第 3 步初始化数据库建库并导入脚本库名必须叫ry-vue与默认配置一致mysql -uroot -p -e CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4 mysql -uroot -p ry-vue script/sql/ry_vue.sql做完的标志show tables;能看到sys_user、sys_menu、sys_role等 20 多张表。用到定时任务或工作流时再把 script/sql/ 里的ry_job.sql、ry_workflow.sql一并导入。第 4 步直接启动java -jar ruoyi-admin/target/ruoyi-admin.jar开发默认配置读的是 ruoyi-admin/src/main/resources/application-dev.ymlMySQL 走localhost:3306/ry-vueroot/rootRedis 密码ruoyi123。做完的标志日志出现Started DromaraApplication浏览器打开http://localhost:8080/api-docs能列出全部接口分组。 正式环境改造数据库、缓存与关键配置正式部署只改这几处都在 ruoyi-admin/src/main/resources/application-dev.yml生产可复制到 application-prod.yml 同结构位置数据源把地址、账号密码换成你的spring.datasource.dynamic.datasource.master: url: jdbc:mysql://你的地址:3306/ry-vue?useUnicodetruecharacterEncodingutf8useSSLtrueserverTimezoneGMT%2B8 username: 你的账号 password: 你的密码Redis密码必须改生产建议开启认证spring.data.redis: host: 你的redis地址 port: 6379 password: 你的密码另外两处按需检查ruoyi-admin/src/main/resources/application.yml 里的sa-token.jwt-secret-key换掉示例值captcha.enable生产环境保持true。数据库为 MySQL、Oracle、PostgreSQL、SQLServer 时参考对应目录的脚本script/sql/oracle/、script/sql/postgres/、script/sql/sqlserver/。 企业级特性开关多租户租户隔离依赖 Mybatis-Plus 的TenantLineInnerInterceptor插件注册点在 ruoyi-common/ruoyi-common-mybatis 的MybatisPlusConfig。当前仓库未携带租户模块与sys_tenant表需要多租户隔离的团队按官方文档引入对应扩展包后在插件链里启用即可生效。分布式会话Sa-Token 的会话数据默认落 Redis无需额外开关。行为由 ruoyi-admin/src/main/resources/application.yml 中sa-token.is-concurrent是否允许同账号并发登录与is-share多端是否共用一个 token控制。生效条件所有实例连同一个 Redis会话即在集群间自动同步。工作流warm-flow.enabled: true默认开启审批流设计器 UI 随之可用snail-job、snail-ai客户端默认enabled: false需要分布式任务调度或 AI 能力时再打开并部署对应 Server见 ruoyi-extend/。✅ 上线前体检冒烟测试清单启动日志无 ERRORStarted DromaraApplication正常出现用admin/admin123登录数学验证码校验通过进用户管理新建一个测试用户再进角色管理分配菜单验证写入切换新用户登录旧账号的数据权限范围是否符合预期读权限验证登录日志操作日志能看到刚才的记录数据库读写闭环在线用户页面能看到两个登录会话强制踢出其中一个被踢端刷新后提示 token 失效分布式会话验证http://localhost:8080/api-docs各分组接口可点开全部通过就可以交付使用了。⚡ 性能调优进阶可选数据库连接池Hikaridev 默认值在 application-dev.ymlmaxPoolSize默认 20按CPU核数 × 2 磁盘数估算上调minIdle建议与最大值一致避免抖动maxLifetime保持 30 分钟小于 MySQL 的wait_timeout。Jetty 线程application.yml 中server.jetty.threads.max控制最大并发任务数SSE 长连接会持续占用槽位按在线用户量调整默认 20000 偏大中小站点收到几千即可。JVM 参数8GB 内存机器建议-Xms2g -Xmx4g用java -Xms2g -Xmx4g -jar启动。批量写入JDBC URL 已带rewriteBatchedStatementstrue批量操作性能提升明显保持即可。 救火手册高频故障速查现象启动报Communications link failure/ 连接拒绝。原因MySQL 没起、库名不是ry-vue或密码不对。解法确认mysql服务在跑库名拼写一致配置里账号密码与mysql -u -p手动登录验证一致。现象报 Redis 认证错误WRONGPASS或连接超时。原因Redis 开了密码但配置还是ruoyi123或端口被防火墙挡了。解法把spring.data.redis.password改成实际密码redis-cli ping先测通。现象8080 端口被占用进程起不来。原因本机已有服务占端口。解法启动加参数-Dserver.port8081换端口前端代理地址同步改。现象mvn clean package报 Java 版本或编译错误。原因本机是 JDK 8/17项目要求 JDK 21。解法java -version确认版本换成 21 再执行。现象登录页报获取验证码失败或接口 500。原因库没导全缺sys_client等表。解法重新核对ry_vue.sql导入是否完整select count(*) from sys_client;应大于 0。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/21 1:39:15 · 阅读 1.2k 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 的分布式多租户后台管理系统集成 Sa-Token、Mybatis-Plus、WarmFlow 工作流。跟完本文做一次 RuoYi-Vue-Plus 部署你得到的是一套能登录的管理后台用户、角色、菜单、字典、代码生成、流程审批全部可用接口文档页面同步打开Redis 里实时记录着每个在线会话。️ 部署效果预览跑起来后你能访问三个地址后端接口http://localhost:8080默认端口 8080Jetty 容器接口文档http://localhost:8080/api-docs按演示模块/系统模块/工作流模块分组展示全部 API前端界面官方前端项目 plus-ui 单独部署后指向 8080默认账号admin/ 密码admin123带数学验证码登录后端支持多实例同时启动Docker 编排里就有ruoyi-server1、ruoyi-server2两个实例分别占 8080、8081 端口同一账号在两台机器上登录互不冲突这就是分布式会话的实际形态。 开工前体检对照下表确认环境缺哪项补哪项依赖版本要求是否必须用途JDK21 及以上是运行与编译6.0.0 版已不支持 JDK 8Maven3.6是构建仓库自带mvnw可免装MySQL5.7 / 8.x是主数据库也支持 Oracle、PostgreSQL、SQLServerRedis6.0是缓存、分布式会话、分布式锁Lock4j/RedissonNode.js14可选本地跑前端 plus-ui 时需要Docker可选可选用 script/docker/docker-compose.yml 一键拉起全套环境 快速通道最短路径把服务跑起来第 1 步拉代码git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus做完的标志目录里能看到ruoyi-admin、ruoyi-common、ruoyi-modules、ruoyi-extend四个模块。第 2 步构建打包mvn clean package -DskipTests做完的标志终端出现BUILD SUCCESS且ruoyi-admin/target/下生成了可执行 jar。第 3 步初始化数据库建库并导入脚本库名必须叫ry-vue与默认配置一致mysql -uroot -p -e CREATE DATABASE ry-vue DEFAULT CHARACTER SET utf8mb4 mysql -uroot -p ry-vue script/sql/ry_vue.sql做完的标志show tables;能看到sys_user、sys_menu、sys_role等 20 多张表。用到定时任务或工作流时再把 script/sql/ 里的ry_job.sql、ry_workflow.sql一并导入。第 4 步直接启动java -jar ruoyi-admin/target/ruoyi-admin.jar开发默认配置读的是 ruoyi-admin/src/main/resources/application-dev.ymlMySQL 走localhost:3306/ry-vueroot/rootRedis 密码ruoyi123。做完的标志日志出现Started DromaraApplication浏览器打开http://localhost:8080/api-docs能列出全部接口分组。 正式环境改造数据库、缓存与关键配置正式部署只改这几处都在 ruoyi-admin/src/main/resources/application-dev.yml生产可复制到 application-prod.yml 同结构位置数据源把地址、账号密码换成你的spring.datasource.dynamic.datasource.master: url: jdbc:mysql://你的地址:3306/ry-vue?useUnicodetruecharacterEncodingutf8useSSLtrueserverTimezoneGMT%2B8 username: 你的账号 password: 你的密码Redis密码必须改生产建议开启认证spring.data.redis: host: 你的redis地址 port: 6379 password: 你的密码另外两处按需检查ruoyi-admin/src/main/resources/application.yml 里的sa-token.jwt-secret-key换掉示例值captcha.enable生产环境保持true。数据库为 MySQL、Oracle、PostgreSQL、SQLServer 时参考对应目录的脚本script/sql/oracle/、script/sql/postgres/、script/sql/sqlserver/。 企业级特性开关多租户租户隔离依赖 Mybatis-Plus 的TenantLineInnerInterceptor插件注册点在 ruoyi-common/ruoyi-common-mybatis 的MybatisPlusConfig。当前仓库未携带租户模块与sys_tenant表需要多租户隔离的团队按官方文档引入对应扩展包后在插件链里启用即可生效。分布式会话Sa-Token 的会话数据默认落 Redis无需额外开关。行为由 ruoyi-admin/src/main/resources/application.yml 中sa-token.is-concurrent是否允许同账号并发登录与is-share多端是否共用一个 token控制。生效条件所有实例连同一个 Redis会话即在集群间自动同步。工作流warm-flow.enabled: true默认开启审批流设计器 UI 随之可用snail-job、snail-ai客户端默认enabled: false需要分布式任务调度或 AI 能力时再打开并部署对应 Server见 ruoyi-extend/。✅ 上线前体检冒烟测试清单启动日志无 ERRORStarted DromaraApplication正常出现用admin/admin123登录数学验证码校验通过进用户管理新建一个测试用户再进角色管理分配菜单验证写入切换新用户登录旧账号的数据权限范围是否符合预期读权限验证登录日志操作日志能看到刚才的记录数据库读写闭环在线用户页面能看到两个登录会话强制踢出其中一个被踢端刷新后提示 token 失效分布式会话验证http://localhost:8080/api-docs各分组接口可点开全部通过就可以交付使用了。⚡ 性能调优进阶可选数据库连接池Hikaridev 默认值在 application-dev.ymlmaxPoolSize默认 20按CPU核数 × 2 磁盘数估算上调minIdle建议与最大值一致避免抖动maxLifetime保持 30 分钟小于 MySQL 的wait_timeout。Jetty 线程application.yml 中server.jetty.threads.max控制最大并发任务数SSE 长连接会持续占用槽位按在线用户量调整默认 20000 偏大中小站点收到几千即可。JVM 参数8GB 内存机器建议-Xms2g -Xmx4g用java -Xms2g -Xmx4g -jar启动。批量写入JDBC URL 已带rewriteBatchedStatementstrue批量操作性能提升明显保持即可。 救火手册高频故障速查现象启动报Communications link failure/ 连接拒绝。原因MySQL 没起、库名不是ry-vue或密码不对。解法确认mysql服务在跑库名拼写一致配置里账号密码与mysql -u -p手动登录验证一致。现象报 Redis 认证错误WRONGPASS或连接超时。原因Redis 开了密码但配置还是ruoyi123或端口被防火墙挡了。解法把spring.data.redis.password改成实际密码redis-cli ping先测通。现象8080 端口被占用进程起不来。原因本机已有服务占端口。解法启动加参数-Dserver.port8081换端口前端代理地址同步改。现象mvn clean package报 Java 版本或编译错误。原因本机是 JDK 8/17项目要求 JDK 21。解法java -version确认版本换成 21 再执行。现象登录页报获取验证码失败或接口 500。原因库没导全缺sys_client等表。解法重新核对ry_vue.sql导入是否完整select count(*) from sys_client;应大于 0。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考