如何编写批量删除无用镜像

wen 实用脚本 2026-06-26 32

高效清理Docker环境：如何编写批量删除无用镜像的完整指南

目录导读

为什么需要批量删除无用镜像
基础命令回顾：删除单个镜像的正确姿势
批量删除的四种核心方案
- 1 按名称或标签匹配删除
- 2 删除所有未被容器使用的镜像（dangling镜像）
- 3 删除特定仓库或命名空间下的所有镜像
- 4 基于时间或大小条件过滤删除
实战脚本编写：从命令行到自动化脚本
常见问题与问答（FAQ）
安全注意事项与最佳实践

为什么需要批量删除无用镜像

在使用Docker一段时间后，本地磁盘会堆积大量无用的镜像文件，这些镜像可能来自：

如何编写批量删除无用镜像

拉取测试的临时镜像
构建过程中产生的中间层镜像
长时间未使用的旧版本镜像
容器被删除后留下的悬空镜像（<none>:<none>）

根据我在多个生产环境中的经验，这些无用镜像可以轻易占用20-60GB甚至更多的磁盘空间，手动执行docker rmi逐个删除不仅效率极低，而且容易误删正在使用的镜像，掌握批量删除的脚本编写方法,是每个运维工程师和开发者必须掌握的技能。

基础命令回顾：删除单个镜像的正确姿势

在编写批量脚本之前,先理解基础命令的工作原理：

# 通过镜像ID删除
docker rmi 镜像ID
# 通过镜像名称:标签删除
docker rmi nginx:1.21
# 强制删除（即使有容器引用，慎用）
docker rmi -f 镜像ID

注意事项：

如果镜像正在被容器使用（即使是已停止的容器），直接删除会报错。
删除镜像不会自动删除对应的容器，必须先删除容器或使用-f强制。

批量删除的四种核心方案

1 按名称或标签匹配删除

假设你想删除所有包含test-前缀的测试镜像：

# 方案1：使用grep过滤
docker images | grep "test-" | awk '{print $3}' | xargs docker rmi
# 方案2：使用docker image ls结合--filter
docker image ls --filter "reference=test-*" -q | xargs docker rmi

推荐方案2，因为--filter是Docker原生支持,更稳定且不易误匹配。

2 删除所有未被容器使用的镜像（dangling镜像）

这是最常用且安全的批量删除方式：

# 删除所有悬空镜像（仓库和标签均为<none>）
docker image prune -f
# 删除所有未被容器使用的镜像（包括非悬空镜像）
docker image prune -a -f

-a参数会删除所有未被任何容器（包括已停止的）引用的镜像。请谨慎使用,可能导致需要重新拉取某些镜像。

3 删除特定仓库或命名空间下的所有镜像

如果你的镜像统一存放在某个仓库（例如registry.example.com/dev）,可以使用以下方法：

# 使用grep匹配仓库名
docker images | grep "registry.example.com/dev" | awk '{print $1":"$2}' | xargs docker rmi
# 更推荐的写法（避免误删）
docker image ls --format "{{.Repository}}:{{.Tag}}" | grep "^registry.example.com/dev" | xargs docker rmi

4 基于时间或大小条件过滤删除

更高级的场景：删除创建时间超过30天,或大小大于1GB的镜像。

# 删除所有30天前创建的镜像（依赖镜像创建时间戳，需谨慎）
docker images --format "{{.ID}} {{.CreatedAt}}" | awk '$2 < "2024-01-01" {print $1}' | xargs docker rmi
# 更可靠的方式：通过镜像的标签或仓库配合日期字段（推荐自行编写Python脚本）

实战脚本编写：从命令行到自动化脚本

以下是一个工业级可用的批量删除脚本示例（保存为clean-docker-images.sh）：

#!/bin/bash
# 配置区域
EXCLUDE_PATTERNS=("nginx:latest" "redis:7")  # 保留的镜像模式
DRY_RUN=true                                 # 设置为false则真正执行删除
# 获取所有镜像ID和名称
mapfile -t image_info < <(docker images --format "{{.ID}} {{.Repository}}:{{.Tag}}" | grep -v "<none>")
# 逐一检查并过滤需要保留的镜像
to_delete=()
for line in "${image_info[@]}"; do
    id=$(echo $line | awk '{print $1}')
    name=$(echo $line | awk '{print $2}')
    # 检查是否在排除列表中
    skip=false
    for pattern in "${EXCLUDE_PATTERNS[@]}"; do
        if [[ $name == $pattern ]]; then
            skip=true
            break
        fi
    done
    if [[ $skip == false ]]; then
        to_delete+=("$id")
    fi
done
# 执行删除
if [[ ${#to_delete[@]} -eq 0 ]]; then
    echo "没有需要删除的镜像"
    exit 0
fi
if [[ $DRY_RUN == true ]]; then
    echo "预演模式（DRY_RUN），以下镜像将被删除："
    printf '%s\n' "${to_delete[@]}"
    echo "总共 ${#to_delete[@]} 个镜像"
else
    echo "正在批量删除 ${#to_delete[@]} 个镜像..."
    docker rmi "${to_delete[@]}" 2>&1 | grep -v "Error"
    echo "删除完成"
fi

使用方法：

修改EXCLUDE_PATTERNS数组，添加你希望保留的镜像（如生产环境的核心服务）。
DRY_RUN=true时仅打印待删除列表而不实际执行，确认无误后改为DRY_RUN=false。
设置定时任务（crontab）每周执行一次：0 3 * * 0 /path/to/clean-docker-images.sh

常见问题与问答（FAQ）

Q1：批量删除时出现“image is being used by”错误怎么办？
A：表示有容器正在引用该镜像，解决方案：

先删除关联容器：docker rm $(docker ps -a -q --filter "ancestor=镜像名")
然后删除镜像，如果容器不重要，可直接使用docker rmi -f强制删除。

Q2：删除后磁盘空间未释放，原因是什么？
A：常见原因包括：

镜像文件被存储层复用（如overlay2驱动），需要docker system df查看真正的空间占用。
存在Docker的build缓存（docker builder prune -f可清理）。
日志文件或其他文件占用了空间。

Q3：如何确认某个镜像是否被任何容器使用？
A：使用docker ps -a --filter "ancestor=镜像名"查看关联容器；或者docker image inspect 镜像ID查看Containers字段。

Q4：有没有更安全的删除方式？
A：推荐分两步走：

使用docker image prune -a的交互模式（不加-f），确认每一条。
删除前备份镜像列表：docker images > images_backup.txt,以便必要时恢复。

安全注意事项与最佳实践

注意事项	说明
避免在生产环境直接运行未测试脚本	永远先在测试环境中执行`DRY_RUN=true`的脚本
设置正则白名单	例如保留`nginx:latest`、`redis:7`等关键镜像
搭配日志记录	在脚本中加入日志输出，记录删除的镜像ID和名称
考虑存储驱动影响	某些存储驱动（如devicemapper）中镜像层被共享，删除后可能仍有缓存
定期执行	设置cron任务每月或每周执行一次，避免磁盘占满

最佳实践总结：

优先使用Docker内建的docker image prune命令。
自定义脚本时永远提供DRY_RUN模式。
维护一个“保留镜像白名单”列表。
结合docker system df监控清理效果。

通过以上方案，你可以高效且安全地管理Docker镜像，避免磁盘空间的浪费，掌握批量删除脚本的编写，不仅能提升工作效率,也是Docker进阶的重要技能。