ruoyi-vue-pro部署文档

ruoyi-vue-pro介绍:

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

官方部署文档：芋道后台 yudao 搭建调试环境 | 芋道源码 —— 纯源码解析博客

官方文档：简介 | ruoyi-vue-pro 开发手册

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>

使用的 SpringBoot 版本是最新的 2.5.9，所以需要下载一段时间。

2. 初始化 MySQL

项目中的数据，都存储到 MySQL 之中，所以需要在本地搭建一个 MySQL 服务，建议使用 5.7 版本。

新建一个名字为 

ruoyi-vue-pro

 数据库，然后执行 sql 目录下的 SQL，进行初始化。

友情提示：注意，默认配置下，MySQL 需要启动在 3306 端口，且数据库名必须为 

ruoyi-vue-pro

3. 初始化 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 分钟左右。成功后，控制台日志如下：

② 第二步，执行 YudaoServerApplication 类，进行启动。

启动完成后，使用浏览器访问 http://127.0.0.1:48080 地址，返回如下 JSON 字符串，说明成功。

友情提示：注意，默认配置下，后端项目启动在 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 地址，可以看到前端界面。