RuoYi-Vue-Plus 在 Linux 中手动部署

今日分享：RuoYi-Vue-Plus 在 Linux 中手动部署

📌 需求提出

在实际生产环境中，为了保证系统高可用、稳定运行，需将本地开发完成的RuoYi-Vue-Plus项目手动部署至 Linux 服务器上，并确保各类服务（如 MySQL、Redis、Nginx 等）正确配合，完成一个完整的部署闭环。

🌍 应用场景

• 中小型项目使用单体部署方式上线
• 无需使用 Docker、K8S 等容器方案
• 后端采用SpringBoot打包成jar，部署于 Linux
• 配合前端构建好的静态资源，通过Nginx对外服务

💡 解决思路

部署流程大致分为：准备环境 → 编译打包 → 上传部署 → 配置反向代理 → 启动服务。同时结合宝塔面板或命令行方式运行 Java 项目，满足不同用户的运维习惯。

⚠️ 注意事项

• 请务必使用生产环境配置打包项目
• 创建后端运行所需的临时文件目录，避免上传文件时报错
• 若使用 HTTPS，务必配置有效的 SSL 证书路径
• 如使用 MinIO 存储，请提前部署并修改配置

🔧 完整代码

第一步：准备 Linux 环境 🧱

确保服务器已安装以下组件（最少需前四项）：

• ✅ OpenJDK 17（Java 运行环境）
• ✅ MySQL（数据库）
• ✅ Redis（缓存中间件）
• ✅ Nginx（反向代理服务器）
• 🟡 MinIO（可选，对象存储）

安装好后，验证各服务是否正常启动。

第二步：配置环境文件 📄

将项目目录中的以下配置文件拷贝到服务器中并进行调整：

# 复制 nginx 配置文件cp script/docker/nginx/nginx.conf /etc/nginx/nginx.conf# 复制 redis 配置文件cp script/docker/redis/redis.conf /etc/redis/redis.conf

修改其中如下关键配置：

• 前端静态页面路径（通常为root项）
• 后端服务地址（proxy_pass地址）
• 如启用 SSL，请填写.pem和.key文件真实路径

第三步：打包后端项目 📦

在本地或 IDEA 中使用 Maven 打包，确保切换为prod模式：

mvn clean package -Dmaven.test.skip=true -P prod

IDEA 打包方法：点击右侧 Maven 栏 → 生命周期 →clean、package，并在右上角选择prod配置项

第四步：上传文件与准备目录 📁

将打包好的jar文件上传至服务器指定目录，例如/www/wwwroot/ruoyi：

scp target/ruoyi-admin.jar user@server_ip:/www/wwwroot/ruoyi/

并在服务器上手动创建临时文件存储目录，路径需与配置中一致：

第五步：运行后端服务 🚀

提供两种启动方式：

✅方式一：命令行运行

nohup /usr/bin/java -jar-Xmx1024M-Xms1024M /www/wwwroot/ruoyi/ruoyi-admin.jar >/dev/null &

参数说明：

• /usr/bin/java
  ：JDK 路径（可通过which java查询）
• -Xmx
  /-Xms：JVM 内存设置
• /www/wwwroot/ruoyi/ruoyi-admin.jar
  ：部署路径

✅方式二：宝塔面板运行登录宝塔 → 网站 → Java项目 → 添加 Java 项目 → 选择Spring Boot勾选“前后端分离”，填写 jar 路径和运行参数：

第六步：配置 Nginx 前端与反向代理 🌐

以宝塔为例，Nginx 配置示例如下（已含 SSL 支持）：

server{    listen 80;    listen 443 ssl http2;    server_name ruoyi-tdesign.hexm.online;    root /www/wwwroot/ruoyi-tdesign;if($server_port!~ 443){        rewrite ^(/.*)$ https://$host$1 permanent;}    ssl_certificate    /www/server/panel/vhost/cert/ruoyi-tdesign/fullchain.pem;    ssl_certificate_key    /www/server/panel/vhost/cert/ruoyi-tdesign/privkey.pem;    location / {        root   /www/wwwroot/ruoyi-tdesign/html/admin;        try_files $uri$uri/ /index.html;        index  index.html index.htm;}    location /prod-api/ {        proxy_pass http://127.0.0.1:8080/;        proxy_set_header Host $host:$server_port;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";}    access_log  /www/wwwlogs/ruoyi-tdesign.log;    error_log   /www/wwwlogs/ruoyi-tdesign.error.log;}

若你有配置 SSL 证书，务必将路径替换为自己申请的证书位置

✅ 运行结果

访问 Nginx 配置中的域名地址（如https://ruoyi-tdesign.hexm.online），可正常访问 RuoYi 前端页面，后端接口通过/prod-api/代理，无跨域问题。

🎉 恭喜你完成 RuoYi-Vue-Plus 的手动部署！后续可接入自定义域名、SSL证书、日志监控等完善生产环境能力。