mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-03-10 11:54:37 +00:00
256 lines
6.8 KiB
Go
256 lines
6.8 KiB
Go
# 删除本地镜像
|
||
|
||
## 基本用法
|
||
|
||
使用 `docker image rm` 删除本地镜像：
|
||
|
||
```bash
|
||
$ docker image rm [选项] <镜像1> [<镜像2> ...]
|
||
```
|
||
|
||
> 💡 `docker rmi` 是 `docker image rm` 的简写，两者等效。
|
||
|
||
---
|
||
|
||
## 镜像标识方式
|
||
|
||
删除镜像时，可以使用多种方式指定镜像：
|
||
|
||
| 方式 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| **短 ID** | ID 的前几位（通常 3-4 位） | `docker rmi 501` |
|
||
| **长 ID** | 完整的镜像 ID | `docker rmi 501ad78535f0...` |
|
||
| **镜像名:标签** | 仓库名和标签 | `docker rmi redis:alpine` |
|
||
| **镜像摘要** | 精确的内容摘要 | `docker rmi nginx@sha256:...` |
|
||
|
||
### 使用短 ID 删除
|
||
|
||
```bash
|
||
$ docker image ls
|
||
REPOSITORY TAG IMAGE ID SIZE
|
||
redis alpine 501ad78535f0 30MB
|
||
nginx latest e43d811ce2f4 142MB
|
||
|
||
# 只需输入足够区分的前几位
|
||
$ docker rmi 501
|
||
Untagged: redis:alpine
|
||
Deleted: sha256:501ad78535f0...
|
||
```
|
||
|
||
### 使用镜像名删除
|
||
|
||
```bash
|
||
$ docker rmi redis:alpine
|
||
Untagged: redis:alpine
|
||
Deleted: sha256:501ad78535f0...
|
||
```
|
||
|
||
### 使用摘要删除
|
||
|
||
摘要删除最精确，适用于 CI/CD 场景：
|
||
|
||
```bash
|
||
# 查看镜像摘要
|
||
$ docker images --digests
|
||
REPOSITORY TAG DIGEST IMAGE ID
|
||
nginx latest sha256:b4f0e0bdeb5... e43d811ce2f4
|
||
|
||
# 使用摘要删除
|
||
$ docker rmi nginx@sha256:b4f0e0bdeb578043c1ea6862f0d40cc4afe32a4a582f3be235a3b164422be228
|
||
```
|
||
|
||
---
|
||
|
||
## 理解输出信息
|
||
|
||
删除镜像时会看到两类信息：**Untagged** 和 **Deleted**
|
||
|
||
```bash
|
||
$ docker rmi redis:alpine
|
||
Untagged: redis:alpine
|
||
Untagged: redis@sha256:f1ed3708f538b537eb9c2a7dd50dc90a706f7debd7e1196c9264edeea521a86d
|
||
Deleted: sha256:501ad78535f015d88872e13fa87a828425117e3d28075d0c117932b05bf189b7
|
||
Deleted: sha256:96167737e29ca8e9d74982ef2a0dda76ed7b430da55e321c071f0dbff8c2899b
|
||
Deleted: sha256:32770d1dcf835f192cafd6b9263b7b597a1778a403a109e2cc2ee866f74adf23
|
||
```
|
||
|
||
### Untagged vs Deleted
|
||
|
||
| 操作 | 含义 |
|
||
|------|------|
|
||
| **Untagged** | 移除镜像的标签 |
|
||
| **Deleted** | 删除镜像的存储层 |
|
||
|
||
### 删除流程
|
||
|
||
```
|
||
docker rmi redis:alpine
|
||
│
|
||
▼
|
||
┌───────────────────────────────────────────────────────────────┐
|
||
│ 1. Untag：移除 redis:alpine 标签 │
|
||
│ ↓ │
|
||
│ 2. 检查是否还有其他标签指向这个镜像 │
|
||
│ ├── 有 → 只 Untag，不删除 │
|
||
│ └── 无 → │
|
||
│ ↓ │
|
||
│ 3. 检查是否有容器依赖 │
|
||
│ ├── 有 → 报错，无法删除 │
|
||
│ └── 无 → │
|
||
│ ↓ │
|
||
│ 4. 从上到下逐层删除，检查每层是否被其他镜像使用 │
|
||
│ ├── 被使用 → 保留 │
|
||
│ └── 未使用 → Deleted │
|
||
└───────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 批量删除
|
||
|
||
### 删除所有虚悬镜像
|
||
|
||
虚悬镜像（dangling）：没有标签的镜像，通常是旧版本被新版本覆盖后产生的
|
||
|
||
```bash
|
||
# 查看虚悬镜像
|
||
$ docker images -f dangling=true
|
||
|
||
# 删除虚悬镜像
|
||
$ docker image prune
|
||
|
||
# 不提示确认
|
||
$ docker image prune -f
|
||
```
|
||
|
||
### 删除所有未使用的镜像
|
||
|
||
```bash
|
||
# 删除所有没有被容器使用的镜像
|
||
$ docker image prune -a
|
||
|
||
# 保留最近 24 小时的
|
||
$ docker image prune -a --filter "until=24h"
|
||
```
|
||
|
||
### 按条件删除
|
||
|
||
```bash
|
||
# 删除所有 redis 镜像
|
||
$ docker rmi $(docker images -q redis)
|
||
|
||
# 删除 mongo:8.0 之前的所有镜像
|
||
$ docker rmi $(docker images -q -f before=mongo:8.0)
|
||
|
||
# 删除某个时间之前的镜像
|
||
$ docker image prune -a --filter "until=168h" # 7天前
|
||
```
|
||
|
||
---
|
||
|
||
## 删除失败的常见原因
|
||
|
||
### 原因一：有容器依赖
|
||
|
||
```bash
|
||
$ docker rmi nginx
|
||
Error: conflict: unable to remove repository reference "nginx"
|
||
(must force) - container abc123 is using its referenced image
|
||
```
|
||
|
||
**解决方案**：
|
||
|
||
```bash
|
||
# 方案1：先删除依赖的容器
|
||
$ docker rm abc123
|
||
$ docker rmi nginx
|
||
|
||
# 方案2：强制删除镜像（容器仍可运行，但无法再创建新容器）
|
||
$ docker rmi -f nginx
|
||
```
|
||
|
||
### 原因二：多个标签指向同一镜像
|
||
|
||
```bash
|
||
$ docker images
|
||
REPOSITORY TAG IMAGE ID
|
||
ubuntu 24.04 ca2b0f26964c
|
||
ubuntu latest ca2b0f26964c # 同一个镜像
|
||
|
||
$ docker rmi ubuntu:24.04
|
||
Untagged: ubuntu:24.04
|
||
# 只是移除标签，镜像仍存在（因为还有 ubuntu:latest 指向它）
|
||
```
|
||
|
||
### 原因三：被其他镜像依赖（中间层）
|
||
|
||
```bash
|
||
$ docker rmi some_base_image
|
||
Error: image has dependent child images
|
||
```
|
||
|
||
中间层镜像被其他镜像依赖，无法删除。需要先删除依赖它的镜像。
|
||
|
||
---
|
||
|
||
## 常用过滤条件
|
||
|
||
| 过滤条件 | 说明 | 示例 |
|
||
|---------|------|------|
|
||
| `dangling=true` | 虚悬镜像 | `-f dangling=true` |
|
||
| `before=镜像` | 在某镜像之前 | `-f before=mongo:3.2` |
|
||
| `since=镜像` | 在某镜像之后 | `-f since=mongo:3.2` |
|
||
| `label=key=value` | 按标签过滤 | `-f label=version=1.0` |
|
||
| `reference=pattern` | 按名称模式 | `-f reference='*:latest'` |
|
||
|
||
---
|
||
|
||
## 清理策略
|
||
|
||
### 开发环境
|
||
|
||
```bash
|
||
# 定期清理虚悬镜像
|
||
$ docker image prune -f
|
||
|
||
# 一键清理所有未使用资源
|
||
$ docker system prune -a
|
||
```
|
||
|
||
### CI/CD 环境
|
||
|
||
```bash
|
||
# 只保留最近使用的镜像
|
||
$ docker image prune -a --filter "until=72h" -f
|
||
```
|
||
|
||
### 查看空间占用
|
||
|
||
```bash
|
||
$ docker system df
|
||
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
|
||
Images 15 3 2.5GB 1.8GB (72%)
|
||
Containers 5 2 100MB 80MB (80%)
|
||
Local Volumes 8 2 500MB 400MB (80%)
|
||
Build Cache 0 0 0B 0B
|
||
```
|
||
|
||
---
|
||
|
||
## 本章小结
|
||
|
||
| 操作 | 命令 |
|
||
|------|------|
|
||
| 删除指定镜像 | `docker rmi 镜像名:标签` |
|
||
| 强制删除 | `docker rmi -f 镜像名` |
|
||
| 删除虚悬镜像 | `docker image prune` |
|
||
| 删除未使用镜像 | `docker image prune -a` |
|
||
| 批量删除 | `docker rmi $(docker images -q -f ...)` |
|
||
| 查看空间占用 | `docker system df` |
|
||
|
||
## 延伸阅读
|
||
|
||
- [列出镜像](list.md)：查看和过滤镜像
|
||
- [删除容器](../container/rm.md)：清理容器
|
||
- [数据卷](../data_management/volume.md)：清理数据卷
|