Tenormis's Blog

Appearance

若依微服务版项目搭建运行 ​

若依官网：https://ruoyi.vip/

1. 前言 ​

警告

为了确保若依微服务版项目能在单机环境顺利运行，建议该机器配备不低于 32GB 的内存。

2. 项目搭建 ​

2.1. 下载 ​

2.2. Docker 网络配置 ​

创建 Docker 网络：

Bash
docker network create ruoyi

信息

这里我们使用 Debian 12 作为 Linux 服务器，并已提前安装好 Docker 环境。

2.3. MySQL ​

RuoYi-Cloud 项目的 sql 文件夹中包含如下类似文件：

  • quartz.sql
  • ry_20250523.sql
  • ry_config_20250224.sql
  • ry_seata_20210128.sql

请先将前三个文件（即除了 ry_seata_20210128.sql 以外的文件）复制到 Linux 服务器上，并将它们移动到 /opt/dockers/ruoyi/mysql/initdb 文件夹下。

进入 /opt/dockers/ruoyi/mysql 目录，使用以下命令启动 MySQL Docker 容器：

Bash
docker run \
  -d \
  --name ruoyi-mysql \
  --hostname mysql-st \
  --network ruoyi \
  -e MYSQL_DATABASE=ruoyi-cloud \
  -e MYSQL_ROOT_PASSWORD=pJooAgy71aFKcuHaAVkU \
  -p 3306:3306 \
  -v ./conf.d:/etc/mysql/conf.d \
  -v ./datadir:/var/lib/mysql \
  -v ./initdb:/docker-entrypoint-initdb.d \
  mysql:8.4.4 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci

容器运行成功后，正常会有两个数据库 ruoyi-cloud 和 ry-config。ruoyi-cloud 包含 quartz.sql、ry_20250523.sql 中的表结构，ry_config_20250224.sql 中的表结构则是在 ry-config 库中。

2.4. Redis ​

为了便于测试，我们这里直接使用单机版的 Redis 即可：

在 /opt/dockers/ruoyi/redis/conf 目录下创建以下文件：

  • redis.conf

    INI
    bind 0.0.0.0
port 6379
requirepass ""
aclfile /usr/local/etc/redis/users.acl

  • users.acl

    Text
    user default off
user admin on >uDLQGEB0kdj6ukHiWCZ9 ~* +@all

回到 /opt/dockers/ruoyi/redis 目录下，使用以下命令启动 Redis Docker 容器：

Bash
docker run \
  -d \
  --name ruoyi-redis \
  --hostname redis-st \
  --network ruoyi \
  -p 6379:6379 \
  -v ./data:/data \
  -v ./conf:/usr/local/etc/redis \
  redis:7.4.2 sh -c "chown -R redis:redis /usr/local/etc/redis && redis-server /usr/local/etc/redis/redis.conf"

2.5. Nacos ​

先前的 MySQL 实例已经包含了 Nacos 所需的表结构（ry_config_20250224.sql），因此只需将 Nacos 配置为指向 MySQL 实例的 ry-config 数据库即可。与此同时，NACOS_AUTH_* 相关的环境变量也不在起作用，默认的用户名和密码均为 nacos（可稍后登录控制台中修改密码）。

进入 /opt/dockers/ruoyi/nacos 目录，使用以下命令启动 Nacos Docker 容器：

Bash
docker run \
  -d \
  --name ruoyi-nacos \
  --hostname nacos-st \
  --network ruoyi \
  -e MODE=standalone \
  -e SPRING_DATASOURCE_PLATFORM=mysql \
  -e MYSQL_SERVICE_HOST=mysql-st \
  -e MYSQL_SERVICE_PORT=3306 \
  -e MYSQL_SERVICE_USER=root \
  -e MYSQL_SERVICE_PASSWORD=pJooAgy71aFKcuHaAVkU \
  -e MYSQL_SERVICE_DB_NAME=ry-config \
  -e MYSQL_SERVICE_DB_PARAM="characterEncoding=utf8&connectTimeout=5000&socketTimeout=30000&autoReconnect=true&useSSL=false&allowPublicKeyRetrieval=true" \
  -e JVM_XMS=256m \
  -e JVM_XMX=512m \
  -p 8848:8848 \
  -p 9848:9848 \
  -v ./logs/:/home/nacos/logs \
  nacos/nacos-server:v2.5.0

3. 项目启动 ​

