docker rmi 命令教程：删除镜像和标签（-f、image prune）

Q: docker rmi 和 docker image rm 是不同的命令吗？

不是。docker rmi、docker image rm 和 docker image remove 是同一条命令的别名。

Q: 镜像被运行中的容器使用时，可以直接删除吗？

通常直接删除会返回 conflict，并指出正在使用该镜像的容器。添加 -f 可以移除镜像的标签；实测中容器仍在运行。

Q: docker image prune 和 docker image prune -a 有什么区别？

不加 -a 只清理 dangling 镜像；加上 -a 则清理所有未被容器使用的镜像。Docker 29 的实测中，默认 prune 回收了 0B，而 -a 删除了未使用的镜像。

Q: 使用 -f 删除容器正在使用的镜像后，还能回收它吗？

docker system df -v 可以看到该镜像以 标签留存；实测中，docker system prune -f 将其删除并回收了 147.6MB。

docker rmi（别名 docker image rm）用于移除镜像标签或未使用的镜像；镜像被容器使用时，通常会遇到 conflict。有关镜像和硬盘空间的清理方法，请参阅清理硬盘空间。

语法

docker rmi [参数] 镜像 [镜像...]
docker image rm [参数] 镜像 [镜像...]

参数

参数	说明
`-f, --force`	强制移除镜像
`--no-prune`	不删除没有标签的父镜像
`--platform 字符串`	只移除指定平台的版本，例如 `linux/amd64`

docker image prune 的参数：

参数	说明
`-a, --all`	移除所有未使用的镜像，而不只是 dangling 镜像
`--filter 条件`	提供筛选条件，例如 `until=<timestamp>`
`-f, --force`	不提示确认

示例

以下示例使用的镜像包括 alpine、demo/app、redis 和 registry。有些标签指向同一个镜像 ID。

移除标签并遇到 conflict

$ docker images
IMAGE                                                                            ID             DISK USAGE   CONTENT SIZE   EXTRA
alpine:3.23                                                                      ff7f0c727dd7       26.6MB         8.21MB        
alpine@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0   85fe1e81d675         13MB         3.94MB        
demo/app:1.0                                                                     ff7f0c727dd7       26.6MB         8.21MB        
demo/app:2.0                                                                     ff7f0c727dd7       26.6MB         8.21MB        
localhost:5000/tools/alpine:3.23                                                 ff7f0c727dd7       26.6MB         8.21MB        
localhost:5000/tools/alpine:latest                                               ff7f0c727dd7       26.6MB         8.21MB        
redis:8-alpine                                                                   0bf6577d7774        161MB         39.6MB   U    
registry:3                                                                       01cd312e6702       86.9MB         20.7MB   U    

$ docker rmi demo/app:1.0
Untagged: demo/app:1.0

$ docker rmi redis:8-alpine
Error response from daemon: conflict: unable to delete redis:8-alpine (must be forced) - container 0663b06bc225 is using its referenced image 0bf6577d7774

移除 demo/app:1.0 后，命令返回 Untagged，因为同一个镜像 ID 还有其他标签。
redis:8-alpine 正被容器使用，直接删除会收到 conflict；错误信息还指出了容器 ID 和镜像 ID。
EXTRA 列中的 U 表示该镜像正在使用中。

使用 `-f` 强制移除标签

$ docker rmi -f redis:8-alpine
Untagged: redis:8-alpine

$ docker ps -a --filter name=uses-redis
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS      NAMES
0663b06bc225   0bf6577d7774   "docker-entrypoint.s…"   3 seconds ago   Up 3 seconds   6379/tcp   uses-redis

$ docker rmi nosuch:image
Error response from daemon: No such image: nosuch:image

-f 成功移除了 redis:8-alpine 标签；接下来列出的容器仍在运行，说明强制移除标签不会停止容器。
删除不存在的镜像名称会返回 No such image。
强制移除后，镜像可能会以 <none> 标签留在本机；可以使用 docker system df -v 查看详细用量。

清理 dangling 镜像和所有未使用的镜像

$ docker image prune -f
Total reclaimed space: 0B

$ docker image prune -a -f
Deleted Images:
untagged: alpine:3.23
untagged: alpine@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
deleted: sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
deleted: sha256:1f3591b8a02ea153f41c5bba878ad477f63ab3d19349762cb77504db02a23e15
deleted: sha256:c3709935ef4cf35769588b317a43fa75b70a7ee51af2d449069ba66e956a0f44
untagged: localhost:5000/tools/alpine:3.23
untagged: localhost:5000/tools/alpine:latest
untagged: demo/app:2.0
deleted: sha256:ff7f0c727dd796aa36787bfcd9a64bf35a6ce72a73451b3359fde849b6703d63
deleted: sha256:3d67941fed5ae436b2bb9791cb3f50a252441c7706bbc5b4e738936df8ff8306
deleted: sha256:74a5b9d36e2dbe5329330986093322eb7619d9d5ebbc916392cf686d0e7381ce
deleted: sha256:8793abc479381bafd16c9d538b01c5a8dd7eef6aa10a737f2ad828ac73cb80e9
deleted: sha256:6d423cc7d2471ec6b5d77eaa820bc0808c1213c56c6fb88ccab237a486ecab64

