容器与云原生 / 知识点
Docker Compose 命令速查手册
创建、启动与停止
docker compose up -d --force-recreate即使配置和镜像未变化也重新创建容器。
强制重建容器
即使配置和镜像未变化也重新创建容器。
基本语法
docker compose up -d --force-recreate推荐用法
docker compose up -d --force-recreate预期结果
旧容器停止并由新容器替换。关键边界
named volume 一般保留;匿名 volume 是否续用另有参数控制。
docker compose up -d --no-recreate如果容器已经存在,则不因配置变化重新创建。
禁止重建已有容器
如果容器已经存在,则不因配置变化重新创建。
基本语法
docker compose up -d --no-recreate推荐用法
docker compose up -d --no-recreate预期结果
已有容器保持原配置运行。关键边界
可能导致 Compose 文件与运行状态不一致,只适合明确场景。
docker compose up -d --no-deps <SERVICE>只操作目标 service,不自动启动其依赖。
不启动依赖服务
只操作目标 service,不自动启动其依赖。
基本语法
docker compose up -d --no-deps <SERVICE>推荐用法
docker compose up -d --no-deps web预期结果
仅目标服务被启动/重建。关键边界
服务可能因数据库、缓存等依赖缺失而启动失败。
docker compose up -d --remove-orphans移除同 project 中已经不再出现在当前 Compose 模型里的服务容器。
启动并移除孤儿容器
移除同 project 中已经不再出现在当前 Compose 模型里的服务容器。
基本语法
docker compose up -d --remove-orphans推荐用法
docker compose up -d --remove-orphans预期结果
orphan 容器被删除。关键边界
确认 project name 和配置文件没有选错,否则可能删除仍需要的旧服务。
docker compose up -d --wait启动项目并阻塞等待服务达到 running 或 healthy。
等待服务 Running/Healthy
启动项目并阻塞等待服务达到 running 或 healthy。
基本语法
docker compose up -d --wait推荐用法
docker compose up -d --wait预期结果
成功后命令退出码为 0。关键边界
有 healthcheck 时可等待健康状态;没有 healthcheck 只能判断运行状态。
docker compose up -d --wait --wait-timeout <SECONDS>给健康等待设置最长时间。
限制启动等待时间
给健康等待设置最长时间。
基本语法
docker compose up -d --wait --wait-timeout <SECONDS>推荐用法
docker compose up -d --wait --wait-timeout 60预期结果
超时仍未达到目标状态时返回失败。关键边界
非常适合 CI/CD 部署健康门禁。
docker compose start [SERVICE...]启动已经存在但停止的 Compose 容器。
启动已有停止容器
启动已经存在但停止的 Compose 容器。
基本语法
docker compose start [SERVICE...]推荐用法
docker compose start web预期结果
已有容器恢复运行。关键边界
start 不负责根据 Compose 配置变化重建;配置变化优先 up。
docker compose stop [SERVICE...]停止运行容器,但不删除它们。
停止服务但保留容器
停止运行容器,但不删除它们。
基本语法
docker compose stop [SERVICE...]推荐用法
docker compose stop web预期结果
容器进入 exited/stopped 状态。关键边界
后续可 start;与 down 的“停止并删除”不同。
docker compose stop -t <SECONDS>调整容器停止时等待进程优雅退出的时间。
指定优雅停止超时
调整容器停止时等待进程优雅退出的时间。
基本语法
docker compose stop -t <SECONDS>推荐用法
docker compose stop -t 30预期结果
超过超时后 Docker 会进一步终止容器。关键边界
数据库等服务需要足够 shutdown 时间。
docker compose restart [SERVICE...]停止并再次启动已有服务容器。
重启服务容器
停止并再次启动已有服务容器。
基本语法
docker compose restart [SERVICE...]推荐用法
docker compose restart web预期结果
容器重新启动。关键边界
restart 不会把 compose.yaml 的配置变更应用到已有容器;配置变更用 up -d。
docker compose down停止并删除 Compose 服务容器及项目网络。
停止并删除项目
停止并删除 Compose 服务容器及项目网络。
基本语法
docker compose down推荐用法
docker compose down预期结果
容器和默认/声明网络被移除。关键边界
named volumes 默认不删除,因此通常保留持久数据。
状态、日志与可观测性
docker compose ps查看当前项目容器状态、端口和名称。
查看服务状态
查看当前项目容器状态、端口和名称。
基本语法
docker compose ps推荐用法
docker compose ps预期结果
输出 Compose 容器状态表。关键边界
项目故障排查第一条命令之一。
docker compose ps -a查看运行与已退出的服务容器。
查看全部状态含已退出容器
查看运行与已退出的服务容器。
基本语法
docker compose ps -a推荐用法
docker compose ps -a预期结果
输出 running、exited 等状态。关键边界
服务“消失”时先用 -a 看是否已退出。
docker compose ps --status running按状态过滤 Compose 容器。
只看运行中服务
按状态过滤 Compose 容器。
基本语法
docker compose ps --status running推荐用法
docker compose ps --status running预期结果
只输出 running 容器。关键边界
也可过滤 exited、restarting、paused 等。
docker compose ps --format json输出结构化容器状态。
以 JSON 查看状态
输出结构化容器状态。
基本语法
docker compose ps --format json推荐用法
docker compose ps --format json预期结果
stdout 为 JSON。关键边界
CI/脚本优先结构化输出。
docker compose logs读取项目服务 stdout/stderr 日志。
查看全部服务日志
读取项目服务 stdout/stderr 日志。
基本语法
docker compose logs推荐用法
docker compose logs预期结果
输出各服务日志并带 service 前缀。关键边界
日志内容取决于容器 logging driver。
docker compose logs -f [SERVICE]持续查看服务新日志。
实时跟踪日志
持续查看服务新日志。
基本语法
docker compose logs -f [SERVICE]推荐用法
docker compose logs -f web预期结果
终端持续输出后续日志。关键边界
Ctrl+C 只停止跟踪,不会停止后台运行的容器。
docker compose logs --tail <N> [SERVICE]只查看每个目标容器最后 N 行日志。
查看最近 N 行日志
只查看每个目标容器最后 N 行日志。
基本语法
docker compose logs --tail <N> [SERVICE]推荐用法
docker compose logs --tail 200 web预期结果
输出最近 200 行。关键边界
生产排障比直接打印全部历史更实用。
docker compose logs --since <TIME> [SERVICE]只查看指定时间点之后产生的日志。
查看最近时间范围日志
只查看指定时间点之后产生的日志。
基本语法
docker compose logs --since <TIME> [SERVICE]推荐用法
docker compose logs --since 30m web预期结果
输出最近 30 分钟日志。关键边界
可与 -f、--tail 组合。
docker compose stats [SERVICE...]查看 Compose 容器 CPU、内存、网络和 I/O。
查看实时容器资源
查看 Compose 容器 CPU、内存、网络和 I/O。
基本语法
docker compose stats [SERVICE...]推荐用法
docker compose stats预期结果
持续刷新资源统计。关键边界
用于快速发现 CPU/内存异常,不替代完整监控系统。