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

告别环境配置焦虑：用Docker Compose一键部署RuoYi-Vue前后端开发环境（含MySQL 5.7/Redis 6.2）

news 2026/7/11 20:29:58

容器化开发环境革命：基于Docker Compose的RuoYi-Vue全栈部署指南

在传统开发模式中，环境配置堪称程序员的第一道"拦路虎"。不同操作系统间的兼容性问题、依赖库版本冲突、团队环境不一致导致的"在我机器上能跑"现象，消耗了开发者大量宝贵时间。以流行的RuoYi-Vue快速开发平台为例，传统部署方式需要分别安装配置JDK、MySQL、Redis、Node.js等十余个组件，任何环节出错都可能导致整个系统无法启动。

1. 为什么选择Docker Compose方案

环境配置的痛点在团队协作中会被无限放大。新成员入职第一周往往都在折腾环境，而资深开发者切换工作设备时，那些曾经记录在私人笔记里的配置步骤早已模糊不清。更糟糕的是，当需要同时维护多个项目时，不同项目对基础服务的版本要求可能相互冲突。

容器化技术带来的环境即代码理念彻底改变了这一局面。通过Docker Compose，我们可以将整个RuoYi-Vue依赖的服务栈（MySQL 5.7 + Redis 6.2 + 后端Java环境 + 前端Node环境）定义为YAML配置文件，实现：

一键环境复现：新成员只需获取一个文件，5分钟即可获得完整开发环境
版本精确控制：每个服务版本明确定义，避免"大概能用"的模糊状态
资源隔离：不同项目使用独立容器，不再担心依赖冲突
跨平台一致性：无论Windows/macOS/Linux，表现完全一致

version: '3.8' services: mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: ruoyi123 volumes: - mysql_data:/var/lib/mysql ports: - "3306:3306"

这个典型的MySQL服务定义展示了Docker Compose的核心优势——用声明式配置代替手动操作。当我们需要升级MySQL版本时，只需修改image: mysql:5.7这一行代码，比传统方式安全可靠得多。

2. 完整环境架构设计

RuoYi-Vue的标准技术栈包含多个相互依赖的组件。我们的目标是构建一个自包含的服务集群，各组件通过内部网络通信，同时保留必要的对外服务端口。

2.1 服务拓扑结构

┌─────────────────────────────────────────────────┐ │ Docker Host │ │ │ │ ┌───────────┐ ┌───────────┐ ┌─────────┐ │ │ │ MySQL │ │ Redis │ │ Admin │ │ │ │ 5.7 │ │ 6.2 │ │ (Java) │ │ │ └─────┬─────┘ └─────┬─────┘ └────┬────┘ │ │ │ │ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌────▼────┐ │ │ │ Volume │ │ Volume │ │ Front │ │ │ │(Persistence)│ │(Optional) │ │ (Node) │ │ │ └───────────┘ └───────────┘ └─────────┘ │ └─────────────────────────────────────────────────┘

关键设计要点：

网络隔离：所有服务默认加入同一个自定义网络，通过服务名互访
数据持久化：对MySQL使用命名卷(named volume)保证数据安全
资源限制：为每个容器配置合理的CPU/内存限制
端口暴露：仅前端(80)和后端API(8080)需要对外暴露

2.2 编排文件核心参数

services: ruoyi-mysql: image: mysql:5.7.37 environment: MYSQL_ROOT_PASSWORD: ruoyi123 MYSQL_DATABASE: ry-vue TZ: Asia/Shanghai volumes: - mysql_data:/var/lib/mysql networks: - ruoyi-net healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 3s retries: 3

这个MySQL配置展示了生产级部署应考虑的多个细节：

显式设置时区避免时间错乱
健康检查确保服务真正可用
专用网络提高安全性
环境变量预创建数据库

3. 实战：编写docker-compose.yml

让我们从零开始构建完整的编排文件。建议使用Visual Studio Code配合Docker插件，它能自动校验YAML语法并提供智能提示。

3.1 基础服务定义

创建docker-compose.yml文件，从最核心的数据库服务开始：

version: '3.8' volumes: mysql_data: redis_data: networks: ruoyi-net: driver: bridge services: mysql: image: mysql:5.7.37 container_name: ruoyi-mysql environment: MYSQL_ROOT_PASSWORD: ruoyi123 MYSQL_DATABASE: ry-vue volumes: - mysql_data:/var/lib/mysql - ./sql:/docker-entrypoint-initdb.d ports: - "3306:3306" networks: - ruoyi-net healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] redis: image: redis:6.2-alpine container_name: ruoyi-redis volumes: - redis_data:/data ports: - "6379:6379" networks: - ruoyi-net command: redis-server --appendonly yes

