当前位置：首页 > news >正文

保姆级教程：在CentOS 7上从零部署RuoYi-Vue前后端分离项目（含Nginx+Tomcat10配置）

news 2026/4/19 4:07:21

CentOS 7实战：RuoYi-Vue全栈部署指南与避坑手册

当你拿到一台全新的CentOS 7服务器，准备部署RuoYi-Vue这个流行的前后端分离框架时，是否曾被各种环境配置、服务联动和权限问题困扰？本文将带你从零开始，用最接地气的方式完成整个部署流程，特别针对CentOS 7特有的防火墙、SELinux等"坑点"给出解决方案。不同于网上泛泛而谈的教程，这里每个步骤都经过真实环境验证，甚至包含了当命令行报错时你应该首先检查的几处关键配置。

1. 基础环境准备：打造稳固的部署地基

在开始部署前，我们需要为RuoYi-Vue搭建一个稳定的运行环境。CentOS 7作为老牌稳定版本，其软件仓库中的默认组件版本可能无法满足现代Java项目的需求，这就需要我们手动配置最新版本的运行环境。

1.1 JDK安装与版本选择

RuoYi-Vue后端基于Spring Boot，需要JDK 1.8或以上版本。但在Tomcat 10环境下，我们需要特别注意JDK的兼容性问题：

# 安装OpenJDK 11（推荐用于Tomcat 10） sudo yum install -y java-11-openjdk-devel # 验证安装 java -version

注意：如果系统已安装其他JDK版本，使用alternatives --config java切换默认版本

常见问题排查：

如果java -version显示旧版本，检查JAVA_HOME环境变量
部署时出现UnsupportedClassVersionError，通常是因为编译环境和运行环境的JDK版本不一致

1.2 MySQL 8.0的安全配置

CentOS 7默认仓库提供的是MySQL 5.7，我们需要手动安装MySQL 8.0：

# 添加MySQL官方仓库 sudo rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm # 安装MySQL服务 sudo yum install -y mysql-community-server # 启动并设置开机自启 sudo systemctl enable --now mysqld

安装完成后，执行安全初始化：

# 获取临时密码 sudo grep 'temporary password' /var/log/mysqld.log # 安全配置向导 sudo mysql_secure_installation

为RuoYi-Vue创建专用数据库：

CREATE DATABASE `ry-vue` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'ruoyi'@'%' IDENTIFIED BY 'StrongPassword123!'; GRANT ALL PRIVILEGES ON `ry-vue`.* TO 'ruoyi'@'%'; FLUSH PRIVILEGES;

1.3 Redis的优化配置

Redis作为缓存服务，默认配置需要针对生产环境优化：

# 安装Redis sudo yum install -y redis # 编辑配置文件 sudo vi /etc/redis.conf

关键配置项修改：

bind 127.0.0.1→bind 0.0.0.0（如需远程访问）
protected-mode yes→protected-mode no
requirepass yourpassword设置访问密码

启动服务：

sudo systemctl enable --now redis

2. 中间件部署：Tomcat与Nginx的黄金组合

2.1 Tomcat 10的兼容性配置

下载并解压Tomcat 10：

wget https://downloads.apache.org/tomcat/tomcat-10/v10.1.7/bin/apache-tomcat-10.1.7.tar.gz tar -xzf apache-tomcat-10.1.7.tar.gz -C /opt sudo ln -s /opt/apache-tomcat-10.1.7 /opt/tomcat

创建专用系统用户并设置权限：

sudo useradd -r -s /bin/false tomcat sudo chown -R tomcat:tomcat /opt/apache-tomcat-10.1.7

配置服务文件/etc/systemd/system/tomcat.service：

[Unit] Description=Apache Tomcat After=network.target [Service] User=tomcat Group=tomcat Environment="CATALINA_OPTS=-Xms512M -Xmx1024M" Environment="JAVA_HOME=/usr/lib/jvm/jre" ExecStart=/opt/tomcat/bin/startup.sh ExecStop=/opt/tomcat/bin/shutdown.sh Restart=on-failure [Install] WantedBy=multi-user.target

启动服务：

sudo systemctl daemon-reload sudo systemctl enable --now tomcat

2.2 Nginx的高效配置

安装Nginx并配置为前端服务和反向代理：

# 添加EPEL仓库 sudo yum install -y epel-release # 安装Nginx sudo yum install -y nginx

配置/etc/nginx/nginx.conf关键部分：