Total reclaimed space: 26.7MB

$ docker images
IMAGE        ID             DISK USAGE   CONTENT SIZE   EXTRA
registry:3   01cd312e6702       86.9MB         20.7MB   U

不加 -a 的 image prune 只移除 dangling 镜像；本次实测没有可清理项，因此回收了 0B。
加上 -a 后会移除所有未被容器使用的镜像，包括仍带有标签的镜像；仍在使用的 registry:3 会保留。
Docker 29 默认留下的 dangling 镜像较少，因此运行普通的 image prune 时经常会看到没有可回收的空间；要清理所有未使用的镜像，可以使用 -a。

查看 `<none>` 镜像并使用 system prune 清理

$ docker system df -v | head -20
Images space usage:

REPOSITORY   TAG           IMAGE ID       CREATED         SIZE      SHARED SIZE   UNIQUE SIZE   CONTAINERS
myweb        snapshot      56e3f92534ca   7 seconds ago   92.1MB    0B            92.08MB       0
nginx        1.30-alpine   47928bf67eb6   3 days ago      93.5MB    12.94MB       80.6MB        1
registry     3             01cd312e6702   3 days ago      86.9MB    12.94MB       73.93MB       1
<none>       <none>        0bf6577d7774   3 days ago      161MB     12.93MB       147.6MB       0
alpine       3.23          ff7f0c727dd7   3 days ago      13MB      12.93MB       86.86kB       1

Containers space usage:

CONTAINER ID   IMAGE               COMMAND                  LOCAL VOLUMES   SIZE      CREATED          STATUS          NAMES
0c009f73010b   alpine:3.23         "sleep 600"              0               4.1kB     42 seconds ago   Up 41 seconds   small
63b9a2f9c63f   nginx:1.30-alpine   "/docker-entrypoint.…"   0               115kB     44 seconds ago   Up 43 seconds   web
35357aad74b1   registry:3          "/entrypoint.sh /etc…"   1               20.5kB    2 minutes ago    Up 2 minutes    registry

Local Volumes space usage:

VOLUME NAME                                                        LINKS     SIZE
21ea99090ddead0461eb5a6efd670e1d9cf58fe9c23d5f8618db5868fb6170aa   1         3.854MB

$ docker system prune -f
Deleted Images:
untagged: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:16b124a2d3eacd620d917ead6fd26cbf1f1d7117fa94122398971931cfe2d403
deleted: sha256:f79a7876c6644b273e4eec899344e51c66959237a2f71188db8cb98d7311521c

Total reclaimed space: 147.6MB

$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          4         3         272.6MB   92.08MB (33%)
Containers      3         3         139.3kB   0B (0%)
Local Volumes   1         1         3.854MB   0B (0%)
Build Cache     0         0         0B        0B

docker system df -v 显示 <none>:<none> 镜像的 ID 为 0bf6577d7774，没有容器使用它，但它仍占用 161MB，其中 147.6MB 是独占空间。
docker system prune -f 删除了该镜像及其相关数据，回收了 147.6MB；之后 Images 用量从 420.2MB 降至 272.6MB。
system prune 会清理其他未使用的 Docker 数据；如果只想处理镜像，请使用 docker image prune。

动手练习

练习：先尝试移除 redis:8-alpine，再使用 -f 移除它的标签，并确认使用该镜像的 uses-redis 容器仍在运行。

答案

docker rmi redis:8-alpine
docker rmi -f redis:8-alpine
docker ps -a --filter name=uses-redis

常见问题

docker rmi 和 docker image rm 是不同的命令吗？

不是。docker rmi、docker image rm 和 docker image remove 是同一条命令的别名。

镜像被运行中的容器使用时，可以直接删除吗？

通常直接删除会返回 conflict，并指出正在使用该镜像的容器。添加 -f 可以移除镜像的标签；实测中容器仍在运行。

`docker image prune` 和 `docker image prune -a` 有什么区别？

不加 -a 只清理 dangling 镜像；加上 -a 则清理所有未被容器使用的镜像。Docker 29 的实测中，默认 prune 回收了 0B，而 -a 删除了未使用的镜像。

使用 `-f` 删除容器正在使用的镜像后，还能回收它吗？

docker system df -v 可以看到该镜像以 <none> 标签留存；实测中，docker system prune -f 将其删除并回收了 147.6MB。

更新于 2026年10月26日