https://www.toutiao.com/article/7532699360421888566/

以下是 Docker Compose 常用命令手册,按 生命周期管理、服务运维、构建配置、扩缩容、调试工具 分类,附带 参数解析、示例 和 关键说明,覆盖多容器编排核心场景:

一、生命周期管理(核心命令)

1.docker compose up:启动多容器服务
功能

启动并运行 docker-compose.yml 中定义的所有服务(自动创建网络、卷、容器)

常用参数

--d:后台运行( detached 模式,推荐生产环境)
--build:启动前强制重建镜像
--force-recreate:强制重建容器(忽略缓存,强制更新)
- --remove-orphans:删除 yml 中未定义的旧容器
--scale <服务名>=<数量>:临时扩缩容(如 --scale web=3)

示例

docker compose up -d

注意

  • 前台运行时(无 -d),日志直接输出到终端,Ctrl+C 会终止所有容器
  • 依赖服务会按 depends_on 顺序启动

2.docker compose down:停止并清理资源
功能

停止并删除 容器、网络、默认卷(数据卷需加参数才会删除,谨慎操作!)

常用参数


--volumes:删除 yml 中定义的数据卷(持久化数据会丢失!)
--rmi all:删除所有相关镜像
--remove-orphans:删除 yml 中未定义的旧资源

示例

docker compose down

注意

若数据卷标记为 external: true,–volumes 不会删除它
生产环境慎用 –volumes,避免数据丢失

3.docker compose start/stop/restart:启停服务
命令

作用

示例

docker compose start

启动 已停止 的容器(不会重建,保留之前的状态)

docker compose start web(仅启动 web 服务)

docker compose stop

停止 运行中 的容器(不会删除,可重启)

docker compose stop(停止所有服务)

docker compose restart

重启所有服务(先 stop 再 start,可指定服务名)

docker compose restart db(仅重启 db 服务)

二、服务运维与监控

1.docker compose ps:查看服务状态
功能

列出当前 Compose 项目的所有服务状态(名称、镜像、状态、端口映射等)

示例

2.docker compose logs:查看服务日志
功能

查看服务的日志输出,支持实时跟踪、筛选服务

常用参数


- -f:实时跟踪日志(follow,类似 tail -f)
- --tail 100:仅显示最后 100 行
- <服务名>:筛选指定服务(如 web)

示例

3.docker compose exec:进入运行中的容器执行命令
功能

在 已运行 的容器内执行命令(类似 docker exec,但更便捷)

示例

docker compose exec -it db /bin/bash

注意

这里进入的选的是yaml文件中的services 名称,不是容器名

4.docker compose run:启动临时容器执行命令
功能

新建一个临时容器运行命令(适合一次性任务,如数据库迁移、测试)

三、构建与配置管理

1.docker compose build:构建服务镜像
功能

构建 docker-compose.yml 中定义的服务镜像(基于 build 字段)

常用参数

–no-cache:不使用缓存,强制重新构建(确保代码更新生效)

–pull:强制拉取基础镜像(如 ubuntu:latest)
<服务名>:仅构建指定服务(如 web)

2.docker compose config:验证与预览配置
功能

验证 docker-compose.yml 语法,输出最终生效的配置(含变量替换、多文件合并)

示例

docker compose config

四、扩缩容与资源管理

  1. 临时扩缩容(–scale参数)
    命令格式

docker compose up -d –scale <服务名>=<数量>

示例

docker compose up -d –scale zabbix-web=2

注意


- 仅适用于 无状态服务(如 Web 服务器),有状态服务(如数据库)不能扩缩容
- 需确保端口映射支持(如使用负载均衡或动态端口)


  1. 持久化扩缩容(deploy.replicas)
    方法

在 docker-compose.yml 中定义 deploy 字段,支持 Swarm/K8s 环境

五、调试与高级工具

1.docker compose top:查看容器内进程
功能

查看服务容器内运行的进程(类似 top 命令)

示例

docker compose top

2.docker compose port:查看端口映射
功能

查看服务的端口映射关系(主机端口 ↔ 容器端口)

示例

docker compose port zabbix-web 80

六、清理与维护

1.docker compose rm:删除已停止的容器
功能

删除 Compose 管理的已停止容器(需先 stop 或 down 停止)

常用参数

  • -f:强制删除,无需确认
  • -v:同时删除关联的数据卷(谨慎!)

2.docker compose prune:清理无用资源
功能

清理 未使用的卷、网络、容器(谨慎操作,避免误删)

七、高级用法:多文件与环境管理

  1. 多文件组合(-f参数)
    场景

区分开发、生产环境(如 dev.yml + prod.yml)

  1. 环境变量管理
    方法
    `asp
  • 通过 .env 文件加载环境变量(自动读取同目录的 .env)
  • 用 –env-file 指定自定义文件
    `

命令速查表(核心场景)
场景

命令

说明

启动服务(后台 + 构建)

docker compose up -d –build

开发环境快速更新

停止并清理

docker compose down

测试环境常用,生产慎用 –volumes

查看实时日志

docker compose logs -f web

跟踪 web 服务的实时日志

进入容器终端

docker compose exec web sh

调试运行中的容器

临时扩缩容

docker compose up -d –scale web=3

无状态服务快速扩容

验证配置语法

docker compose config –quiet

部署前检查 yml 语法

关键注意事项
版本差异:Docker Compose v2 推荐用 docker compose(无短横线),v1 是 docker-compose,建议升级到 v2。
数据持久化:down –volumes 会删除数据卷,生产环境务必备份或使用外部卷(external: true)。
扩缩容限制:有状态服务(如数据库)不能直接扩缩容,需配合集群方案(如 Redis 集群、MySQL 主从)。
多文件优先级:-f 后指定的文件会覆盖前面的配置(如 prod.yml 覆盖 dev.yml 的相同字段)。
掌握这些命令,即可高效管理 多容器应用的启停、构建、调试、扩缩容,结合 docker-compose.yml 的灵活配置,实现复杂业务的容器化部署!

文档更新时间: 2025-07-31 07:07   作者:admin