若依前后端分离系统生产环境部署：从零到上线的保姆级教程

若依前后端分离系统生产环境部署实战指南引言为什么选择若依框架对于刚接触企业级开发的新手来说若依(RuoYi)框架无疑是一个绝佳的起点。这个基于Spring Boot和Vue.js的前后端分离架构不仅提供了完善的权限管理、代码生成等基础功能模块更以其清晰的文档和活跃的社区支持著称。但很多开发者在本地开发测试后往往在生产环境部署环节遇到各种水土不服的问题——从环境配置冲突到Nginx转发规则设置每一步都可能成为拦路虎。本文将带你从零开始用最接地气的方式完成若依系统在生产环境(Linux服务器)的完整部署。不同于简单的步骤罗列我会重点讲解每个环节的技术原理和避坑要点比如为什么MySQL 8.0必须设置时区参数如何正确处理前后端跨域问题Nginx配置中那些容易被忽略的性能调优参数生产环境日志管理的正确姿势无论你是刚接触Linux的开发者还是需要快速搭建内部管理系统的技术负责人这篇指南都能提供可直接复用的解决方案。让我们跳过那些华而不实的理论直接进入实战环节。1. 生产环境基础搭建1.1 服务器环境准备在开始部署前我们需要确保服务器具备以下基础环境以CentOS 7为例# 更新系统包 sudo yum update -y # 安装常用工具 sudo yum install -y wget curl vim git unzip关键组件版本要求组件最低版本推荐版本安装方式建议JDK1.811yum安装OpenJDKMySQL5.78.0官方二进制包安装Redis4.06.2yum安装Nginx1.181.22官方仓库安装Node.js12.x16.xnvm管理多版本提示生产环境强烈建议使用LTS(Long-Term Support)版本的软件避免使用最新非稳定版本1.2 数据库配置优化MySQL安装后需要进行针对性优化-- 创建专用数据库用户 CREATE USER ruoyi% IDENTIFIED BY StrongPassword123!; GRANT ALL PRIVILEGES ON ry-vue.* TO ruoyi%; FLUSH PRIVILEGES; -- 重要配置项修改my.cnf [mysqld] default-time-zone 8:00 # 必须设置时区 character-set-server utf8mb4 collation-server utf8mb4_general_ci常见问题排查连接数不足max_connections500内存溢出合理设置innodb_buffer_pool_size时区错误确保JDBC URL包含serverTimezoneAsia/Shanghai2. 若依系统配置调整2.1 后端工程关键配置修改ruoyi-admin模块中的配置文件application-druid.yml- 数据库连接池配置spring: datasource: druid: url: jdbc:mysql://db-server:3306/ry-vue?useSSLfalsecharacterEncodingutf8 username: ruoyi password: StrongPassword123! initialSize: 5 # 初始连接数 maxActive: 20 # 最大连接数 minIdle: 5 # 最小空闲连接application.yml- 服务端配置server: port: 19393 servlet: context-path: / tomcat: max-threads: 200 # 线程池大小 max-connections: 1000 # 最大连接数 # 生产环境日志级别调整为INFO logging: level: root: info com.ruoyi: debug2.2 前端工程适配修改在ruoyi-ui中调整Vue配置vue.config.js- 代理和打包设置module.exports { devServer: { port: 80, proxy: { /prod-api: { target: http://backend-server:19393, changeOrigin: true, pathRewrite: { ^/prod-api: } } } }, publicPath: ./, // 关键生产环境静态资源路径 outputDir: dist, assetsDir: static, productionSourceMap: false // 关闭sourcemap提升安全性 }环境变量配置.env.productionVUE_APP_BASE_API /prod-api VUE_APP_ENV production3. 构建与部署流程3.1 后端打包与优化使用Maven进行生产环境打包# 跳过测试并启用生产配置 mvn clean package -DskipTests -Pprod # 生成的jar包路径 ls ruoyi-admin/target/ruoyi-admin.jar启动脚本示例startup.sh#!/bin/bash # 设置JVM参数 JAVA_OPTS-server -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize512m # 启动应用 nohup java ${JAVA_OPTS} -jar ruoyi-admin.jar app.log 21 # 监控日志 tail -f app.log | grep --color -E ERROR|WARN|INFO3.2 前端资源构建使用npm构建生产环境包# 安装依赖 npm install --registryhttps://registry.npmmirror.com # 构建生产包 npm run build:prod # 构建结果位于dist目录 ls dist构建优化技巧使用--modern模式构建现代浏览器包添加BROWSERLIST环境变量控制兼容范围配置CDN加速静态资源加载4. Nginx高级配置4.1 完整配置示例worker_processes auto; # 自动匹配CPU核心数 events { worker_connections 1024; use epoll; multi_accept on; } http { include mime.types; default_type application/octet-stream; sendfile on; tcp_nopush on; keepalive_timeout 65; gzip on; gzip_min_length 1k; gzip_types text/plain application/javascript application/x-javascript text/css; server { listen 80; server_name your-domain.com; root /var/www/ruoyi/dist; # 前端路由处理 location / { try_files $uri $uri/ /index.html; add_header Cache-Control no-cache; } # 后端API代理 location /prod-api/ { proxy_pass http://127.0.0.1:19393/; 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; } # 静态资源缓存 location ~* \.(js|css|png|jpg|jpeg|gif|ico|woff2)$ { expires 365d; access_log off; } } }4.2 性能调优关键点连接池优化worker_processes: CPU核心数worker_connections: 每个worker最大连接数缓存策略静态资源设置长期缓存HTML文件禁用缓存安全加固隐藏Nginx版本信息限制HTTP方法配置CSP策略5. 系统监控与维护5.1 服务健康检查使用Spring Boot Actuator进行健康监控# application.yml添加 management: endpoints: web: exposure: include: health,info,metrics endpoint: health: show-details: always通过Nginx暴露监控端点location /actuator/ { proxy_pass http://127.0.0.1:19393/actuator/; auth_basic Restricted; auth_basic_user_file /etc/nginx/.htpasswd; }5.2 日志管理方案日志收集架构Filebeat收集日志Logstash进行过滤处理Elasticsearch存储索引Kibana可视化展示关键日志路径应用日志nohup.out或app.logNginx访问日志/var/log/nginx/access.logNginx错误日志/var/log/nginx/error.log5.3 自动化部署进阶使用Shell脚本实现一键部署#!/bin/bash # 停止现有服务 PID$(ps -ef | grep ruoyi-admin.jar | grep -v grep | awk {print $2}) if [ -n $PID ]; then kill -9 $PID fi # 备份旧版本 TIMESTAMP$(date %Y%m%d%H%M%S) mv /opt/ruoyi/ruoyi-admin.jar /opt/ruoyi/backup/ruoyi-admin-$TIMESTAMP.jar # 部署新版本 cp target/ruoyi-admin.jar /opt/ruoyi/ nohup java -jar /opt/ruoyi/ruoyi-admin.jar /opt/ruoyi/logs/app.log 21 对于更复杂的场景可以考虑使用Jenkins实现CI/CD流水线通过Docker容器化部署采用Kubernetes进行集群管理