Linux下Ruoyi前后端不分离版部署全攻略：从JDK配置到Docker实战

原创

于 2026-03-01 05:46:43 发布 · 575 阅读

Linux下Ruoyi前后端不分离版部署全攻略：从JDK配置到Docker实战

在当今快速迭代的软件开发领域，一套成熟的后台管理系统能够极大提升开发效率，让团队更专注于核心业务逻辑的实现。RuoYi作为国内广受欢迎的Java EE企业级快速开发平台，以其经典的技术栈组合（Spring Boot、Apache Shiro、MyBatis、Thymeleaf）和丰富的功能模块，成为了众多中大型项目的首选脚手架。对于需要在Linux生产环境中部署RuoYi前后端不分离版本的开发者而言，从零开始搭建一套稳定、高效的运行环境，既是必备技能，也常伴随着各种“坑点”。

本文旨在为中级开发者提供一份详尽、可落地的实战指南，不仅涵盖从JDK、Maven、Git等基础环境搭建到项目最终上线的全流程，更会深入探讨在阿里云等主流云服务器上部署时遇到的高频问题及其解决方案。我们将摒弃简单的命令罗列，转而从架构理解、配置原理和运维实践的角度，带你走完一次完整的部署之旅。无论你是首次接触RuoYi部署，还是希望优化现有部署流程，这篇文章都将提供有价值的参考。

1. 环境准备与规划：构建稳固的基石

部署任何Java Web项目前，一个清晰、隔离且易于维护的服务器目录结构是成功的第一步。这不仅能避免后续的混乱，也为自动化运维和问题排查打下基础。我个人的习惯是在/data目录下建立清晰的子目录，将不同类型的文件归类存放。

# 创建核心目录结构
sudo mkdir -p /data/{service,app,logs,backup,scripts}
# service: 存放所有软件环境，如JDK、Maven等
# app: 存放应用程序，如Ruoyi的jar包
# logs: 统一存放应用日志
# backup: 用于备份数据库、配置文件等
# scripts: 存放部署、维护用的Shell脚本

对于RuoYi前后端不分离版本，其核心依赖环境相对明确：

组件	最低版本要求	推荐版本	主要作用
JDK	1.8	OpenJDK 11 / Oracle JDK 1.8	Java程序运行环境
Maven	3.0	3.6.3+	项目构建与依赖管理
Git	2.x	2.18.0+	代码版本控制与拉取
MySQL	5.7	5.7 / 8.0	关系型数据库
Docker	18.09+	20.10+	容器化运行MySQL（可选但推荐）

提示：虽然RuoYi官方文档注明支持JDK 1.8，但在生产环境中，我强烈建议考虑使用OpenJDK 11或更高版本，以获得更好的性能、安全性和长期支持。不过，为了与大多数教程保持一致，本文仍以JDK 1.8为例进行演示。

在开始安装前，请确保你的Linux服务器（以CentOS 7/8或Ubuntu 20.04为例）已更新到最新状态，并具备基本的网络连接能力。一个常见的“坑”是服务器默认的软件源速度较慢，我们可以先替换为国内镜像源以加速后续的软件安装过程。

2. 核心环境安装与深度配置

2.1 JDK安装：不止于`JAVA_HOME`

许多教程会直接让你下载Oracle JDK的tar包并配置环境变量，但这存在几个问题：手动管理版本升级麻烦，且Oracle JDK的许可证可能带来商业风险。对于生产环境，我更倾向于使用系统包管理器安装OpenJDK，或者使用像jenv这样的多版本管理工具。

方案一：使用YUM/DNF安装OpenJDK（推荐用于生产环境）

# CentOS/RHEL
sudo yum install -y java-1.8.0-openjdk-devel

# 验证安装
java -version
# 输出应类似：openjdk version "1.8.0_402"

方案二：手动安装特定版本JDK（适用于需要精确控制版本的情况） 如果你确实需要某个特定的JDK版本（比如Oracle JDK 8u261），可以按以下步骤操作。首先，从官方或可信镜像站下载对应版本的tar.gz包，然后将其解压到我们规划好的/data/service目录。

# 假设已将jdk-8u261-linux-x64.tar.gz上传至服务器/tmp目录
cd /tmp
sudo tar -zxvf jdk-8u261-linux-x64.tar.gz -C /data/service/

接下来是配置环境变量的关键步骤。很多新手会直接修改/etc/profile，但这会影响所有用户。更优雅的做法是为你的应用创建一个专属的环境变量文件。

# 创建应用专用的环境变量文件
sudo tee /etc/profile.d/ruoyi_env.sh << 'EOF'
export JAVA_HOME=/data/service/jdk1.8.0_261
export PATH=$JAVA_HOME/bin:$PATH
# 设置JVM默认参数，根据服务器内存调整
export JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
EOF

# 使配置生效
source /etc/profile.d/ruoyi_env.sh

注意：JAVA_OPTS中的内存参数需要根据你的服务器实际配置进行调整。对于2GB内存的服务器，-Xmx1024m是一个安全的起点；对于4GB或以上，可以考虑设置为-Xmx2048m。G1垃圾收集器在JDK 8u40及以上版本中表现稳定，适合大多数Web应用。

2.2 Maven配置：加速依赖下载的艺术

Maven的安装过程与JDK类似，但配置其镜像仓库是提升构建速度的关键。默认的中央仓库在国内访问速度堪忧，我们必须将其替换为阿里云镜像。

# 下载并解压Maven
cd /tmp
wget https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
sudo tar -zxvf apache-maven-3.6.3-bin.tar.gz -C /data/service/

# 配置环境变量
sudo tee -a /etc/profile.d/ruoyi_env.sh << 'EOF'
export MAVEN_HOME=/data/service/apache-maven-3.6.3
export PATH=$MAVEN_HOME/bin:$PATH
EOF
source /etc/profile.d/ruoyi_env.sh

Maven的核心配置文件是settings.xml。除了配置镜像，我们还应优化本地仓库位置和并发下载线程数。

<!-- /data/service/apache-maven-3.6.3/conf/settings.xml 部分关键配置 -->
<settings>
  <!-- 指定本地仓库路径，避免默认的~/.m2/repository -->
  <localRepository>/data/service/maven_repo</localRepository>
  
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <!-- 可额外添加中央仓库镜像作为备用 -->
    <mirror>
      <id>central</id>
      <mirrorOf>central</mirrorOf>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
    </mirror>
  </mirrors>
  
  <profiles>
    <profile>
      <id>default</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <!-- 设置Maven编译时的编码 -->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <!-- 增加编译线程数，加速构建 -->
        <maven.compiler.fork>true</maven.compiler.fork>
        <maven.compiler.threa

标签