Docker Compose通过docker-compose.yml统一定义多容器服务,实现单机上Web、数据库、缓存等职责单一且隔离的容器协同工作,依赖服务名通信、volumes持久化数据、depends_on控制启动顺序,并支持一键启停与环境隔离。

单机多应用部署不是把多个程序塞进一个容器里,而是用 Docker Compose 在一台机器上同时运行多个相互协作的容器——每个容器职责单一、彼此隔离,又通过内网自动联通。这是现代开发和轻量级生产环境的标准做法。
明确“多应用”的合理结构
一个典型多应用系统包含 Web 服务、数据库、缓存等独立组件。Docker 不鼓励在单个容器里跑 N 个进程(比如 nginx + php + mysql),而主张“一个容器一个主进程”。所以“多应用”实际指多个容器协同工作:
- Web 前端(如 Nginx 或 React 静态服务)
- 后端 API(如 Node.js、Python Flask)
- 数据库(如 MySQL、PostgreSQL 或 MongoDB)
- 可选:Redis 缓存、消息队列、搜索服务等
用 docker-compose.yml 统一定义服务
核心是编写 docker-compose.yml 文件,它声明所有服务的镜像、端口、网络、依赖和数据卷。例如:
version: '3.8'
services:
web:
image: nginx:alpine
ports: ["80:80"]
volumes: ["./nginx.conf:/etc/nginx/nginx.conf"]
depends_on: [api]
<p>api:
build: ./backend
environment:</p><ul><li>DB_HOST=db</li><li>DB_PORT=3306
depends_on: [db]</li></ul><p>db:
image: mysql:8.0
environment:</p><ul><li>MYSQL_ROOT_PASSWORD=root123</li><li>MYSQL_DATABASE=myapp
volumes: ["mysql-data:/var/lib/mysql"]</li></ul><p>volumes:
mysql-data:
关键点:
- 各服务默认在同一自建网络中,可通过服务名(如 db)直接通信
- depends_on 控制启动顺序,但不等待服务就绪(需应用层健康检查或重试逻辑)
- volumes 确保数据库等有状态服务的数据持久化
处理容器间通信与配置依赖
容器不是靠 IP 地址互通,而是靠服务名解析。比如后端代码连接数据库时,host 应写 db(而非 127.0.0.1 或 localhost),端口写 3306(容器内端口)。
常见问题及应对:
- “Connection refused”:后端启动太快,数据库还没就绪 → 加入启动重试(如 wait-for-it.sh 或自研健康检查)
- 环境变量硬编码 → 全部通过 environment 字段注入,敏感信息用 .env 文件管理
- 静态资源路径错乱 → Nginx 容器挂载前端构建产物目录,或使用 multi-stage 构建合并到镜像中
一键启停与日常运维
完成配置后,整套服务只需一条命令启动:
docker-compose up -d
其他常用操作:
-
查看日志:
docker-compose logs -f api -
进入容器调试:
docker-compose exec db mysql -uroot -proot123 -
重建并重启:
docker-compose up -d --build -
彻底清理:
docker-compose down -v(-v 同时删除 volume)
不复杂但容易忽略


















