docker

Docker镜像删除与系统清理完整指南

全面介绍Docker镜像删除命令、批量清理、强制删除和系统清理的最佳实践。深入解析docker rmi、docker image prune等命令的使用方法，帮助运维人员高效管理Docker镜像和释放磁盘空间。
Mttao
Mttao
@mttao
7 分钟
Docker镜像删除与系统清理完整指南

管理Docker镜像对docker运维人员来说是日常管理工作的一部分。随着docker镜像的增多，它们会占用大量磁盘空间，通过一行命令删除镜像对我们来说很简单，但是作为运维人员还需要理解Docker的底层机制。本文将介绍下docker镜像删除相关的命令及最佳实践，同时介绍下docker镜像结构，帮助大家更加理解docker技术。

docker镜像基础知识

Docker 镜像结构

Docker 镜像并非一个单一的、庞大的文件。它是一个轻量级、独立、可执行的软件包，包含了运行应用程序所需的一切：代码、运行时、系统工具、系统库和设置。 这个包由一系列只读层构成，每一层都代表了镜像 Dockerfile 中的一个特定指令。这种分层架构是Docker高效性的基础，因为层可以在不同镜像之间共享，从而最大限度地减少存储占用并加快构建和拉取速度。

docker镜像识别方式

镜像 ID

  • 唯一标识符，是基于镜像配置和层计算的 SHA256 哈希值
  • 例如：eeae25ada2aa

标签 (Tag)

  • 人类可读的标签，指向镜像 ID
  • 格式：仓库名:标签名，如 ubuntu:22.04 或 nginx:latest
  • 一个镜像 ID 可以有多个标签

摘要 (Digest)

  • 镜像清单文件的 SHA256 哈希值
  • 不可变，保证每次引用的是完全相同的镜像版本

这些标识符之间的区别至关重要。标签是一个可变的指针，而镜像 ID 代表实际的对象。当用户尝试删除一个镜像时，他们通常首先与指针（标签）进行交互。例如，如果一个 ID 为 fd484f19954f 的镜像有两个标签 test1:latest 和 test2:latest，运行 docker rmi test1:latest 并不会删除底层的镜像数据。它只会移除 test1:latest 这个标签。命令的输出会通过显示 Untagged: test1:latest 来反映这一点。镜像层和 ID fd484f19954f 仍然保留在系统上，因为它们仍被 test2:latest 标签引用。只有当指向一个镜像 ID 的最后一个标签被移除时，Docker 才会尝试删除镜像层本身，从而在输出中产生一条 Deleted: sha256:… 的消息。 这种管理引用的概念是 Docker 镜像移除最基本的原则

docker镜像删除命令

主要命令是 docker image rm，简写为 docker rmi。

按标签删除

# 删除单个镜像
docker rmi redis:latest

# 删除多个镜像
docker rmi redis:latest nginx:stable alpine:3.18

按镜像 ID 删除

# 使用短 ID
docker rmi eeae25ada2aa

按摘要删除

docker rmi my-registry/my-repo@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf

docker容器依赖删除问题

常见错误：Error response from daemon: conflict: unable to remove image...: it is being used by one or more containers

这个错误发生是因为 Docker 会保护正在被容器使用的镜像，包括已停止的容器。

解决步骤

  1. 找出依赖的容器
# 查看所有容器
docker ps -a

# 查找特定镜像的容器
docker ps -a --filter "ancestor=nginx:latest"
  1. 停止运行中的容器
docker stop <container_id_or_name>
  1. 删除容器
docker rm <container_id_or_name>
  1. 重新删除镜像
docker rmi <image_name>

docker镜像强制删除

Docker的默认删除流程虽然安全可靠，但在实际使用中，我们有时需要绕过这些保护机制。比如处理多标签镜像或多平台构建时，就需要用到一些高级参数。不过使用这些强制删除功能时，一定要明确了解可能带来的风险。

使用 —force 标志

-f 或 --force 标志可以绕过某些安全检查，但要谨慎使用。

场景 1：删除多标签docker镜像

如果一个镜像 ID（例如 fd484f19954f）被多个标签（test1:latest, test:latest, test2:latest）引用，尝试不带强制标志按其 ID 移除将会导致错误，因为Docker不会移除仍有标签指向的镜像。使用docker rmi -f <IMAGE_ID>可以覆盖这一点。它会强制取消所有相关引用的标签，然后删除镜像层。

# 强制删除有多个标签的镜像
# 这个命令将取消 test1:latest, test:latest, 和 test2:latest 的标签，然后删除镜像 fd484f19954f
docker rmi -f fd484f19954f

场景 2：删除被已停止容器使用的镜像

需要注意一点，docker rmi -f 不能移除一个正在运行中的容器所使用的镜像。然而它可以用来移除一个被已停止的容器所引用的镜像。

当对一个被已停止容器使用的镜像执行 docker rmi -f <image_name> 命令时，表面上看起来操作成功了，镜像也从 docker images 列表中消失了。但实际上，镜像层并没有真正从文件系统中删除。由于已停止的容器依然存在，它对父镜像层的引用关系仍然保留在磁盘上，这就造成了一种”孤立”的容器状态。

