一、基础清理操作

1. 清理停止的容器

bash
# 查看所有容器（包括已停止的）
docker ps -a

# 删除单个停止的容器
docker rm <container_id>

# 批量删除所有停止的容器
docker container prune

2. 清理无用镜像

bash
# 查看所有镜像列表
docker images

# 删除单个镜像
docker rmi <image_id>

# 强制删除镜像（当有容器依赖时）
docker rmi -f <image_id>

# 删除所有悬空镜像（未被任何容器引用的中间层）
docker image prune

# 删除指定仓库的所有标签
docker rmi $(docker images <repository> --format "{{.ID}}")

---

二、进阶清理技巧

1. 按时间过滤清理

bash
# 删除 7 天前的镜像
docker image prune -a --filter "until=168h"

# 删除 30 天前的卷
docker volume prune --filter "until=720h"

2. 精准清理策略

bash
# 删除指定镜像的所有标签
docker rmi $(docker images --filter=reference='<repository>:*' -q)

# 结合 grep 过滤特定镜像
docker images | grep 'nginx' | awk '{print $3}' | xargs docker rmi

# 删除所有未被使用的资源（镜像/容器/网络）
docker system prune

3. 自动清理脚本

bash
#!/bin/bash
# 一键清理脚本（慎用！）

echo "清理停止的容器..."
docker container prune -f

echo "清理无用镜像..."
docker image prune -a -f

echo "清理未使用卷..."
docker volume prune -f

echo "清理网络..."
docker network prune -f

echo "清理完成！"

---

三、安全注意事项

1. 防误删策略

• 确认容器状态：删除前务必检查 docker ps -a
• 标签关联：删除镜像前确保没有运行的容器依赖
• 备份重要数据：清理前导出重要容器数据 docker save
• 使用 --dry-run：通过 docker system prune --dry-run 预览删除内容

2. 关键概念区分

资源类型	生命周期	清理命令
容器	运行时存在，停止后仍保留	docker rm
镜像	由多个层组成，需手动清理	docker rmi
数据卷	持久化存储	docker volume prune
网络	自定义网络需手动管理	docker network prune

3. 高级场景处理

镜像依赖冲突

当出现 Error response from daemon: conflict 错误时：

bash
# 查找依赖该镜像的容器
docker ps -a --filter "ancestor=<image_id>"

# 先删除相关容器
docker rm <container_id>

分层缓存清理

Docker 镜像由多层构成，可通过以下命令优化：

bash
# 删除所有中间层镜像
docker builder prune

---

四、最佳实践建议

1. 开发环境：使用 --rm 参数自动清理临时容器

   bash
   docker run --rm -it ubuntu /bin/bash
   

2. 生产环境：

   • 为关键镜像打版本标签
   • 设置定期清理任务（cron job）
   • 使用镜像仓库管理长期存储

3. 监控磁盘使用：

   bash
   docker system df  # 查看 Docker 磁盘使用情况
   

---

五、实战案例

假设我要删除第一项服务。以下是删除镜像 henrygd/beszel-agent:latest 的详细实战步骤，包含安全验证和容错机制

---

步骤 1：检查是否有容器依赖此镜像

bash
# 列出所有容器（包括已停止的），过滤出使用该镜像的实例
docker ps -a --filter "ancestor=henrygd/beszel-agent:latest"

可能的输出结果：

• 情况一（无容器依赖）：

  CONTAINER ID   IMAGE                          COMMAND   CREATED   STATUS    PORTS     NAMES
  

  解释：没有容器使用此镜像，可直接删除。

• 情况二（存在容器依赖）：

  CONTAINER ID   IMAGE                          COMMAND   CREATED    STATUS      PORTS     NAMES
  a1b2c3d4e5f6   henrygd/beszel-agent:latest    ...      5 days ago Exited (0)  2 days ago   web-server
  

  解读：有容器依赖，需先处理容器。

---

步骤 2：处理依赖容器

如果存在依赖容器（情况二）：

bash
# 停止容器（如果容器仍在运行）
docker stop a1b2c3d4e5f6

# 删除容器（替换为实际的 CONTAINER ID）
docker rm a1b2c3d4e5f6

批量删除所有关联容器（更高效）：

bash
# 通过镜像名直接删除所有关联容器（慎用！确保无重要数据）
docker rm $(docker ps -aq --filter "ancestor=henrygd/beszel-agent:latest")

---

步骤 3：删除镜像

bash
# 执行删除命令
docker rmi henrygd/beszel-agent:latest

成功输出：

Untagged: henrygd/beszel-agent:latest
Deleted: sha256:25c207be20b7...