3.1. ruoyi-gateway ​

  1. 编辑 ruoyi-gateway 项目的 bootstrap.yml 文件；

    修改 Nacos（注册中心 & 配置中心）的地址，以及 Sentinel 配置源的地址：

    diff
    @@ -14,10 +14,10 @@
     nacos:
       discovery:
         # 服务注册地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
       config:
         # 配置中心地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
         # 配置文件格式
         file-extension: yml
         # 共享配置
@@ -33,7 +33,7 @@
       datasource:
         ds1:
           nacos:
-            server-addr: 127.0.0.1:8848
+            server-addr: 10.10.0.198:8848
             dataId: sentinel-ruoyi-gateway
             groupId: DEFAULT_GROUP
             data-type: json

  2. 编辑 Nacos 配置中心的 ruoyi-gateway-dev.yml 配置；

    修改 Redis 主机名及用户密码：

    diff
    @@ -1,8 +1,9 @@
 spring:
   redis:
-    host: localhost
+    host: 10.10.0.198
     port: 6379
-    password:
+    username: admin
+    password: uDLQGEB0kdj6ukHiWCZ9
   cloud:
     gateway:
       discovery:

  3. 启动 ruoyi-gateway 项目。

3.2. ruoyi-auth ​

  1. 编辑 ruoyi-auth 项目的 bootstrap.yml 文件；

    修改 Nacos（注册中心 & 配置中心）的地址：

    diff
    @@ -14,10 +14,10 @@
     nacos:
       discovery:
         # 服务注册地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
       config:
         # 配置中心地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
         # 配置文件格式
         file-extension: yml
         # 共享配置

  2. 编辑 Nacos 配置中心的 ruoyi-auth-dev.yml 配置；

    修改 Redis 主机名及用户密码：

    diff
    @@ -1,5 +1,6 @@
 spring:
   redis:
-    host: localhost
+    host: 10.10.0.198
     port: 6379
-    password:
+    username: admin
+    password: uDLQGEB0kdj6ukHiWCZ9

  3. 启动 ruoyi-auth 项目。

3.3. ruoyi-system ​

  1. 编辑 ruoyi-system 项目的 bootstrap.yml 文件；

    修改 Nacos（注册中心 & 配置中心）的地址：

    diff
    @@ -14,10 +14,10 @@
     nacos:
       discovery:
         # 服务注册地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
       config:
         # 配置中心地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
         # 配置文件格式
         file-extension: yml
         # 共享配置

  2. 编辑 Nacos 配置中心的 ruoyi-system-dev.yml 配置；

    修改 Redis、MySQL 的主机名和用户密码：

    diff
    @@ -1,9 +1,10 @@
 # spring配置
 spring:
   redis:
-    host: localhost
+    host: 10.10.0.198
     port: 6379
-    password:
+    username: admin
+    password: uDLQGEB0kdj6ukHiWCZ9
   datasource:
     druid:
       stat-view-servlet:
@@ -32,9 +33,9 @@
           # 主库数据源
           master:
             driver-class-name: com.mysql.cj.jdbc.Driver
-            url: jdbc:mysql://localhost:3306/ry-cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
+            url: jdbc:mysql://10.10.0.198:3306/ruoyi-cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
             username: root
-            password: password
+            password: pJooAgy71aFKcuHaAVkU
           # 从库数据源
           # slave:
             # username:

  3. 启动 ruoyi-system 项目，项目启动后默认会向 Redis 中填充系统数据字典相关的数据。

实际上到这里，现在就已经可以启动前端项目了。步骤相对较简单，按照前端项目 README.md 中的说明依次操作即可：

3.4. 前端 RuoYi-Cloud-Vue3 ​

  1. 进入项目目录：

    Bash
    cd RuoYi-Cloud-Vue3

  2. 安装依赖：

    Bash
    yarn --registry=https://registry.npmmirror.com

  3. 启动服务：

    Bash
    yarn dev

系统启动完成后，默认将呈现 RuoYi 的登录界面：

图 3.1 - 登录页面

3.5. ruoyi-monitor ​

  1. 编辑 ruoyi-monitor 项目的 bootstrap.yml 文件；

    修改 Nacos（注册中心 & 配置中心）的地址：

    diff
    @@ -14,12 +14,13 @@
     nacos:
       discovery:
         # 服务注册地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
       config:
         # 配置中心地址
-        server-addr: 127.0.0.1:8848
+        server-addr: 10.10.0.198:8848
         # 配置文件格式
         file-extension: yml
         # 共享配置

  2. 启动 ruoyi-monitor 项目，默认端口 9100：

    图 3.2 - Monitor 登录页面

转载请注明作者和出处

Copyright © 2025-至今 Tenormis