RuoYi Cloud 3.6.4 单机快速部署

本文介绍如何快速在本地搭建 RuoYi Cloud 3.6.4 开发环境。

本文参考：

在开始之前，假设已经安装了以下：

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

及 IntelliJ IDEA。

注意：

最新 RuoYi-Cloud 版本 >=3.0.0 需要下载的 nacos-server 必须>=2.x.x版本。
默认配置单机模式，nacos 集群/多集群部署模式参考 (Nacos 支持三种部署模式)

1、下载源码

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

初始化数据库
要导入 sql 数据，在 ./sql/ 目录中。

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

根据需要是否需要集成 seata 分布式事务
创建数据库 ry-seata 并导入数据脚本 ry_seata_2021xxxx.sql（可选）

连接 Nacos
如有需要参见 Nacos 部署。

留意，ry-config 数据库是 Nacos 数据库。执行的 SQL 脚本中，已包含各微服务的配置。

在各项目下 bootstrap.yml 下，配置 nacos 地址。

cloud:
  nacos:
    discovery:
      # 服务注册地址
      server-addr: 127.0.0.1:8848
    config:
      # 配置中心地址
      server-addr: 127.0.0.1:8848

如果启动微服务时报错，尝试更改为 Nacos 配置中心地址为实际地址，如 192.168.199.129:8848。

2、Nacos 配置
如果，你的 Redis 增加了密码访问或数据库帐户有变更，则需要登录配置中心，更新配置。
如，http://127.0.0.1:8848/nacos/。

以下是一些配置，你需要手动修改配置：

application-dev.yml
ruoyi-gateway-dev.yml
ruoyi-auth-dev.yml
ruoyi-monitor-dev.yml
ruoyi-system-dev.yml
ruoyi-gen-dev.yml
ruoyi-job-dev.yml
ruoyi-file-dev.yml
sentinel-ruoyi-gateway

如，调整为：

spring:
  redis:
    host: 127.0.0.1
    port: 6379
    password: redispass
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/ry-cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: ry-cloud
    password: 123456

3、服务启动

打开运行基础模块（启动没有先后顺序）

使用 IntelliJ IDEA 打开项目，等待编辑器初始化完成。并一一启动各服务。

RuoYiGatewayApplication （网关模块必须）
RuoYiAuthApplication （认证模块必须）
RuoYiSystemApplication （系统模块必须）
RuoYiMonitorApplication （监控中心可选）
RuoYiGenApplication （代码生成可选）
RuoYiJobApplication （定时任务可选）
RuoYFileApplication （文件服务可选）

4、端口和目录结构

com.ruoyi
├── ruoyi-ui              // 前端框架 [80]
├── ruoyi-gateway         // 网关模块 [8080]
├── ruoyi-auth            // 认证中心 [9200]
├── ruoyi-api             // 接口模块
│       └── ruoyi-api-system                          // 系统接口
├── ruoyi-common          // 通用模块
│       └── ruoyi-common-core                         // 核心模块
│       └── ruoyi-common-datascope                    // 权限范围
│       └── ruoyi-common-datasource                   // 多数据源
│       └── ruoyi-common-log                          // 日志记录
│       └── ruoyi-common-redis                        // 缓存服务
│       └── ruoyi-common-seata                        // 分布式事务
│       └── ruoyi-common-security                     // 安全模块
│       └── ruoyi-common-swagger                      // 系统接口
├── ruoyi-modules         // 业务模块
│       └── ruoyi-system                              // 系统模块 [9201]
│       └── ruoyi-gen                                 // 代码生成 [9202]
│       └── ruoyi-job                                 // 定时任务 [9203]
│       └── ruoyi-file                                // 文件服务 [9300]
├── ruoyi-visual          // 图形化管理模块
│       └── ruoyi-visual-monitor                      // 监控中心 [9100]
├──pom.xml                // 公共依赖

5、实际部署遇到的问题

1、防火墙拦截问题，造成 Nacos 无法连接
2、Nacos 使用 127.0.0.1 连接并不行，需要实际 IP，如 192.168.199.129。
3、Redis、MySQL 配置更新，需要手动删除 Nacos 缓存（Nacos 下 ./data/ 目录）
4、端口被占用，需要查询占用端口的程序（关闭它）

相关文章：