用 Compose 管理一组小服务
比起一堆 docker run,compose 文件让依赖、网络和数据卷都可追踪。
当一组服务互相依赖时,一堆 docker run 命令很快就没人记得住。Compose 的价值是把依赖、网络、数据卷和环境变量写进一个文件。
文件结构
一个服务一个块,变量放 .env,敏感信息不写进版本库。网络默认用项目内网,只有需要对外暴露的端口才映射到宿主机。
yaml
services:
app:
image: example/app:1.2.3
restart: unless-stopped
env_file: .env
environment:
TZ: Asia/Shanghai
volumes:
- ./data:/app/data
ports:
- "127.0.0.1:8080:8080"
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8080/health"]
interval: 30s
timeout: 5s
retries: 3端口绑定到 127.0.0.1 而不是 0.0.0.0,可以避免服务意外暴露到整个网络。
依赖与启动顺序
depends_on 只保证启动顺序,不保证服务就绪。要等健康检查通过,需要条件写法:
yaml
depends_on:
db:
condition: service_healthy前提是 db 配了 healthcheck,否则条件永远不成立。
升级与回滚
镜像固定版本号,不要用 latest。升级前备份数据卷,升级后先看健康检查,再放流量。
bash
docker compose pull app
docker compose up -d app
docker compose logs -f --tail=50 app回滚就是把镜像 tag 改回上一个版本再 up -d,前提是数据格式兼容。
常见问题
- 容器时区、UID、日志驱动是最容易忽略的三项;
.env里的值会覆盖environment,但不会覆盖命令行-e;down会删网络但保留具名卷,down -v才会删卷,别顺手加-v。
用 profiles 管可选服务
调试用的 adminer、备份用的临时容器,放到 profiles 里,默认不启动,需要时 --profile tools up -d。
小结
Compose 适合“一台机器上的一组服务”。文件进版本库,镜像锁版本,健康检查到位,就已经比手敲命令稳得多。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2025-11-28。