docker images
docker images
描述
列表图像
用法
docker images [OPTIONS] [REPOSITORY[:TAG]]
备选方案
| 名字，简写 | 默认 | 描述 |
|---|---|---|
| --all, -a | false | 显示所有图像（默认隐藏中间图像） |
| --digests | false | 显示摘要 |
| --filter, -f | | 根据提供的条件过滤输出 |
| --format | | 使用Go模板打印出漂亮的图像 |
| --no-trunc | false | 不要截断输出 |
| --quiet, -q | false | 只显示数字ID |
父命令
| Command | Description |
|---|---|
| docker | The base command for the Docker CLI. |
扩展描述
默认docker images将显示所有顶级图像，它们的存储库和标签，以及它们的大小。
Docker 映像具有中间层，docker build通过允许缓存每个步骤来提高可重用性，减少磁盘使用并加快速度。这些中间层默认不显示。
SIZE是图像及其所有父图像占用的累积空间。这也是您docker save在映像中创建的 Tar 文件内容所使用的磁盘空间。
如果图像具有多个存储库名称或标签，则图像将被多次列出。这张单张图片（通过匹配识别IMAGE ID）SIZE只用了一次。
实例
列出最近创建的图像
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> 77af4d6b9913 19 hours ago 1.089 GB
committ latest b6fa739cedf5 19 hours ago 1.089 GB
<none> <none> 78a85c484f71 19 hours ago 1.089 GB
docker latest 30557a29d5ab 20 hours ago 1.089 GB
<none> <none> 5ed6274db6ce 24 hours ago 1.089 GB
postgres 9 746b819f315e 4 days ago 213.4 MB
postgres 9.3 746b819f315e 4 days ago 213.4 MB
postgres 9.3.5 746b819f315e 4 days ago 213.4 MB
postgres latest 746b819f315e 4 days ago 213.4 MB
按名称和标签列出图像
docker images命令采用可选[REPOSITORY[:TAG]]参数，将列表限制为与参数匹配的图像。如果您指定REPOSITORY但不是TAG，则该docker images命令会列出给定存储库中的所有图像。
例如，要列出“java”存储库中的所有图像，请运行以下命令：
$ docker images java
REPOSITORY TAG IMAGE ID CREATED SIZE
java 8 308e519aac60 6 days ago 824.5 MB
java 7 493d82594c15 3 months ago 656.3 MB
java latest 2711b1d6f3aa 5 months ago 603.9 MB
[REPOSITORY[:TAG]]值必须是“完全匹配”。这意味着，例如，docker images jav与图像不匹配java。
如果提供REPOSITORY和TAG，仅匹配库和标签图像中列出。要在标签为“8”的“java”存储库中查找所有本地图像，可以使用：
$ docker images java:8
REPOSITORY TAG IMAGE ID CREATED SIZE
java 8 308e519aac60 6 days ago 824.5 MB
如果没有匹配REPOSITORY[:TAG]，则列表为空。
$ docker images java:0
REPOSITORY TAG IMAGE ID CREATED SIZE
列出完整的图像 ID
$ docker images --no-trunc
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> sha256:77af4d6b9913e693e8d0b4b294fa62ade6054e6b2f1ffb617ac955dd63fb0182 19 hours ago 1.089 GB
committest latest sha256:b6fa739cedf5ea12a620a439402b6004d057da800f91c7524b5086a5e4749c9f 19 hours ago 1.089 GB
<none> <none> sha256:78a85c484f71509adeaace20e72e941f6bdd2b25b4c75da8693efd9f61a37921 19 hours ago 1.089 GB
docker latest sha256:30557a29d5abc51e5f1d5b472e79b7e296f595abcf19fe6b9199dbbc809c6ff4 20 hours ago 1.089 GB
<none> <none> sha256:0124422dd9f9cf7ef15c0617cda3931ee68346455441d66ab8bdc5b05e9fdce5 20 hours ago 1.089 GB
<none> <none> sha256:18ad6fad340262ac2a636efd98a6d1f0ea775ae3d45240d3418466495a19a81b 22 hours ago 1.082 GB
<none> <none> sha256:f9f1e26352f0a3ba6a0ff68167559f64f3e21ff7ada60366e2d44a04befd1d3a 23 hours ago 1.089 GB
tryout latest sha256:2629d1fa0b81b222fca63371ca16cbf6a0772d07759ff80e8d1369b926940074 23 hours ago 131.5 MB
<none> <none> sha256:5ed6274db6ceb2397844896966ea239290555e74ef307030ebb01ff91b1914df 24 hours ago 1.089 GB
列表图像摘要
使用 v2 或更高版本格式的图像具有称为digest的内容可寻址标识符。只要用于生成图像的输入不变，摘要值就可以预测。要列出图片摘要值，请使用以下--digests标志：
$ docker images --digests
REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE
localhost:5000/test/busybox <none> sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB
当推或拉到2.0注册表时，push或pull命令输出包含图像摘要。您可以pull使用摘要值。您也可以通过引用消化create，run和rmi命令，还有FROM在 Dockerfile 图像参考。
过滤
过滤标志（-f或--filter）格式为“key = value”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）
目前支持的过滤器是：
- dangling（布尔 - true 或 false ）
- 标签（label=<key>或label=<key>=<value>）
- before（<image-name>[:<tag>]，<image id>或<image@digest>） -过滤图像创建之前给定 id 或引用
- 因为（<image-name>[:<tag>]，<image id>或<image@digest>） -给定 id 或引用创建的过滤器的图像
- 参考（图像参考的图案） - 过滤参考与指定图案匹配的图像
显示未加标签的图像（ dangling ）
$ docker images --filter "dangling=true"
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> 8abc22fbb042 4 weeks ago 0 B
<none> <none> 48e5f45168b9 4 weeks ago 2.489 MB
<none> <none> bf747efa0e2f 4 weeks ago 0 B
<none> <none> 980fe10e5736 12 weeks ago 101.4 MB
<none> <none> dea752e4e117 12 weeks ago 101.4 MB
<none> <none> 511136ea3c5a 8 months ago 0 B
这将显示未标记的图像，即图像树的叶子（不是中间层）。这些图像在图像的新版本repo:tag将图像标识从图像标识中移开时保留为<none>:<none>或不标记。如果在容器正在使用时尝试删除图像，则会发出警告。通过拥有这个标志，它可以批量清理。
你可以结合使用这个docker rmi ...：
$ docker rmi $(docker images -f "dangling=true" -q)
8abc22fbb042
48e5f45168b9
bf747efa0e2f
980fe10e5736
dea752e4e117
511136ea3c5a
注：：Docker 发出警告，如果存在使用这些无标记图像的容器。
用给定的标签显示图像
label过滤器匹配基础上的存在的图像label单独或label和值。
以下过滤器将图像与com.example.version标签进行匹配，而不管其值如何。
$ docker images --filter "label=com.example.version"
REPOSITORY TAG IMAGE ID CREATED SIZE
match-me-1 latest eeae25ada2aa About a minute ago 188.3 MB
match-me-2 latest dea752e4e117 About a minute ago 188.3 MB
下面的筛选器将图像与com.example.version标签上带有1.0价值。
$ docker images --filter "label=com.example.version=1.0"
REPOSITORY TAG IMAGE ID CREATED SIZE
match-me latest 511136ea3c5a About a minute ago 188.3 MB
在本例中，使用0.1值时，它返回一个空集，因为没有找到匹配项。
$ docker images --filter "label=com.example.version=0.1"
REPOSITORY TAG IMAGE ID CREATED SIZE
按时间过滤图像
before过滤器仅显示在具有给定 ID 或引用的图像之前创建的图像。例如，拥有这些图像：
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
image1 latest eeae25ada2aa 4 minutes ago 188.3 MB
image2 latest dea752e4e117 9 minutes ago 188.3 MB
image3 latest 511136ea3c5a 25 minutes ago 188.3 MB
过滤用before会：
$ docker images --filter "before=image1"
REPOSITORY TAG IMAGE ID CREATED SIZE
image2 latest dea752e4e117 9 minutes ago 188.3 MB
image3 latest 511136ea3c5a 25 minutes ago 188.3 MB
过滤用since会：
$ docker images --filter "since=image3"
REPOSITORY TAG IMAGE ID CREATED SIZE
image1 latest eeae25ada2aa 4 minutes ago 188.3 MB
image2 latest dea752e4e117 9 minutes ago 188.3 MB
参考滤波图像
reference过滤器仅显示引用与指定模式匹配的图像。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
busybox latest e02e811dd08f 5 weeks ago 1.09 MB
busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB
busybox musl 733eb3059dce 5 weeks ago 1.21 MB
busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
过滤用reference会：
$ docker images --filter=reference='busy*:*libc'
REPOSITORY TAG IMAGE ID CREATED SIZE
busybox uclibc e02e811dd08f 5 weeks ago 1.09 MB
busybox glibc 21c16b6787c6 5 weeks ago 4.19 MB
格式化输出
格式化选项（--format）将使用 Go 模板打印容器输出。
下面列出了 Go 模板的有效占位符：
| Placeholder | Description |
|---|---|
| .ID | Image ID |
| .Repository | Image repository |
| .Tag | Image tag |
| .Digest | Image digest |
| .CreatedSince | Elapsed time since the image was created |
| .CreatedAt | Time when the image was created |
| .Size | Image disk size |
当使用--format选项时，image命令将完全按照模板声明输出数据，或者在使用该table指令时也会包含列标题。
以下示例使用不带标题的模板，并输出由冒号分隔的所有图像ID和Repository条目：
$ docker images --format "{{.ID}}: {{.Repository}}"
77af4d6b9913: <none>
b6fa739cedf5: committ
78a85c484f71: <none>
30557a29d5ab: docker
5ed6274db6ce: <none>
746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres
要以表格格式列出存储库和标签的所有图像，可以使用：
$ docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG
77af4d6b9913 <none> <none>
b6fa739cedf5 committ latest
78a85c484f71 <none> <none>
30557a29d5ab docker latest
5ed6274db6ce <none> <none>
746b819f315e postgres 9
746b819f315e postgres 9.3
746b819f315e postgres 9.3.5
746b819f315e postgres latest