用户可能误以为已经释放了磁盘空间，但这些数据实际上仍然占用着存储资源，只有当容器本身通过 docker rm 命令被明确删除后，相关的镜像层才会真正被清理。这种情况可能导致”隐藏”的磁盘占用问题，并且会让系统状态变得难以调试和理解。

建议：最好先删除容器，再删除镜像。

删除多平台镜像

现代应用常需要支持多种CPU架构（如 amd64 和 arm64）。

# 只删除特定平台的镜像
docker image rm --platform=linux/arm64 my-app:latest

使用prune 进行自动化和批量清理

清理悬空镜像

“悬空”镜像是没有标签且未被容器引用的镜像层。

# 清理悬空镜像（会提示确认）
docker image prune

# 跳过确认
docker image prune -f

清理所有未使用镜像

“未使用”镜像是指没有与任何容器关联的镜像。

# 清理所有未使用镜像
docker image prune -a

警告：这会删除所有没有容器关联的镜像，在 CI/CD 环境中可能有破坏性。

系统级清理

docker system prune 是最全面的清理工具。

默认模式

docker system prune

清理内容：

  • 所有已停止的容器
  • 所有未使用的网络
  • 所有悬空镜像
  • 所有构建缓存

激进模式

docker system prune -a

额外清理所有未使用的镜像。

危险模式

docker system prune -a --volumes

极度危险：还会删除所有未使用的卷，可能导致数据丢失。

更多参考资源

如需了解更多关于 Docker prune 命令的详细信息，请参考：Docker Prune 完整指南

最佳实践

docker镜像删除命令对比

命令目标风险级别适用场景
docker image rm IMAGE特定镜像低删除已知不需要的镜像
docker image rm -f IMAGE_ID强制删除镜像中多标签镜像或被停止容器使用的镜像
docker image prune悬空镜像低常规清理，最安全
docker image prune -a所有未使用镜像中开发机器积极清理
docker system prune所有悬空资源中低一般系统清理
docker system prune -a所有未使用资源高谨慎使用
docker system prune -a --volumes包括卷极高几乎不应使用

Docker资源清理最佳实践

对于开发者（本地机器）：

  • 防止累积：对临时或测试容器使用 docker run 的 --rm 标志。这会在容器退出时自动移除容器，防止累积持有镜像引用的已停止容器。

  • 常规清理： 定期运行 docker system prune来清除悬空镜像、构建缓存和已停止的容器。这是保持本地环境整洁的低风险方法。也可以在确认没有重要的已停止容器或未使用的镜像需要保留后，使用docker system prune -a。

对于 CI/CD 和共享环境：

  • 优先考虑数据安全： 切勿在任何自动化脚本或共享环境中使用 docker system prune —volumes。意外数据丢失的风险太高。

  • 使用标签来执行策略： 为您的镜像实施标签策略。为不同阶段（development, staging, production）或状态（keep, archived）指定标签。然后，清理作业可以使用标签过滤器，如 —filter “label!=stage=production” 或 —filter “label!=keep”，来精确移除资源而不触及关键镜像。

  • 实施保留策略： 在计划的清理作业中使用基于时间的过滤器，如 —filter “until=720h”（30 天），来对镜像和其他资源实施滚动保留策略。这可以防止在长期运行的环境中无限期地消耗资源。

总结

  1. 理解依赖关系：先删除容器，再删除镜像
  2. 选择合适命令工具：从精确的 docker image rm 到广泛的 docker system prune
  3. 环境适配：开发环境可以激进，生产环境要保守
  4. 使用过滤器：实现精确控制而不是盲目删除
  5. 建立策略：通过标签和时间过滤器实现自动化清理

/ 标签

#docker #镜像管理 #系统清理 #运维 #容器化

/ 相关文章

更多 →
基于Cinnamon 的 Linux 系统上安装和配置Docker引擎的使用指南
· #docker

基于Cinnamon 的 Linux 系统上安装和配置Docker引擎的使用指南

详细介绍如何在基于 Cinnamon 的 Linux 系统上安装和配置 Docker 引擎，包括 Linux Mint、Ubuntu Cinnamon、Debian 等发行版的完整安装流程、系统准备、官方存储库配置、安装后验证和最佳实践。
Docker容器开机自启动配置完整指南
· #docker

Docker容器开机自启动配置完整指南

详细介绍如何实现Docker容器开机自启动配置，包括Docker服务开机启动设置、容器重启策略详解、各种restart参数使用方法，以及退避机制和最佳实践。适用于Linux、Windows和macOS环境的完整教程。
Docker exec 命令：全面的架构与安全分析
· #docker

Docker exec 命令：全面的架构与安全分析

深入解析Docker exec命令的核心架构、安全机制与最佳实践。从基本用法到高级安全配置，全面掌握容器内进程管理和调试技巧

/ 评论