删除

基本用法

使用 docker rm 删除已停止的容器：

$ docker rm 容器名或ID

💡 docker rm 是 docker container rm 的简写，两者等效。

---

删除选项

选项	说明	示例
无参数	删除已停止的容器	docker rm mycontainer
-f	强制删除运行中的容器	docker rm -f mycontainer
-v	同时删除关联的匿名卷	docker rm -v mycontainer

删除已停止的容器

$ docker rm mycontainer
mycontainer

强制删除运行中的容器

# 不加 -f 会报错
$ docker rm running_container
Error: cannot remove running container

# 加 -f 强制删除
$ docker rm -f running_container
running_container

⚠️ 强制删除会向容器发送 SIGKILL 信号，可能导致数据丢失。建议先 docker stop 优雅停止。

删除容器及其数据卷

# 删除容器时同时删除其匿名卷
$ docker rm -v mycontainer

注意：只删除匿名卷，命名卷不会被删除。

---

批量删除

删除所有已停止的容器

# 方式一：使用 prune 命令（推荐）
$ docker container prune

WARNING! This will remove all stopped containers.
Are you sure you want to continue? [y/N] y
Deleted Containers:
abc123...
def456...
Total reclaimed space: 150MB

# 方式二：不提示确认
$ docker container prune -f

删除所有容器（包括运行中的）

# 先停止所有容器，再删除
$ docker stop $(docker ps -q)
$ docker rm $(docker ps -aq)

# 或者直接强制删除
$ docker rm -f $(docker ps -aq)

按条件删除

# 删除所有已退出的容器
$ docker rm $(docker ps -aq -f status=exited)

# 删除名称包含 "test" 的容器
$ docker rm $(docker ps -aq -f name=test)

# 删除 24 小时前创建的容器
$ docker container prune --filter "until=24h"

---

常用过滤条件

docker ps 的过滤条件可以配合 rm 使用：

过滤条件	说明	示例
status=exited	已退出的容器	-f status=exited
status=created	已创建未启动	-f status=created
name=xxx	名称匹配	-f name=myapp
ancestor=xxx	基于某镜像创建	-f ancestor=nginx
before=xxx	在某容器之前创建	-f before=mycontainer
since=xxx	在某容器之后创建	-f since=mycontainer

示例

# 删除所有基于 nginx 镜像的容器
$ docker rm $(docker ps -aq -f ancestor=nginx)

# 删除所有创建后未启动的容器
$ docker rm $(docker ps -aq -f status=created)

---

容器与镜像的依赖关系

有容器依赖的镜像无法删除。

# 尝试删除有容器依赖的镜像
$ docker image rm nginx
Error: image is being used by stopped container abc123

# 需要先删除依赖该镜像的容器
$ docker rm abc123
$ docker image rm nginx

---

清理策略建议

开发环境

# 定期清理已停止的容器
$ docker container prune -f

# 一键清理所有未使用资源
$ docker system prune -f

生产环境

# 使用 --rm 参数运行临时容器
$ docker run --rm ubuntu echo "Hello"
# 容器退出后自动删除

# 定期清理（设置保留时间）
$ docker container prune --filter "until=168h"  # 保留 7 天内的

完整清理脚本

#!/bin/bash
# cleanup.sh - Docker 资源清理脚本

echo "清理已停止的容器..."
docker container prune -f

echo "清理未使用的镜像..."
docker image prune -f

echo "清理未使用的数据卷..."
docker volume prune -f

echo "清理未使用的网络..."
docker network prune -f

echo "清理完成！"
docker system df

---

常见问题

Q: 容器无法删除

Error: container is running

解决：先停止容器，或使用 -f 强制删除

$ docker stop mycontainer
$ docker rm mycontainer
# 或
$ docker rm -f mycontainer

Q: 删除后磁盘空间没释放

可能原因：

1. 容器的数据卷未删除（使用 -v 参数）

2. 镜像未删除

3. 构建缓存未清理

解决：

# 查看空间占用
$ docker system df

# 完整清理
$ docker system prune -a --volumes

---

本章小结

操作	命令
删除已停止容器	docker rm 容器名
强制删除运行中容器	docker rm -f 容器名
删除容器及匿名卷	docker rm -v 容器名
清理所有已停止容器	docker container prune
删除所有容器	docker rm -f $(docker ps -aq)

延伸阅读

• 终止容器：优雅停止容器

• 删除镜像：清理镜像

• 数据卷：数据卷管理