docker compose 快速启动多容器服务需三点：写对 docker-compose.yml（置于根目录，version 推荐 '3.8'，services 下定义 image 或 build、ports、environment 等）、确保镜像可用、执行 docker compose up -d 后台启动；依赖用 healthcheck + service_healthy 更可靠，避免仅靠 depends_on。
用 docker compose 快速启动多容器服务，核心就三点：写对 docker-compose.yml、确保镜像可用、执行一条命令。
写一个简洁有效的 docker-compose.yml
文件必须放在项目根目录，命名固定为 docker-compose.yml（或 docker-compose.yaml）。基础结构示例如下：
-
version：推荐明确写
'3.8'，避免语法兼容问题 -
services：每个服务块定义一个容器，比如
web、db、cache -
image 或 build：直接用公开镜像（如
postgres:15-alpine），或用build: ./service-name指向本地 Dockerfile -
ports：只对外暴露真正需要的端口（如网关暴露
80:8080，其他服务不写 ports） -
environment：把数据库地址写成服务名（如
DB_HOST=db），Docker Compose 自动做 DNS 解析
依赖不用手动等，但健康检查更可靠
depends_on 只控制启动顺序，不保证服务已就绪。例如 PostgreSQL 容器启动快，但初始化数据库可能要几秒。建议：
- 在应用代码里加连接重试逻辑（推荐）
- 或给关键服务加
healthcheck，再配合depends_on: [service_name] condition: service_healthy - 避免用
depends_on等非关键服务（如日志收集器）
一条命令启动，后台运行
在 docker-compose.yml 所在目录执行：
-
docker compose up -d：后台启动所有服务（注意是docker compose，不是旧版docker-compose） - 首次运行会自动拉取镜像或构建本地服务，之后再启很快
- 启动后用
docker compose ps查看状态，docker compose logs -f web实时看日志
常见卡点和应对
如果启动失败，优先检查这几处：
- 端口被占：改
ports映射（如"8081:80"）或停掉冲突进程 - 环境变量拼错：比如
POSTGRES_PASSWORD写成POSTGRES_PASS - 路径错误：用
build时，./backend要真实存在且含有效 Dockerfile - 权限问题：Linux 下挂载宿主机目录，确认目录有读写权限
