必须先删除关联容器才能成功删除镜像，因为docker通过引用计数保护被容器（包括已停止或created状态）占用的镜像；直接强制删除（-f）可能导致启动失败、构建缓存异常或ci/cd流程中断。
不能“强制删除被死锁容器占用的镜像”——Docker 里没有“死锁容器”这个概念，只有已停止但未删除的容器，或启动失败残留的临时容器。它们虽不运行，却仍通过 Image 字段引用镜像，导致 docker rmi 拒绝删除。
先确认哪些容器在占用镜像
别猜，用命令直接查：
- 查所有关联该镜像的容器（含 Exited、Created 状态）：
docker ps -a --filter ancestor=IMAGE_NAME_OR_ID --format "{{.ID}} {{.Status}}" - 若镜像 ID 不确定，先查镜像：
docker images | grep KEYWORD或docker images --digests - 补充检查可能被忽略的残留：
docker system df -v查看镜像实际引用关系，比docker ps -a更可靠
清理容器是删除镜像的前提
必须停用并移除所有引用该镜像的容器，否则 rmi 会持续报错 conflict: unable to remove ... because it is being used by container：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 批量停用并删除（谨慎核对 IMAGE_NAME_OR_ID）：
docker ps -a --filter ancestor=IMAGE_ID -q | xargs -r docker stop | xargs -r docker rm - 若某容器反复启动失败、状态异常（如
Created卡住），可强制移除：docker rm -f CONTAINER_ID - 注意：
--rm启动的容器失败后有时会残留元数据，需手动清理
再删镜像：推荐用 ID 或 digest，慎用 -f
清理完容器后，通常 docker rmi IMAGE_ID 就能成功。若仍失败，说明还有隐藏引用（比如构建缓存、其他 compose 项目）：
- 优先用完整镜像 ID 或 digest 删除（最安全）：
docker rmi sha256:abc123...或docker rmi nginx@sha256:... - 仅当确认无任何依赖且接受后续重建成本时，才用
-f：docker rmi -f IMAGE_ID
⚠️ 强制删除后，运行中的容器不会立即崩溃，但docker commit会丢失层复用，docker start可能失败，CI/CD 缓存也会失效
更稳妥的替代方案：用 compose 自动联动清理
如果你是用 docker-compose.yml 启动的服务，直接用：
-
docker compose down --rmi local：停服务 + 删本地构建的镜像（推荐日常维护） -
docker compose down --rmi all：停服务 + 删所有服务用到的镜像（适合环境重置） - 该命令自动跳过被外部容器引用的镜像，不破坏系统稳定性
