在 Linux 服务器上部署 RuoYi-Vue （336）

本章详细讲解如何在 Linux 环境下部署 RuoYi-Vue（若依前后端分离项目）。在开始之前，建议确保您已经成功在本地环境运行该项目，以便顺利完成接下来的部署步骤。

一、环境配置

在 Linux 服务器上成功部署项目前，必须预先准备好以下环境。本教程基于 Ubuntu 系统展开。

必备环境：

JDK ≥ 1.8
MySQL ≥ 5.7
Redis
Nginx

确保上述软件已安装并正确配置，避免后续部署中出现兼容性问题。

二、项目打包

1、后端项目打包

(1) 配置文件调整

在进行打包之前，您需要根据 Linux 环境调整项目中的配置文件，确保部署后的服务能正常运行。

第一处修改：application.yml 中的 ruoyi.profile 配置。
Windows 的路径规则与 Linux 不同，因此需要将文件存储路径调整为 Linux 兼容的路径。否则，在 Linux 上部署时会出现头像上传失败等问题。
第二处修改：application-druid.yml 中的数据库连接信息。
核实数据库地址、端口、用户名及密码的正确性，否则启动后端时可能会报连接失败。
第三处修改：application.yml 中 Redis 的缓存配置。
如果 Redis 配置了密码，确保 redis.password 字段正确填写；如果使用远程 Redis 实例，请将 redis.host 更新为远程服务器的 IP 地址。

(2) 打包后端项目

通过 IDE 打包：
如果使用 IntelliJ IDEA 等 IDE，可直接通过 Maven 插件中的 package 功能进行打包。
命令行打包：
您也可以通过命令行执行以下 Maven 命令进行打包：
```
mvn clean package -Dmaven.test.skip=true
```
打包完成后，生成的 ruoyi-admin.jar 文件将存放在 ruoyi-admin 模块的 target 目录下。

2、前端项目打包

进入前端目录（ruoyi-ui），通过以下命令打包前端项目：

# 正式环境打包
npm run build:prod

# 或者预发布环境打包
npm run build:stage

前端打包

打包成功后，会生成 dist 目录，该目录即为前端静态文件包。

打包后的dist目录

三、部署项目

1、上传项目文件

将打包后的 ruoyi-admin.jar 和 dist 文件夹上传到服务器指定位置。上传过程中，还需要将 SQL 数据库脚本上传到服务器。

2、创建数据库并导入 SQL 文件

在 MySQL 中创建与项目匹配的数据库，并导入 SQL 文件：

创建数据库：

CREATE DATABASE ruoyi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

导入 SQL 脚本：

USE ruoyi;
SOURCE /上传路径/ry_20230706.sql;
SOURCE /上传路径/quartz.sql;

3、启动 Redis 和 Nginx

启动 Redis 服务：

sudo service redis-server start
sudo service redis-server status

启动 Nginx 服务：
```
sudo systemctl start nginx
```

4、启动后端服务

通过以下命令在后台运行后端服务：

java -jar ruoyi-admin.jar &

5、配置 Nginx 进行前端代理

在 /etc/nginx 目录下修改 nginx.conf 文件，确保前端项目通过 Nginx 正常服务。

配置如下：

server {
    listen       80;
    server_name  localhost;
    charset utf-8;

    location / {
        root /usr/local/project/ruoyi/ruoyi-ui/dist;
        try_files  $uri$ uri/ /index.html;
        index  index.html;
    }

    location /prod-api/ {
        proxy_set_header Host  $http_host; proxy_set_header X-Real-IP$ remote_addr;
        proxy_pass http://localhost:8080/;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root html;
    }
}

保存配置并重启 Nginx 服务：

systemctl restart nginx

四、项目上线预览

项目部署完成后，您可以通过服务器的 IP 地址访问项目登录页面：

http://服务器IP地址/login

项目登录界面

如果一切顺利，登录界面将如期展示。

通过上述步骤，您已经成功在 Linux 服务器上完成 RuoYi_Vue 项目的部署。如果遇到任何问题，请仔细检查配置和步骤是否正确。

开发喵星球