若报错 Error response from daemon: conflict：

• 原因：仍有容器依赖（即使已停止）
• 解决方案：强制删除镜像（⚠️ 确保无重要容器！）

  bash
  docker rmi -f henrygd/beszel-agent:latest
  

---

步骤 4：验证删除结果

bash
# 再次查看镜像列表
docker images | grep "henrygd/beszel-agent"

# 预期输出：无相关镜像记录

---

完整操作流程示例

bash
# 1. 检查容器依赖
$ docker ps -a --filter "ancestor=henrygd/beszel-agent:latest"
CONTAINER ID   IMAGE                          COMMAND   CREATED    STATUS      PORTS     NAMES
a1b2c3d4e5f6   henrygd/beszel-agent:latest    ...      5 days ago Exited (0)  2 days ago   web-server

# 2. 删除关联容器
$ docker rm a1b2c3d4e5f6
a1b2c3d4e5f6

# 3. 删除镜像
$ docker rmi henrygd/beszel-agent:latest
Untagged: henrygd/beszel-agent:latest
Deleted: sha256:25c207be20b7...

# 4. 验证删除
$ docker images | grep "henrygd/beszel-agent"
# 无输出

---

关键注意事项

1. 数据安全：

   • 如果镜像关联数据库或存储卷，删除前请确认数据已备份或迁移。
   • 使用 docker inspect <container> 检查容器挂载的卷（Mounts 字段）。

2. 镜像别名冲突：
   如果同一镜像有多个标签（如 dev/prod），需删除所有标签：

   bash
   docker rmi $(docker images --filter=reference='henrygd/beszel-agent:*' -q)
   

3. 强制删除场景：
   当容器处于 Exited 状态但无法删除时，使用：

   bash
   docker container prune --filter "until=72h"  # 清理72小时前的停止容器
   

---

六、实战问题补充

如果遇到这种情况，理论上不大可能，但是也会有可能遇到。

核心概念解释

1. 什么是悬空镜像（Dangling Image）？

• 定义：没有关联任何仓库名（Repository）和标签（Tag）的镜像。
• 表现形式：在 docker images 输出中显示为 <none>:<none>。
• 产生原因：
  • 重复构建镜像：使用相同标签（如 latest）多次构建镜像，旧镜像会被覆盖标签，变成无主状态。
  • 手动删除标签：删除某个标签后，原镜像失去引用。

2. 为什么用 dangling=true？

• 作用：这是 Docker 的过滤器语法，用于精准筛选出悬空镜像。
• 技术原理：
  Docker 会为每个镜像层生成唯一标识（IMAGE ID）。当镜像的标签被删除或覆盖时，该镜像层不再被任何标签引用，此时 Docker 会将其标记为 dangling（悬空状态）。

---

通俗比喻

• 悬空镜像：就像你手机里一张照片被删除后，相册里留下的“空白占位图”，它不再有名字，也没人引用，但占据存储空间。
• dangling=true：相当于用过滤器快速找到这些“空白占位图”，方便你一键清理。

实战问题解决

从实战输出可以看到，原本的镜像 henrygd/beszel-agent:latest 已经变成 <none>:<none>，这说明它已经成为 悬空镜像（Dangling Image）。这种情况通常发生在以下场景：

• 同一镜像被重复构建并覆盖标签（例如多次执行 docker build -t henrygd/beszel-agent:latest .）
• 镜像被其他标签引用后，原标签被移除

以下是针对悬空镜像的 完整清理方案：

步骤 1：确认镜像状态

bash
# 查看所有悬空镜像（无仓库名和标签）
docker images -f "dangling=true"

# 输出示例：
REPOSITORY          TAG                 IMAGE ID       CREATED         SIZE
<none>              <none>              25c207be20b7   9 days ago      7.85MB

---

步骤 2：删除单个悬空镜像

bash
# 通过 IMAGE ID 直接删除
docker rmi 25c207be20b7

可能遇到的错误：

• 错误提示：Error response from daemon: conflict: unable to delete 25c207be20b7 (must be forced) - image is referenced in multiple repositories
  • 原因：该镜像被多个仓库引用（例如被其他标签或别名关联）
  • 解决方案：强制删除（⚠️ 确保无重要容器依赖！）

    bash
    docker rmi -f 25c207be20b7
    

---

步骤 3：批量删除所有悬空镜像

bash
# 删除所有悬空镜像（推荐）
docker image prune

# 输入 y 确认删除
# 输出示例：
Deleted Images:
deleted: sha256:25c207be20b7...
Total deleted: 7.85MB

---

