删除本地镜像

基本用法

使用 docker image rm 删除本地镜像：

$ docker image rm [选项] <镜像1> [<镜像2> ...]

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

---

镜像标识方式

删除镜像时，可以使用多种方式指定镜像：

方式	说明	示例
短 ID	ID 的前几位（通常 3-4 位）	docker rmi 501
长 ID	完整的镜像 ID	docker rmi 501ad78535f0...
镜像名:标签	仓库名和标签	docker rmi redis:alpine
镜像摘要	精确的内容摘要	docker rmi nginx@sha256:...

使用短 ID 删除

$ docker image ls
REPOSITORY   TAG     IMAGE ID       SIZE
redis        alpine  501ad78535f0   30MB
nginx        latest  e43d811ce2f4   142MB

# 只需输入足够区分的前几位
$ docker rmi 501
Untagged: redis:alpine
Deleted: sha256:501ad78535f0...

使用镜像名删除

$ docker rmi redis:alpine
Untagged: redis:alpine
Deleted: sha256:501ad78535f0...

使用摘要删除

摘要删除最精确，适用于 CI/CD 场景：

# 查看镜像摘要
$ docker images --digests
REPOSITORY   TAG    DIGEST                   IMAGE ID
nginx        latest sha256:b4f0e0bdeb5...    e43d811ce2f4

# 使用摘要删除
$ docker rmi nginx@sha256:b4f0e0bdeb578043c1ea6862f0d40cc4afe32a4a582f3be235a3b164422be228

---

理解输出信息

删除镜像时会看到两类信息：Untagged 和 Deleted

$ docker rmi redis:alpine
Untagged: redis:alpine
Untagged: redis@sha256:f1ed3708f538b537eb9c2a7dd50dc90a706f7debd7e1196c9264edeea521a86d
Deleted: sha256:501ad78535f015d88872e13fa87a828425117e3d28075d0c117932b05bf189b7
Deleted: sha256:96167737e29ca8e9d74982ef2a0dda76ed7b430da55e321c071f0dbff8c2899b
Deleted: sha256:32770d1dcf835f192cafd6b9263b7b597a1778a403a109e2cc2ee866f74adf23

Untagged vs Deleted

操作	含义
Untagged	移除镜像的标签
Deleted	删除镜像的存储层

删除流程

docker rmi redis:alpine
        │
        ▼
┌───────────────────────────────────────────────────────────────┐
│  1. Untag：移除 redis:alpine 标签                              │
│       ↓                                                       │
│  2. 检查是否还有其他标签指向这个镜像                             │
│       ├── 有 → 只 Untag，不删除                                │
│       └── 无 →                                                │
│             ↓                                                 │
│  3. 检查是否有容器依赖                                          │
│       ├── 有 → 报错，无法删除                                  │
│       └── 无 →                                                │
│             ↓                                                 │
│  4. 从上到下逐层删除，检查每层是否被其他镜像使用                   │
│       ├── 被使用 → 保留                                       │
│       └── 未使用 → Deleted                                    │
└───────────────────────────────────────────────────────────────┘

---

批量删除

删除所有虚悬镜像

虚悬镜像（dangling）：没有标签的镜像，通常是旧版本被新版本覆盖后产生的

# 查看虚悬镜像
$ docker images -f dangling=true

# 删除虚悬镜像
$ docker image prune

# 不提示确认
$ docker image prune -f

删除所有未使用的镜像

# 删除所有没有被容器使用的镜像
$ docker image prune -a

# 保留最近 24 小时的
$ docker image prune -a --filter "until=24h"

按条件删除

# 删除所有 redis 镜像
$ docker rmi $(docker images -q redis)

# 删除 mongo:8.0 之前的所有镜像
$ docker rmi $(docker images -q -f before=mongo:8.0)

# 删除某个时间之前的镜像
$ docker image prune -a --filter "until=168h"  # 7天前

---

删除失败的常见原因

原因一：有容器依赖

$ docker rmi nginx
Error: conflict: unable to remove repository reference "nginx" 
(must force) - container abc123 is using its referenced image

解决方案：

# 方案1：先删除依赖的容器
$ docker rm abc123
$ docker rmi nginx

# 方案2：强制删除镜像（容器仍可运行，但无法再创建新容器）
$ docker rmi -f nginx

原因二：多个标签指向同一镜像

$ docker images
REPOSITORY   TAG     IMAGE ID
ubuntu       24.04   ca2b0f26964c
ubuntu       latest  ca2b0f26964c   # 同一个镜像

$ docker rmi ubuntu:24.04
Untagged: ubuntu:24.04
# 只是移除标签，镜像仍存在（因为还有 ubuntu:latest 指向它）

原因三：被其他镜像依赖（中间层）

$ docker rmi some_base_image
Error: image has dependent child images

中间层镜像被其他镜像依赖，无法删除。需要先删除依赖它的镜像。

---

常用过滤条件

过滤条件	说明	示例
dangling=true	虚悬镜像	-f dangling=true
before=镜像	在某镜像之前	-f before=mongo:3.2
since=镜像	在某镜像之后	-f since=mongo:3.2
label=key=value	按标签过滤	-f label=version=1.0
reference=pattern	按名称模式	-f reference='*:latest'

---

清理策略

开发环境

# 定期清理虚悬镜像
$ docker image prune -f

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

CI/CD 环境

# 只保留最近使用的镜像
$ docker image prune -a --filter "until=72h" -f

查看空间占用

$ docker system df
TYPE            TOTAL   ACTIVE   SIZE      RECLAIMABLE
Images          15      3        2.5GB     1.8GB (72%)
Containers      5       2        100MB     80MB (80%)
Local Volumes   8       2        500MB     400MB (80%)
Build Cache     0       0        0B        0B

---

本章小结

操作	命令
删除指定镜像	docker rmi 镜像名:标签
强制删除	docker rmi -f 镜像名
删除虚悬镜像	docker image prune
删除未使用镜像	docker image prune -a
批量删除	docker rmi $(docker images -q -f ...)
查看空间占用	docker system df

延伸阅读

• 列出镜像：查看和过滤镜像

• 删除容器：清理容器

• 数据卷：清理数据卷