ruoyi-vue-pro介绍:
- 前端采用 vue-element-admin ,正在支持 Vue 3 + ElementUI Plus 最新方案。
- 后端采用 Spring Boot、MySQL + MyBatis Plus、Redis + Redisson。
- 权限认证使用 Spring Security & Token & Redis,支持多终端、多种用户的认证系统。
- 支持加载动态权限菜单,按钮级别权限控制,本地缓存提升性能。
- 工作流使用 Activiti ,支持动态表单、在线设计流程、多种任务分配方式。
- 高效率开发,使用代码生成器可以一键生成前后端代码 + 单元测试 + Swagger 接口文档 + Validator 参数校验。
- 集成微信小程序、微信公众号、企业微信、钉钉等三方登陆,集成支付宝、微信等支付与退款。
- 集成阿里云、腾讯云、云片等短信渠道,集成阿里云、腾讯云、七牛云等云存储服务。
1. 克隆代码
使用 IDEA 克隆代码,地址是
https://gitee.com/zhijiantianya/ruoyi-vue-pro
https://github.com/YunaiV/ruoyi-vue-pro克隆完成后,耐心等待 Maven 下载完相关的依赖。
Maven阿里云镜像

mirrors标签里边增加
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>

yudao-dependencies | Maven 依赖版本管理 |
yudao-framework | Java 框架拓展 |
yudao-server | 管理后台 + 用户 APP 的服务端 |
yudao-admin-ui | 管理后台的 UI 界面 |
yudao-user-ui | 用户 APP 的 UI 界面 |
yudao-module-system | 系统功能的 Module 模块 |
yudao-module-member | 会员中心的 Module 模块 |
yudao-module-infra | 基础设施的 Module 模块 |
yudao-module-tool | 研发工具的 Module 模块 |
yudao-module-bpm | 工作流程的 Module 模块 |
yudao-module-pay | 支付系统的 Module 模块 |
项目 | 说明 |
使用的 SpringBoot 版本是最新的 2.5.9,所以需要下载一段时间。
2. 初始化 MySQL
项目中的数据,都存储到 MySQL 之中,所以需要在本地搭建一个 MySQL 服务,建议使用 5.7 版本。
新建一个名字为
ruoyi-vue-pro数据库,然后执行 sql 目录下的 SQL,进行初始化。

友情提示:注意,默认配置下,MySQL 需要启动在 3306 端口,且数据库名必须为
ruoyi-vue-pro3. 初始化 Redis
项目中的缓存,都存储到 Redis 之中,所以需要在本地搭建一个 Redis 服务。
一定要使用 5.0 以上的版本,项目使用 Redis Stream 作为消息队列。
友情提示:注意,默认配置下,Redis 需要启动在 6379 端口。
Windows 安装 Redis 指南:Redis 安装指南(Windows 版本) | 芋道源码 —— 纯源码解析博客
- Mac 安装 Redis 指南:Redis 安装指南(Mac 版本) | 芋道源码 —— 纯源码解析博客
4. 启动后端项目【管理后台】
yudao-server 是后端项目,提供管理后台、用户 APP 的 RESTful API 接口。
① 第一步,在控制台执行
mvn clean package -Dmaven.test.skip=true命令,将项目进行初始化的打包,预计需要 1 分钟左右。成功后,控制台日志如下:
[INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:12 min [INFO] Finished at: 2022-02-12T09:52:38+08:00 [INFO] Final Memory: 250M/2256M [INFO] ------------------------------------------------------------------------ |
② 第二步,执行 YudaoServerApplication 类,进行启动。
启动完成后,使用浏览器访问 http://127.0.0.1:48080 地址,返回如下 JSON 字符串,说明成功。
{ "code": 401, "data": null, "msg": "账号未登录" } |
友情提示:注意,默认配置下,后端项目启动在 48080 端口。
如果报 “Command line is too long” 错误,参考

5. 启动前端项目【管理后台】
yudao-admin-ui 是管理后台的前端项目。一共有两种方式:
① 内嵌模式:无需配置前端开发环境,可以进行快速体验。每次发布版本时,艿艿会将
yudao-admin-ui编译成静态资源,放置到
yudao-server中,使用 Spring Boot 转发静态资源。

- ② 完整模式:需要配置前端开发环境,适合进行前端功能的开发。
根据自己的情况,选择合适的方式。如果你是一个后端开发,对前端了解相对较少,建议先采用方式一,能够快速的 run 起来!
5.1 方式一:内嵌模式
使用浏览器,直接访问 http://127.0.0.1:48080/admin-ui 地址,可以看到前端界面。
5.2 方式二:完整模型
在
yudao-admin-ui目录下,执行如下命令,进行启动:
# 进入项目目录
cd yudao-admin-ui
# 安装依赖
# 建议不要直接使用 cnpm 安装依赖,会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npm.taobao.org
# 启动服务
npm run dev
友情提示:本地没有安装 Node.js 的环境,导致报错。可以参考如下文档安装:
Windows 安装 Node.js 指南:NodeJS 安装指南(Windows 版本) | 芋道源码 —— 纯源码解析博客
Mac 安装 Node.js 指南:NodeJS 安装指南(Mac 版本) | 芋道源码 —— 纯源码解析博客
注意,Node 请使用 14 或者 16 的版本!!!例如说
Now using node v14.15.3 (npm v6.14.9)版本。
启动完成后,浏览器会自动打开 http://localhost:1024 地址,可以看到前端界面。
















