docker rm 不支持按镜像版本直接清理，需组合 docker ps、inspect 和 filter 实现：先用 --filter ancestor 精准匹配容器，再 stop + rm；推荐脚本化并加 -v 清理匿名卷。
docker rm 命令本身不支持直接按镜像版本清理容器，它只作用于已停止的容器id或名称。真正实现“针对特定镜像版本的一键清理残留容器”，需要组合使用 docker ps、docker inspect 和 docker rm，并借助 shell 管道与过滤逻辑。
确认目标镜像版本的完整ID或标签
残留容器往往基于某个具体镜像（如 nginx:1.23.3 或 myapp:v2.1.0）启动，但运行后镜像可能已被删除或覆盖。需先查清该版本在本地是否仍存在，以及哪些容器正使用它：
- 运行
docker images | grep "nginx\|myapp"查看可用镜像及其 TAG/IMAGE ID - 若只有 IMAGE ID（如
a1b2c3d4e5f6），后续需用该 ID 匹配容器；若有明确 TAG，优先用 TAG 提高可读性
找出所有基于该镜像版本运行或已停止的容器
Docker 不提供原生命令按镜像筛选容器，但可通过 docker ps -a --format 结合 inspect 提取信息：
- 列出所有容器的镜像名和 ID：
docker ps -a --format "{{.ID}}\t{{.Image}}" - 精确匹配某镜像标签（含版本）的容器 ID：
docker ps -a --filter "ancestor=nginx:1.23.3" -q（推荐，–filter ancestor 支持镜像名+TAG 或 IMAGE ID） - 若需匹配已删除镜像残留的容器（即镜像不存在但容器仍在），则必须用 inspect：
docker ps -aq | xargs -r docker inspect --format='{{.ID}} {{.Image}}' 2>/dev/null | grep "a1b2c3d4e5f6" | awk '{print $1}'
安全执行一键清理（停止 + 删除）
残留容器可能处于运行状态，需先停止再删除。一条可靠命令如下：
- 停止并删除所有匹配 nginx:1.23.3 的容器：
docker stop $(docker ps -q --filter "ancestor=nginx:1.23.3") 2>/dev/null && docker rm $(docker ps -aq --filter "ancestor=nginx:1.23.3") - 更健壮写法（避免空参数报错，兼容无匹配情况）：
docker ps -q --filter "ancestor=nginx:1.23.3" | xargs -r docker stop && docker ps -aq --filter "ancestor=nginx:1.23.3" | xargs -r docker rm - 加
-v参数可同步清理关联的匿名卷（防止磁盘残留）：docker ps -aq --filter "ancestor=nginx:1.23.3" | xargs -r docker rm -v
封装为可复用的清理脚本
将逻辑固化成脚本，提升重复操作效率与安全性：
- 新建文件
clean-by-image.sh，内容示例：
#!/bin/bash<br> IMG="${1:-nginx:latest}"<br> echo "Cleaning containers based on image: $IMG"<br> docker ps -aq --filter "ancestor=$IMG" | xargs -r docker rm -v || echo "No containers found for $IMG" - 赋予执行权限并调用：
chmod +x clean-by-image.sh && ./clean-by-image.sh nginx:1.23.3 - 进阶可增加 dry-run 模式（仅打印将删除的容器ID）、日志记录或交互确认
