前言

下载项目

使用若依微服务 Spring Cloud分布式版本

若依官网

 若依
微服务版本
（RuoYi-Cloud）若依
前后端分离版本
（Java + Vue）若依
前后端不分离版本
（Java）若依
APP版本
（Java + uniapp）

启用MYSQL数据库

下载的若依项目中，有一个sql文件夹，包含分别创建四个数据库的SQL：
ry_2023xxxx.sql【项目基础库】、ry_config_2023xxxx.sql【nacos配置库】、ry_seata_2021xxxx.sql【分布式库】、quartz.sql【定时任务库】
ps：其中【项目基础库】和【nacos配置库】是必须引入的，剩下的两个可以根据个人需求进行创建。

创建ry-cloud数据库（项目基础库）
创建ry-config数据库（Nacos配置库）
创建ry-seata数据库（分布式库）
创建quartz数据库（定时调度任务库）

启用Redis

Redis的部署及使用操作可以参考【Redis在Linux下载安装及部署】

启用Nacos

安装并使用Nacos注册中心
ps：启动前，记得先修改Nacos配置文件，将Nacos支持的数据源配置改成若依提供的数据库ry-config
配置完成并启动后，会自动引入若依项目的yml配置
打开Nacos可视化界面，修改配置内容，将下图中各个yml文件中的提到的 mysql、redis 等组件插件都改成自己的数据源

启动后端项目

打开IDEA直接 File - open... 引入后端项目【ruoyi】

修改项目中的bootstrap.yml配置，项目中有多个bootstrap.yml，
可以【Ctrl+Shift+R】全局检索一下：127.0.0.1:8848。
这里默认的是本地Nacos，可以替换成自己服务器的Nacos地址。
如果Nacos需要账号密码，可以在bootstrap.yml文件中的spring.cloud.nacos.discovery下面加username、password、namespace等（与server-addr同级），如下面代码所示

spring:
  cloud:
    nacos:
      discovery:
        # 服务注册地址
        server-addr: 192.168.1.123:8848
        username: nacos
        password: xxxxx
        namespace: public
      config:
        # 配置中心地址
        server-addr: 192.168.1.123:8848
        # 配置文件格式
        file-extension: yml

由于分布式项目，需要启动多个XxxxApplication

启动没有先后顺序，除了必须启动的，其它可根据实际情况启动

模块启动类	模块名	启动必要性
RuoYiGatewayApplication	网关模块	必须
RuoYiSystemApplication	系统模块	必须
RuoYiAuthApplication	认证模块	必须
RuoYiMonitorApplication	监控模块	可选
RuoYiGenApplication	代码生成模块	可选
RuoYiJobApplication	定时任务模块	可选
RuoYiFileApplication	文件服务模块	可选

Nacos默认是8848端口，防火墙需要放开8848。
值得注意的是，Nacos 2.0版本相对于Nacos 1.0版本，新增了gRPC的通讯方式，所以新增了几个端口，这几个端口需要额外放开。
新增的端口是在配置的主端口(server.port)基础上，进行了偏移量自动生成。
由下表可见，端口的生成方式，是由主端口8848+1000、主端口8848+1001生成。

端口	与主端口的偏移量	描述
9848	1000	客户端gRPC请求服务端端口，用于客户端向服务端发起连接和请求
9849	1001	服务端gRPC清求服务端端口，用于服务间同步等

启动前端项目

打开 Visual Studio Code，直接 File - open Folder...引入若依前端项目【ruoyi-ui】

下载依赖

具体命令可以参考 ruoyi-ui 前端项目中的 README.md

# 进入项目目录
cd ruoyi-ui
# 安装依赖
npm install
# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com
# 启动服务
npm run dev