容器化部署若依Vue全家桶Docker Compose实战指南在传统服务器部署中开发者往往需要花费大量时间在环境配置、依赖安装和服务调优上。每次部署新环境都要重复执行相同的步骤安装JDK、配置MySQL、编译Redis、调整Nginx参数...这不仅效率低下还容易因环境差异导致在我机器上能跑的经典问题。而容器化技术正是解决这一痛点的银弹——通过Docker Compose我们可以将若依Vue项目及其全部依赖Java/MySQL/Redis/Nginx打包成可移植的标准化单元实现一键部署、版本可控、环境一致的现代化运维体验。1. 容器化部署的优势与架构设计1.1 传统部署 vs 容器化部署对比让我们通过一个典型场景来理解两种部署方式的本质区别。假设团队中有三位开发者开发者A使用CentOS 7.9手动部署耗时4小时完成全部环境搭建开发者B在Ubuntu 20.04上部署因系统差异遇到3个兼容性问题开发者C使用Docker Compose15分钟完成全栈服务启动这种效率差异主要源于两种部署模式的根本不同对比维度传统部署Docker Compose部署环境一致性依赖系统环境易出现差异完全隔离环境原子化部署时间小时级分钟级依赖管理需手动解决依赖冲突镜像自带完整依赖链迁移成本需重新配置文件拷贝即可资源占用直接使用系统资源有约10%的容器化开销调试复杂度直接访问系统进程需进入容器环境1.2 若依Vue的容器化架构若依Vue全家桶的容器化部署需要协调多个服务用户请求 → Nginx容器 → Vue静态资源 ↓ Nginx反向代理 → RuoYi-Java容器(8080) ↓ MySQL容器(3306) ↓ Redis容器(6379)这种架构下每个服务运行在独立的容器中通过Docker网络互联。关键设计要点包括网络隔离所有容器共享自定义网络避免端口冲突数据持久化MySQL数据、Redis持久化文件、Nginx配置等需要volume挂载启动顺序定义depends_on确保数据库先于应用启动资源限制为各容器配置合理的CPU/Memory限制提示生产环境建议将MySQL和Redis这类有状态服务部署在容器编排平台如Kubernetes或独立服务器本文方案更适合开发和测试环境。2. 环境准备与Docker配置2.1 基础环境要求开始前请确保宿主机满足任何Linux发行版推荐CentOS 7/Ubuntu 18.04Docker Engine ≥ 20.10.14Docker Compose ≥ 2.5.1至少4GB内存建议8GB20GB可用磁盘空间验证环境# 检查Docker版本 docker --version # 检查Compose版本 docker compose version # 查看系统资源 free -h df -h若未安装Docker可通过官方脚本快速安装# 通用安装命令需root权限 curl -fsSL https://get.docker.com | sh # 启动Docker并设置开机自启 systemctl enable --now docker # 安装Compose插件 DOCKER_CONFIG${DOCKER_CONFIG:-$HOME/.docker} mkdir -p $DOCKER_CONFIG/cli-plugins curl -SL https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose chmod x $DOCKER_CONFIG/cli-plugins/docker-compose2.2 项目结构规划建议按以下结构组织部署文件/opt/ruoyi-vue ├── compose │ ├── mysql │ │ ├── conf.d # MySQL自定义配置 │ │ └── initdb.d # 初始化SQL脚本 │ ├── nginx │ │ ├── conf.d # Nginx站点配置 │ │ └── ssl # SSL证书 │ └── redis │ └── redis.conf # Redis配置文件 ├── data │ ├── mysql # MySQL数据目录 │ └── redis # Redis数据目录 ├── frontend │ └── dist # Vue编译产物 └── backend └── ruoyi-admin.jar # Java后端包创建基础目录mkdir -p /opt/ruoyi-vue/{compose/{mysql/{conf.d,initdb.d},nginx/{conf.d,ssl},redis},data/{mysql,redis},frontend,backend}3. Docker Compose文件详解3.1 编写docker-compose.yml创建主编排文件/opt/ruoyi-vue/docker-compose.ymlversion: 3.8 services: mysql: image: mysql:5.7 container_name: ruoyi-mysql environment: MYSQL_ROOT_PASSWORD: RuoYi123 MYSQL_DATABASE: ry-vue TZ: Asia/Shanghai volumes: - ./data/mysql:/var/lib/mysql - ./compose/mysql/conf.d:/etc/mysql/conf.d - ./compose/mysql/initdb.d:/docker-entrypoint-initdb.d ports: - 3306:3306 networks: - ruoyi-net healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 3s retries: 5 redis: image: redis:6.2-alpine container_name: ruoyi-redis command: redis-server --appendonly yes volumes: - ./data/redis:/data - ./compose/redis/redis.conf:/usr/local/etc/redis/redis.conf ports: - 6379:6379 networks: - ruoyi-net healthcheck: test: [CMD, redis-cli, ping] interval: 5s timeout: 3s retries: 5 backend: image: openjdk:8-jdk container_name: ruoyi-backend depends_on: mysql: condition: service_healthy redis: condition: service_healthy volumes: - ./backend:/app working_dir: /app command: java -jar -Dspring.profiles.activeprod ruoyi-admin.jar ports: - 8080:8080 networks: - ruoyi-net restart: unless-stopped nginx: image: nginx:1.21-alpine container_name: ruoyi-nginx depends_on: backend: condition: service_started volumes: - ./frontend/dist:/usr/share/nginx/html - ./compose/nginx/conf.d:/etc/nginx/conf.d ports: - 80:80 - 443:443 networks: - ruoyi-net networks: ruoyi-net: driver: bridge3.2 关键配置解析MySQL服务配置使用官方MySQL 5.7镜像通过volume挂载数据目录和配置文件初始化脚本放在initdb.d目录如quartz.sql和ry_20230223.sql设置健康检查确保完全启动后再连接Redis服务优化选择Alpine版镜像减小体积启用AOF持久化模式自定义配置文件支持更多优化参数Java后端服务基于openjdk:8-jdk镜像通过depends_on确保依赖服务就绪设置restart策略实现故障自动恢复绑定后台JAR包到容器内Nginx前端服务挂载Vue编译后的dist目录自定义配置支持前后端分离架构暴露80/443端口支持HTTP/HTTPS4. 服务配置与优化实践4.1 MySQL性能调优在compose/mysql/conf.d/my-custom.cnf中添加[mysqld] max_connections500 innodb_buffer_pool_size256M innodb_log_file_size128M skip-name-resolve character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci初始化脚本示例compose/mysql/initdb.d/init.sqlCREATE USER ruoyi% IDENTIFIED BY RuoYi123; GRANT ALL PRIVILEGES ON ry-vue.* TO ruoyi%; FLUSH PRIVILEGES;4.2 Redis安全配置compose/redis/redis.conf关键参数bind 0.0.0.0 protected-mode yes requirepass RuoYiRedis123 maxmemory 256mb maxmemory-policy allkeys-lru appendonly yes4.3 Nginx前端配置创建compose/nginx/conf.d/ruoyi.confserver { listen 80; server_name localhost; location / { root /usr/share/nginx/html; try_files $uri $uri/ /index.html; index index.html index.htm; } location /prod-api/ { proxy_pass http://backend:8080/; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_connect_timeout 30s; proxy_read_timeout 600s; proxy_send_timeout 600s; } error_page 500 502 503 504 /50x.html; location /50x.html { root html; } }4.4 Java应用参数调优修改backend服务的command部分command: java -jar -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m -Dspring.profiles.activeprod -Dserver.tomcat.uri-encodingUTF-8 ruoyi-admin.jar5. 部署流程与日常运维5.1 一键启动全栈服务cd /opt/ruoyi-vue # 构建并启动所有服务-d表示后台运行 docker compose up -d # 查看服务状态 docker compose ps # 查看实时日志 docker compose logs -f5.2 常用运维命令服务管理# 停止所有服务保留数据 docker compose stop # 停止并删除容器保留数据 docker compose down # 完全清理包括匿名volume docker compose down -v # 重启单个服务 docker compose restart backend数据备份# MySQL备份 docker exec ruoyi-mysql sh -c exec mysqldump -uroot -p$MYSQL_ROOT_PASSWORD ry-vue backup.sql # Redis备份 docker exec ruoyi-redis redis-cli -a RuoYiRedis123 save cp ./data/redis/dump.rdb ./redis-backup-$(date %F).rdb日志检查# 查看Java应用日志 docker compose logs backend # 查看最近100行Nginx访问日志 docker exec ruoyi-nginx tail -100 /var/log/nginx/access.log # 实时查看MySQL慢查询 docker exec -it ruoyi-mysql mysqladmin -uroot -pRuoYi123 --sleep2 processlist5.3 版本更新策略前端更新重新构建Vue项目生成dist目录清空frontend/dist并复制新文件重启Nginx服务docker compose restart nginx后端更新替换backend/ruoyi-admin.jar文件重建backend容器docker compose up -d --force-recreate backend数据库迁移备份当前数据库执行变更SQL脚本验证数据一致性docker exec -i ruoyi-mysql mysql -uroot -pRuoYi123 ry-vue alter.sql6. 常见问题排查指南6.1 容器启动失败排查检查步骤查看容器日志docker compose logs service_name检查端口冲突netstat -tulnp | grep -E 80|3306|6379|8080验证volume权限ls -l data/mysql典型问题解决MySQL无法启动通常由于volume权限问题尝试chown -R 999:999 data/mysqlRedis连接拒绝检查requirepass是否与Java配置一致Nginx 502错误确认backend服务是否健康运行6.2 性能优化建议MySQL优化# 进入MySQL容器 docker exec -it ruoyi-mysql mysql -uroot -pRuoYi123 # 查看运行状态 SHOW STATUS LIKE Threads_connected; SHOW VARIABLES LIKE max_connections;JVM内存分析# 获取Java进程PID docker top ruoyi-backend # 进入容器分析 docker exec -it ruoyi-backend bash jstat -gcutil pid 1000 5Nginx缓存配置location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ { expires 30d; add_header Cache-Control public, no-transform; }6.3 监控方案集成基础监控命令# 查看容器资源使用 docker stats # 查看服务健康状态 docker compose ps --filter statusrunningPrometheus监控配置示例# 在docker-compose.yml中添加 monitor: image: prom/prometheus ports: - 9090:9090 volumes: - ./monitor/prometheus.yml:/etc/prometheus/prometheus.yml networks: - ruoyi-net配套的prometheus.yml配置scrape_configs: - job_name: ruoyi-backend metrics_path: /actuator/prometheus static_configs: - targets: [backend:8080] - job_name: mysql static_configs: - targets: [mysql:9104]7. 进阶CI/CD集成与生产建议7.1 自动化构建流程结合GitHub Actions实现自动化部署# .github/workflows/deploy.yml name: Deploy RuoYi-Vue on: push: branches: [ master ] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - name: Build Frontend run: | cd ruoyi-ui npm install npm run build:prod tar czf ../frontend.tgz dist/ - name: Build Backend run: | cd ruoyi mvn clean package -DskipTests cp target/ruoyi-admin.jar ../backend/ - name: Deploy to Server uses: appleboy/scp-actionmaster with: host: ${{ secrets.SERVER_HOST }} username: ${{ secrets.SERVER_USER }} key: ${{ secrets.SSH_PRIVATE_KEY }} source: frontend.tgz,backend/ruoyi-admin.jar target: /opt/ruoyi-vue - name: Restart Services uses: appleboy/ssh-actionmaster with: host: ${{ secrets.SERVER_HOST }} username: ${{ secrets.SERVER_USER }} key: ${{ secrets.SSH_PRIVATE_KEY }} script: | cd /opt/ruoyi-vue tar xzf frontend.tgz -C frontend/ docker compose up -d --force-recreate nginx backend7.2 生产环境安全加固必要安全措施网络隔离networks: ruoyi-net: driver: bridge internal: true # 禁止外部访问最小权限原则mysql: environment: MYSQL_ROOT_PASSWORD: $DB_ROOT_PASS MYSQL_USER: ruoyi_prod MYSQL_PASSWORD: $DB_USER_PASS定期备份策略# 每日备份脚本 docker exec ruoyi-mysql mysqldump -u$DB_USER -p$DB_PASS ry-vue | gzip /backups/mysql-$(date %F).sql.gz日志轮转配置nginx: logging: driver: json-file options: max-size: 10m max-file: 37.3 高可用架构建议对于生产环境建议采用数据库集群MySQL主从复制或Galera集群Redis哨兵配置Sentinel实现故障转移Nginx负载均衡多实例Keepalived应用水平扩展后端服务多实例部署示例扩展配置backend: image: openjdk:8-jdk deploy: replicas: 3 healthcheck: test: [CMD, curl, -f, http://localhost:8080/actuator/health] interval: 10s timeout: 5s retries: 38. 技术决策与替代方案8.1 为什么选择Docker Compose与Kubernetes等方案相比Docker Compose的优势在于学习曲线平缓YAML语法简单直观开发友好本地调试更方便资源消耗低不需要集群管理组件快速迭代适合中小项目快速部署8.2 镜像选择考量在官方镜像基础上我们做了如下技术选型MySQL 5.7若依官方兼容版本平衡功能与稳定性Redis Alpine版小体积适合内存敏感场景OpenJDK 8项目原始编译环境避免兼容问题Nginx Alpine足够轻量且功能完整8.3 可能的技术变体根据实际需求可考虑以下变体方案使用PostgreSQL替代MySQL修改数据库配置和连接驱动前端使用Node.js SSR调整Nginx配置支持服务端渲染集成ELK日志系统增加Filebeat收集容器日志加入监控告警集成GrafanaAlertmanager配置示例elk: image: sebp/elk ports: - 5601:5601 - 9200:9200 - 5044:5044 volumes: - ./elk-data:/var/lib/elasticsearch networks: - ruoyi-net9. 经验分享与踩坑记录在实际部署中有几个关键点需要特别注意时区问题所有容器必须统一时区否则可能导致日志时间错乱、定时任务异常。建议在docker-compose.yml中全局设置environment: TZ: Asia/Shanghai文件权限Linux主机与容器之间的文件读写可能出现权限冲突。特别是MySQL数据目录容器内默认使用mysql用户(UID 999)运行需要确保挂载目录可写chown -R 999:999 data/mysql内存限制Java应用在容器中需要显式设置堆内存参数否则会尝试使用全部主机内存。推荐配置deploy: resources: limits: memory: 2G健康检查服务间的依赖关系需要合理设置健康检查避免启动顺序问题。MySQL的健康检查应该这样配置healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 3s retries: 5网络延迟在首次启动时后端服务连接数据库可能会因网络初始化延迟而失败。解决方法是在应用中加入重试逻辑或在command中添加等待脚本command: bash -c while ! nc -z mysql 3306; do echo Waiting for MySQL...; sleep 2; done; java -jar ruoyi-admin.jar 10. 扩展思考从Compose到云原生虽然Docker Compose解决了单机部署问题但当需要扩展到多节点或生产环境时可以考虑Docker Swarm内置集群功能兼容Compose文件格式docker swarm init docker stack deploy -c docker-compose.yml ruoyiKubernetes使用kompose工具转换kompose convert -f docker-compose.yml kubectl apply -f .云服务集成AWS ECS with FargateAzure Container Instances阿里云容器服务转换后的Kubernetes部署示例# deployment-backend.yaml apiVersion: apps/v1 kind: Deployment metadata: name: ruoyi-backend spec: replicas: 2 selector: matchLabels: app: ruoyi-backend template: metadata: labels: app: ruoyi-backend spec: containers: - name: backend image: openjdk:8-jdk ports: - containerPort: 8080 env: - name: SPRING_PROFILES_ACTIVE value: prod resources: limits: memory: 1Gi cpu: 500m无论选择哪种进阶方案基于Docker Compose的部署经验都将成为重要的基础。这种容器化的思维方式正是现代DevOps实践的核心所在。