docker compose 常用命令手册_docker-compose init

liuian 2025-09-18 22:49 25 浏览

以下是 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 服务器），有状态服务（如数据库）不能扩缩容 - 需确保端口映射支持（如使用负载均衡或动态端口）

2. 持久化扩缩容（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）

2. 环境变量管理

方法	- 通过 .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 的灵活配置，实现复杂业务的容器化部署！

yml校验