server { listen 80; server_name your_domain.com; # 前端静态文件 location / { root /app/ruoyi-ui; try_files $uri $uri/ /index.html; index index.html index.htm; } # 后端API代理 location /prod-api/ { proxy_pass http://localhost:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_connect_timeout 60s; proxy_read_timeout 600s; } }

验证配置并启动：

sudo nginx -t sudo systemctl enable --now nginx

3. RuoYi-Vue项目部署实战

3.1 后端部署与调优

获取项目代码并编译：

git clone https://gitee.com/y_project/RuoYi-Vue.git cd RuoYi-Vue

关键配置文件修改：

ruoyi-admin/src/main/resources/application-druid.yml- 数据库连接
ruoyi-admin/src/main/resources/application.yml- Redis配置和文件存储路径
ruoyi-admin/src/main/resources/logback.xml- 日志路径

编译打包：

# 清理并打包 ./clean.sh ./package.sh

部署WAR包到Tomcat：

# 停止Tomcat服务 sudo systemctl stop tomcat # 清理旧部署 sudo rm -rf /opt/tomcat/webapps/ROOT* # 部署新包 sudo cp ruoyi-admin/target/ruoyi-admin.war /opt/tomcat/webapps/ROOT.war # 启动服务 sudo systemctl start tomcat

3.2 前端部署与性能优化

构建生产环境：

cd ruoyi-ui npm install --registry=https://registry.npm.taobao.org npm run build:prod

部署生成的文件：

sudo mkdir -p /app/ruoyi-ui sudo cp -r dist/* /app/ruoyi-ui/ sudo chown -R nginx:nginx /app/ruoyi-ui

4. 系统集成与安全加固

4.1 防火墙与SELinux配置

CentOS 7默认的firewalld和SELinux可能会阻止服务正常运行：

# 开放端口 sudo firewall-cmd --permanent --add-port=80/tcp sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --reload # SELinux设置 sudo setsebool -P httpd_can_network_connect 1 sudo chcon -Rt httpd_sys_content_t /app/ruoyi-ui

4.2 数据库初始化

导入RuoYi-Vue的SQL脚本：

mysql -u ruoyi -p ry-vue < sql/ry_20230223.sql mysql -u ruoyi -p ry-vue < sql/quartz.sql

4.3 服务健康检查

验证各服务状态：

# 检查服务运行状态 systemctl status mysqld systemctl status redis systemctl status nginx systemctl status tomcat # 检查端口监听 ss -tulnp | grep -E '80|8080|6379|3306'

日志查看命令：

MySQL错误日志：sudo tail -f /var/log/mysqld.log
Tomcat日志：sudo tail -f /opt/tomcat/logs/catalina.out
Nginx访问日志：sudo tail -f /var/log/nginx/access.log

5. 高级配置与故障排查

5.1 性能调优参数

Tomcat内存设置（/etc/systemd/system/tomcat.service）：

Environment="CATALINA_OPTS=-Xms1024M -Xmx2048M -XX:MaxMetaspaceSize=512M"

MySQL配置优化（/etc/my.cnf）：

[mysqld] innodb_buffer_pool_size = 1G innodb_log_file_size = 256M max_connections = 200 character-set-server = utf8mb4 collation-server = utf8mb4_general_ci

5.2 常见问题解决方案

问题1：前端访问正常，但API请求404

检查Nginx配置中的/prod-api/代理规则是否正确，特别是结尾的/不可遗漏

问题2：上传文件失败或权限不足

检查：

application.yml中的profile路径是否存在
目录权限：sudo chown -R tomcat:tomcat /path/to/upload
SELinux上下文：sudo chcon -Rt httpd_sys_rw_content_t /path/to/upload

问题3：Tomcat启动缓慢

安装rng-tools解决熵池不足问题：

sudo yum install -y rng-tools sudo systemctl enable --now rngd

5.3 备份与恢复策略

数据库自动备份脚本/usr/local/bin/mysql_backup.sh：

#!/bin/bash DATE=$(date +%Y%m%d%H%M) BACKUP_DIR="/backups/mysql" mkdir -p $BACKUP_DIR mysqldump -u ruoyi -p'yourpassword' ry-vue | gzip > "$BACKUP_DIR/ry-vue_$DATE.sql.gz" find $BACKUP_DIR -type f -mtime +7 -delete

设置定时任务：

sudo crontab -e # 添加以下内容 0 2 * * * /usr/local/bin/mysql_backup.sh

项目文件备份：

# 创建备份脚本 sudo vi /usr/local/bin/app_backup.sh # 内容如下 #!/bin/bash DATE=$(date +%Y%m%d%H%M) BACKUP_DIR="/backups/app" mkdir -p $BACKUP_DIR tar -czf "$BACKUP_DIR/ruoyi-ui_$DATE.tar.gz" /app/ruoyi-ui tar -czf "$BACKUP_DIR/tomcat_$DATE.tar.gz" /opt/tomcat/webapps/ROOT find $BACKUP_DIR -type f -mtime +7 -delete

查看全文

http://www.jsqmd.com/news/664025/