首页/容器/正文

用 Compose 管理一组小服务

比起一堆 docker run,compose 文件让依赖、网络和数据卷都可追踪。

容器容器与部署2025-11-28约 2 分钟396 字

当一组服务互相依赖时,一堆 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。