什么是 docker compose down?
docker compose down 是 Docker Compose 提供的一个命令,用于停止并删除由 docker compose up 启动的服务、容器、网络,以及(可选)卷和镜像。
基本语法
docker compose down [OPTIONS]
常用选项包括:
-v或--volumes:同时删除在docker-compose.yml中声明的命名卷。--remove-orphans:删除未在 compose 文件中定义但仍在运行的容器。-t或--timeout TIMEOUT:指定停止容器前等待的时间(秒)。
典型使用示例
1. 基本停用服务
docker compose down
这将停止并删除所有由当前 compose 文件定义的容器和网络。
2. 同时删除数据卷
docker compose down -v
适用于彻底清理环境,包括持久化数据。
3. 清理孤立容器
docker compose down --remove-orphans
当你修改了 compose 文件后,旧服务可能残留为“孤儿”容器,此命令可一并清除。
注意事项
- 该命令不会删除外部定义的卷或网络(即在 compose 文件中标记为
external: true的资源)。 - 如果未使用
-v,数据卷将保留,以便后续恢复数据。 - 执行前请确认是否需要保留日志或数据,避免误删。