【手把手教程】本地运行RuoYi-Cloud

9 本地运行RuoYi-Cloud

笔记介绍

大家好，这里是千寻简笔记，我是作者星辰，笔记内容整理并发布，内容有误请指出，笔记源码已开源，前往Gitee搜索《chihiro-notes》感谢您的观看。

作者各大平台直链： GitHub | Gitee | CSDN

9.1 准备工作

JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
nacos >= 1.1.0 (ruoyi-cloud >= 3.0.0需要下载nacos >= 2.x.x版本)
sentinel >= 1.6.0

9.2 idea 导入项目

• 前往Gitee下载页面(https://gitee.com/y_project/RuoYi-Cloud (opens new window))下载解压到工作目录
• 或者在gitee上fork项目，在使用gitee导入到idea

9.3 导入数据库

• 创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql（必须），quartz.sql（可选）。
• 创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql（必须）。

9.4 Windows安装nacos

• 下载地址：https://github.com/alibaba/nacos/releases

9.4.1 下载完成在解压到磁盘某目录

9.4.2 Nacos持久化

• 防止 Nacos 宕机或重启后数据丢失，Nacos 支持将数据统一持久化到数据库 Mysql(在不配置Nacos持久化到Mysql时，默认 Nacos 内置了一个嵌入式数据库derby，将一些数据保存到了内置的数据库上，多台 Nacos 就会出现多个内置数据库)。

• 连接要进行Nacos持久化的Mysql数据库，新建数据库nacos_config。

• 为什么叫nacos_config这个数据库名，因为上面解压之后的Nacos中的conf目录下的nacos-mysql.sql文件中，其默认的数据库名就是nacos_config。
  

• 新建完数据库之后在此数据库中执行上面的nacos-mysql.sql文件，实现数据库的初始化。

• 然后再回到Nacos解压目录下的conf目录下的application.properties

  #*************** Config Module Related Configurations ***************#
  ### If use MySQL as datasource:
   spring.datasource.platform=mysql
  
  ### Count of DB:
   db.num=1
  
  ### Connect URL of DB:
   db.url.0jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
   db.user=root
   db.password=password
  

9.4.3 启动Nacos

• 然后再回到上面解压目录后的bin目录下。
• 这里的startup.cmd和shtudown.cmd就是在Windows下的启动好关闭命令，但是如果直接双击的话会报错。
• 这是因为这里Nacos没有配置集群模式，而是使用的单机模式，所以编辑startup.cmd。
• 将MODE修改为standalone。

• 编辑之后，双击startup.cmd。

  

• 然后打开浏览器访问：http://localhost:8848/nacos/

• 登录的用户名和密码都为：nacos

• 此时项目中的所有的配置文件都会显示，然后从上往下挨个编辑，把涉及到连接Mysql和Redis的所有地方，改为自己的端口和密码，点击发布即可。

• 以 ruoyi-system-dev.yml为例子，修改mysql和redis用户名和密码。

注意事项：ruoyi-system-dev.yml配置文件需要改为：useSSL=false，才能启动系统模块，没有报错忽略。

9.5 后端项目启动

• 在启动后端项目之前，你需要本地启动Redis服务端，以及Nacos。
• 然后在IDEA中找到。
• ruoyi-gateway下的启动类RuoYiGatewayApplication启动。
• ruoyi-auth下的启动类RuoYiAuthApplication启动。
• ruoyi-modules下的ruoyi-system下的RuoYiSystemApplication并启动。

小技巧：可以新建一个 Compound 把需要启动的启动类加入到里面。

• 如果这三个模块都没有报错则后端启动成。
• 并且可以在Nacos中发现这三个服务。

9.6 前端项目启动

• 前端项目的位置在ruoyi-ui下。

• 右击此项目Open in–> Terminal

• 安装依赖

# 安装依赖
npm install

# 强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npmmirror.com

• 运行前端项目

# 本地开发 启动项目
npm run dev

• 打开浏览器，输入：(http://localhost:80 (opens new window)) 默认账户/密码 admin/admin123）
• 若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

建议使用Git克隆，因为克隆的方式可以和RuoYi随时保持更新同步。使用Git命令克隆

git clone https://gitee.com/y_project/RuoYi-Cloud.git

提示

因为本项目是前后端完全分离的，所以需要前后端都单独启动好，才能进行访问。
前端安装完node后，最好设置下淘宝的镜像源，不建议使用cnpm（可能会出现奇怪的问题）