docker compose down
停止并删除 Compose 创建的容器、网络等资源
语法
docker compose down [OPTIONS]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
-v --volumes |
同时删除数据卷 | docker compose down -v |
常用 |
--rmi |
删除镜像（all 或 local） | docker compose down --rmi all |
进阶 |
--remove-orphans |
删除未在 compose 文件中定义的容器 | docker compose down --remove-orphans |
进阶 |
-t --timeout |
停止超时时间 | docker compose down -t 30 |
进阶 |
示例
停止并清理容器和网络
docker compose down
保留数据卷和镜像
完全清理包括数据卷
docker compose down -v
数据库数据会丢失，慎用
清理所有包括镜像
docker compose down --rmi all -v
完全重置，下次 up 需要重新拉取和构建
清理孤立容器
docker compose down --remove-orphans
删除 compose 文件中已移除的服务对应的容器
常见错误
no configuration file provided: not found
需要在包含 compose 文件的目录下执行，或用 -f 指定
删除卷失败：volume is in use
有其他容器在使用该卷，先停止相关容器
技巧
- 开发环境用 down 即可，不要加 -v 避免丢失数据库数据
- 切换分支前用 down --remove-orphans 清理旧服务
- down 只删除 compose 创建的资源，不影响其他容器