手把手教你玩转 Docker Compose：告别一条条敲命令，一键编排微服务！

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！

🧩 一、为什么你需要 Docker Compose？

你是不是经常干这些事：

• 每次开发都要手动启动 MySQL、Redis、RabbitMQ、Nginx、Spring Boot……
• 一个项目要敲 5 条docker run命令，还容易漏参数？
• 想把整套环境分享给同事，结果他配了三天还没跑起来？
• 测试完想清理环境，结果忘了删哪个 volume？

Docker Compose 就是你的“一键部署神器”！

它用一个docker-compose.yml文件，定义所有服务、网络、卷、依赖关系，
然后一条命令：docker-compose up，全部搞定！

🎯 二、需求场景：Spring Boot + MySQL + Redis + Nginx 一键启动

假设你有一个典型的 Java 微服务项目，包含：

• 后端：Spring Boot（监听 8080）
• 数据库：MySQL
• 缓存：Redis
• 网关：Nginx（反向代理到后端）

现在，你要在本地快速搭建这套环境，并且能随时启动/停止/重建。

✅ 三、正确姿势：编写 docker-compose.yml

步骤 1：创建项目目录结构

mkdir myapp-compose cd myapp-compose touch docker-compose.yml mkdir -p nginx/conf.d

步骤 2：编写docker-compose.yml

version: '3.8' services: # MySQL 服务 mysql-db: image: mysql:8.0 container_name: mysql-db environment: MYSQL_ROOT_PASSWORD: 123456 MYSQL_DATABASE: myapp_db volumes: - mysql_data:/var/lib/mysql ports: - "3306:3306" networks: - app-network restart: always # Redis 服务 redis-cache: image: redis:7.0 container_name: redis-cache command: redis-server --appendonly yes --requirepass "mypassword123" volumes: - redis_data:/data ports: - "6379:6379" networks: - app-network restart: always # Spring Boot 应用（假设你已构建好镜像 my-spring-app:1.0） app: image: my-spring-app:1.0 container_name: my-spring-app depends_on: - mysql-db - redis-cache ports: - "8080:8080" networks: - app-network restart: always # Nginx 反向代理 nginx-proxy: image: nginx:1.25 container_name: nginx-proxy ports: - "80:80" volumes: - ./nginx/conf.d:/etc/nginx/conf.d depends_on: - app networks: - app-network restart: always # 定义自定义网络（自动创建） networks: app-network: driver: bridge # 定义持久化卷（数据不会丢） volumes: mysql_data: redis_data:

💡 注意：

• 所有服务都在同一个app-network，可以直接用服务名作为域名通信！
• depends_on表示启动顺序（但不等服务真正 ready，需配合健康检查）
• volumes实现数据持久化
• ports用于对外暴露端口

步骤 3：配置 Nginx（nginx/conf.d/default.conf）

server { listen 80; server_name localhost; location /api/ { proxy_pass http://app:8080/; # ← 关键！直接用服务名 "app" proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location / { root /usr/share/nginx/html; index index.html; } }

✅ 因为 Nginx 和 app 在同一个 Docker 网络，所以http://app:8080能直接解析！

步骤 4：Spring Boot 配置（application.yml）

spring: datasource: url: jdbc:mysql://mysql-db:3306/myapp_db?useSSL=false&serverTimezone=UTC username: root password: 123456 redis: host: redis-cache port: 6379 password: mypassword123

✅ 数据库地址写mysql-db（服务名），不是localhost！

🚀 四、一键启动 & 管理

启动所有服务（后台运行）

docker-compose up -d

查看日志

# 查看所有服务日志 docker-compose logs -f # 只看 app 日志 docker-compose logs -f app

停止 & 删除

# 停止 docker-compose down # 停止 + 删除卷（⚠️ 数据会丢！） docker-compose down -v

重建某个服务（比如更新了 Spring Boot 镜像）

docker-compose up -d --build app

❌ 五、反例：新手常犯的错误

反例 1：没用自定义网络，靠 IP 或 localhost 通信

# 错误！默认网络无法用服务名解析 services: app: image: myapp db: image: mysql

→ 结果：UnknownHostException: db

✅ 正确：显式定义networks并让所有服务加入。

反例 2：忘记挂载配置文件，Nginx 用默认配置

• Nginx 启动了，但没代理后端
• 白跑！

✅ 正确：用volumes挂载自定义default.conf

反例 3：把敏感信息写死在 yml 里（生产大忌！）

environment: MYSQL_ROOT_PASSWORD: 123456 # ← 明文密码！

✅ 正确做法（开发可用，生产用 secrets）：

environment: MYSQL_ROOT_PASSWORD_FILE: /run/secrets/mysql_password secrets: - mysql_password

⚠️ 六、注意事项（避坑指南）

1. depends_on不等于“等服务就绪”
   它只控制容器启动顺序，不等待 MySQL 真正可连接！
   解决方案：在 Spring Boot 中加连接重试，或使用healthcheck（Compose v2.1+ 支持）。

2. Windows 路径挂载注意
   如果用 Windows，路径写成：

   volumes: - ./nginx/conf.d:/etc/nginx/conf.d

   确保 Docker Desktop 已授权该目录共享。

3. 镜像版本固定
   写mysql:8.0而不是mysql:latest，避免自动升级导致兼容问题。

4. 不要在生产直接用docker-compose
   生产建议用 Kubernetes 或 Swarm。Compose 适合开发/测试。

🧪 七、进阶技巧

技巧 1：多环境配置（dev / prod）

# 开发环境 docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d # 生产环境 docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

技巧 2：变量替换（.env文件）

创建.env：

DB_PASSWORD=supersecret123 REDIS_PASSWORD=cache123

在docker-compose.yml中引用：

environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}

✅ 八、总结：Compose 的核心优势

🌟一句话记住：
“一个文件定义一切，一条命令启动全家！”

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！