几个关键技巧：

使用alpine版本的Redis镜像减小体积
通过./sql目录挂载实现数据库自动初始化
Redis启用AOF持久化保证数据安全
为每个容器指定易记的名称方便管理

3.2 后端服务配置

后端Java服务需要构建自定义镜像。首先创建Dockerfile：

FROM openjdk:8-jdk-alpine WORKDIR /app COPY ruoyi-admin/target/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","app.jar"]

然后在compose文件中添加服务定义：

backend: build: context: . dockerfile: Dockerfile container_name: ruoyi-backend depends_on: mysql: condition: service_healthy redis: condition: service_started environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/ry-vue?useSSL=false SPRING_DATASOURCE_USERNAME: root SPRING_DATASOURCE_PASSWORD: ruoyi123 SPRING_REDIS_HOST: redis ports: - "8080:8080" networks: - ruoyi-net

这里有几个重要细节：

使用depends_on确保数据库就绪后再启动应用
通过环境变量覆盖原配置文件中的连接信息
服务间使用容器名称(如mysql)作为主机名通信

3.3 前端服务集成

前端服务采用动态构建模式，避免每次代码修改都重建镜像：

frontend: image: node:16-alpine container_name: ruoyi-frontend working_dir: /app volumes: - ./ruoyi-ui:/app ports: - "80:80" networks: - ruoyi-net command: > sh -c "npm install && npm run dev" depends_on: backend: condition: service_started

这种配置实现了：

源码实时映射到容器，支持热更新
每次启动自动安装依赖(适合开发环境)
自动代理API请求到后端服务

4. 高级配置与优化

基础服务运行起来后，我们需要考虑生产环境所需的可靠性、安全性和性能优化。

4.1 资源限制与重启策略

services: mysql: deploy: resources: limits: cpus: '1' memory: 1G restart: unless-stopped backend: deploy: resources: limits: cpus: '0.5' memory: 512M restart: on-failure

合理设置资源限制可以防止单个服务耗尽主机资源。重启策略确保服务异常退出后自动恢复。

4.2 日志管理方案

默认情况下Docker日志会占用大量磁盘空间。我们可以在compose文件中全局配置日志轮转：

services: mysql: logging: driver: json-file options: max-size: "10m" max-file: "3"

对于Java应用，建议在logback配置中使用${LOG_PATH}变量，然后在compose中指定：

environment: LOG_PATH: "/logs" volumes: - ./logs:/logs

4.3 多环境配置管理

通过环境变量文件实现不同环境的差异化配置：

创建.env文件定义公共变量：

MYSQL_VERSION=5.7.37 REDIS_VERSION=6.2-alpine NETWORK_NAME=ruoyi-net

在compose文件中引用：

networks: ${NETWORK_NAME}: driver: bridge services: mysql: image: mysql:${MYSQL_VERSION}

运行时指定环境文件：

docker-compose --env-file .env.prod up

5. 开发工作流优化

容器化环境为开发流程带来了新的可能性。下面介绍几种提升效率的实践方法。

5.1 一键初始化脚本

创建init.sh脚本自动化整个流程：

#!/bin/bash # 克隆源码 git clone https://gitee.com/y_project/RuoYi-Vue.git # 构建后端 cd RuoYi-Vue mvn clean package -DskipTests # 启动服务 docker-compose up -d # 初始化数据库 while ! docker exec ruoyi-mysql mysqladmin ping -h localhost --silent; do sleep 1 done docker exec -i ruoyi-mysql mysql -uroot -pruoyi123 ry-vue < sql/ry_20210908.sql docker exec -i ruoyi-mysql mysql -uroot -pruoyi123 ry-vue < sql/quartz.sql echo "系统已启动：" echo "- 前端：http://localhost" echo "- 后端：http://localhost:8080"

5.2 本地开发热加载配置

对于后端Java开发，可以配置远程调试和热部署：

backend: environment: JAVA_TOOL_OPTIONS: > -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 SPRING_DEVTOOLS_REMOTE_DEBUG: "true" ports: - "8080:8080" - "5005:5005"

在IDE中创建远程调试配置，连接localhost:5005即可实现断点调试。

5.3 常用运维命令速查

场景	命令	说明
查看日志	`docker-compose logs -f backend`	实时跟踪后端日志
执行命令	`docker exec -it ruoyi-mysql bash`	进入MySQL容器
资源监控	`docker stats`	查看容器资源占用
数据备份	`docker run --rm -v mysql_data:/volume -v $(pwd):/backup alpine tar cvf /backup/mysql.tar /volume`	备份MySQL数据卷