🐳 Docker Compose 项目目录被删除后，如何安全关停残留容器

🐳 Docker Compose 项目目录被删除后，如何安全关停残留容器

在日常使用 Docker Compose 时，我们经常会遇到一种情况：
项目目录被删除了，但容器依然在运行，docker compose down 也失效了。
本文总结了如何安全地清理这些“失联”的 Compose 项目。

---

一、发现问题：项目目录已丢失

我们可以先列出所有 Compose 项目：

docker compose ls

输出示例：

NAME            STATUS         CONFIG_FILES
webapp          running(3)     /home/user/webapp/docker-compose.yml
oldservice      running(2)     <no such file or directory>

可以看到 oldservice 的目录已经不存在，但容器还在运行。

---

二、确认该项目对应的容器

Docker Compose 启动的容器都有一个统一的 label：
com.docker.compose.project=<project_name>

通过它可以筛选出所有属于该项目的容器：

docker ps -a --filter "label=com.docker.compose.project=oldservice"

这会列出所有 oldservice 的容器。

---

三、关闭并删除这些容器

停掉容器：

docker stop $(docker ps -q --filter "label=com.docker.compose.project=oldservice")

删除容器：

docker rm $(docker ps -aq --filter "label=com.docker.compose.project=oldservice")

---

四、清理残留的网络和卷（可选）

Compose 会创建网络和卷，也可以用 label 删除：

# 删除网络
docker network rm $(docker network ls -q --filter "label=com.docker.compose.project=oldservice")

# 删除卷（⚠️ 慎用，会删除数据）
docker volume rm $(docker volume ls -q --filter "label=com.docker.compose.project=oldservice")

执行前可以先查看确认：

docker network ls
docker volume ls

---

五、验证清理结果

再次查看：

docker compose ls

如果 oldservice 已经不在列表中，说明清理干净 ✅。

---

六、一键清理“失效项目”（可选脚本）

如果有多个项目目录丢失，可以用下面的脚本自动检测并清理：

docker compose ls --format json | jq -r '.[] | select(.ConfigFiles | test("no such file") or test("null")) | .Name' |
while read name; do
  echo "Cleaning project: $name"
  docker stop $(docker ps -q --filter "label=com.docker.compose.project=$name") 2>/dev/null
  docker rm $(docker ps -aq --filter "label=com.docker.compose.project=$name") 2>/dev/null
  docker network rm $(docker network ls -q --filter "label=com.docker.compose.project=$name") 2>/dev/null
done

保存为 docker-compose-clean.sh，添加执行权限：

chmod +x docker-compose-clean.sh

运行即可批量清理失效的 Compose 项目。

---

✅ 总结

操作	命令 / 方法	说明
查看项目	docker compose ls	检查是否有目录丢失
查看容器	docker ps -a --filter label=com.docker.compose.project=xxx	找到相关容器
停止容器	docker stop ...	关闭运行的容器
删除容器	docker rm ...	移除容器
删除网络和卷	docker network/volume rm ...	可选清理
批量清理脚本	docker-compose-clean.sh	一键清理失效项目