首页/云/Docker 容器速查/docker rmi 删除本地镜像
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

docker rmi 删除本地镜像

按标签或镜像 ID 删除本地镜像;删除前先确认没有容器(含已停止容器)仍引用目标,被引用的镜像会拒绝删除。

Docker 容器速查云更新于 2026-10-12
用途删除本地镜像
语法docker rmi [选项] 镜像[:标签|ID]
前置检查docker ps -a --filter ancestor=镜像

示例

示例
docker rmi app/web:1.0
docker rmi registry.example.com/team/app/web:1.0 app/web:latest
docker ps -a --filter ancestor=app/web:1.0
只删某个标签时写完整的 仓库:标签;用镜像 ID 删除会摘掉该镜像的全部标签并删除镜像本体。

易错点

  • -f 会连带清理依赖该镜像的中间层,仅在确认无其他引用时使用
  • 镜像还被运行中容器使用时删除会被拒绝,先处理容器引用再删,不要用 -f 掩盖问题

数据来源与参考

  • Docker 官方 CLI 参考:docker rmi(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