步骤 4：深度清理（含中间层缓存）

如果上述操作后仍有残留，使用以下命令清理 所有未被使用的镜像层：

bash
# 删除所有未被容器或新镜像引用的镜像层
docker builder prune --all

# 或者结合强制删除
docker system prune -a --volumes

---

关键原理说明

概念	说明
悬空镜像	被其他镜像覆盖标签后遗留的中间层镜像，无实际仓库名和标签
中间层镜像	Docker 镜像由多层文件系统组成，构建新镜像时会生成新的中间层
镜像引用关系	一个镜像可能被多个标签或容器引用，只有所有引用解除后才能彻底删除

---

完整操作示例

bash
# 1. 查看悬空镜像
$ docker images -f "dangling=true"
REPOSITORY          TAG                 IMAGE ID       CREATED         SIZE
<none>              <none>              25c207be20b7   9 days ago      7.85MB

# 2. 删除单个悬空镜像
$ docker rmi 25c207be20b7
Error response from daemon: conflict: unable to delete 25c207be20b7 (must be forced) - image is referenced in multiple repositories

# 3. 强制删除（如果普通删除失败）
$ docker rmi -f 25c207be20b7
Untagged: 25c207be20b7...

# 4. 批量清理验证
$ docker image prune
Deleted Images:
deleted: sha256:25c207be20b7...
Total deleted: 7.85MB

---

预防悬空镜像的建议

1. 避免重复覆盖标签：
   为不同版本的镜像使用唯一标签（例如 v1.0、v1.1），不要重复使用 latest

   bash
   docker build -t henrygd/beszel-agent:v1.0 .
   

2. 定期清理：
   将以下命令加入定时任务（cron）：

   bash
   # 每天凌晨清理悬空镜像
   0 3 * * * docker image prune -f
   

3. 使用镜像管理工具：
   推荐使用 dive 工具分析镜像层：

   bash
   dive henrygd/beszel-agent:latest
   

---

七、还有问题，彻底解决

有时候你跟着步骤做的操作步骤是对的。但还是删除镜像 25c207be20b7失败。

失败的原因是：该镜像被一个名为 ba698fd40eb0 的容器引用，但该容器可能已被删除或处于异常状态。以下是具体原因和解决方案：

---

根本原因

1. 容器与镜像的依赖关系
   镜像 25c207be20b7 被容器 ba698fd40eb0 使用，但：

   • 你尝试停止容器时误用了 镜像ID（25c207be20b7）作为容器ID，导致操作失败。
   • 实际容器ID是 ba698fd40eb0，需要针对该容器操作。

2. 镜像被中间层引用
   该镜像可能是其他镜像的构建中间层，即使没有显式容器依赖，也可能被 Docker 内部引用。

---

解决方案

1. 精准删除关联容器

bash
# 1. 查找使用该镜像的容器（包括已停止的）
docker ps -a --filter "ancestor=25c207be20b7"

# 2. 删除关联容器（替换为实际的 CONTAINER ID）
docker rm -f ba698fd40eb0  # 强制删除容器（即使已停止）

# 3. 再次删除镜像
docker rmi 25c207be20b7

2. 强制清理悬空镜像（绕过依赖）

如果确认无重要容器依赖，可直接清理所有悬空镜像：

bash
# 1. 批量删除所有悬空镜像
docker image prune -f

# 2. 深度清理（含中间层缓存）
docker builder prune --all

3. 检查镜像引用链

如果仍报错，检查镜像是否被其他标签或构建缓存引用：

bash
# 查看镜像的引用关系
docker image inspect 25c207be20b7 --format='{{.RootFS.DiffIDs}}'

# 清理所有未被引用的镜像层
docker system prune -a --volumes

---

操作验证

bash
# 1. 确认容器已删除
docker ps -a | grep "ba698fd40eb0"

# 2. 确认镜像已删除
docker images | grep "25c207be20b7"

---

八、总结：

清理 Docker 镜像和容器的核心命令与注意事项

1. 停容器：docker container prune（批量删停止的容器）；
2. 删镜像：docker image prune（删悬空镜像），docker rmi <image_id>（指定镜像）；
3. 悬空镜像：用 dangling=true 过滤，普通删除或强制 docker rmi -f；
4. 安全提示：删前检查依赖（docker ps -a），避免强制误删，生产环境慎用 docker system prune。
5. 容器ID ≠ 镜像ID：操作时需严格区分两者。
6. 强制删除风险：-f 参数会跳过依赖检查，确保无重要数据后再使用。
7. 中间层缓存：Docker 构建过程中生成的中间层镜像可能长期残留，需定期清理。