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
四、扩缩容与资源管理
- 临时扩缩容(–scale参数)
命令格式
docker compose up -d –scale <服务名>=<数量>
示例
docker compose up -d –scale zabbix-web=2
注意
- 仅适用于 无状态服务(如 Web 服务器),有状态服务(如数据库)不能扩缩容
- 需确保端口映射支持(如使用负载均衡或动态端口)
- 持久化扩缩容(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:清理无用资源
功能
清理 未使用的卷、网络、容器(谨慎操作,避免误删)
七、高级用法:多文件与环境管理
- 多文件组合(-f参数)
场景
区分开发、生产环境(如 dev.yml + prod.yml)
- 环境变量管理
方法`
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 的灵活配置,实现复杂业务的容器化部署!