docker image ls
| 说明 | 列出镜像 |
|---|---|
| 用法 | docker image ls [选项] [仓库[:标签]] |
| 别名 | docker image list docker images |
说明
默认的 docker images 命令将显示所有顶级镜像、它们的仓库和标签以及它们的大小。
Docker 镜像具有中间层，可提高可重用性、减少磁盘占用空间，并通过允许缓存每个步骤来加速 docker build。默认情况下不显示这些中间层。
SIZE 是镜像及其所有父镜像占用的累计空间。这也是当你 docker save 镜像时创建的 Tar 文件内容所使用的磁盘空间。
如果一个镜像有多个仓库名称或标签，它将被列出多次。此单一镜像（可通过其匹配的 IMAGE ID 识别）仅占用列出的 SIZE 空间一次。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
-a, --all | 显示所有镜像（默认隐藏中间镜像） | |
--digests | 显示摘要 | |
-f, --filter | 根据提供的条件过滤输出 | |
--format | 使用自定义模板格式化输出 'table'：以表格格式打印输出，带列标题（默认） 'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出 'json'：以 JSON 格式打印 'TEMPLATE'：使用给定的 Go 模板打印输出。 有关使用模板格式化输出的更多信息，请参阅 https://docs.docker.net.cn/go/formatting/ | |
--no-trunc | 不截断输出 | |
-q, --quiet | 只显示镜像 ID | |
--tree | API 1.47+ 实验性功能 (CLI) 将多平台镜像列为树状（实验性功能） |
示例
列出最近创建的镜像
$ 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 命令接受一个可选的 [仓库[:标签]] 参数，该参数将列表限制为与参数匹配的镜像。如果你指定了 仓库 但没有 标签，则 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
[仓库[:标签]] 值必须精确匹配。这意味着，例如，docker images jav 不匹配镜像 java。
如果同时提供了 仓库 和 标签，则仅列出与该仓库和标签匹配的镜像。要查找 java 仓库中标签为 8 的所有本地镜像，可以使用
$ docker images java:8
REPOSITORY TAG IMAGE ID CREATED SIZE
java 8 308e519aac60 6 days ago 824.5 MB
如果没有匹配 仓库[:标签]] 的项，则列表为空。
$ docker images java:0
REPOSITORY TAG IMAGE ID CREATED SIZE
列出完整长度的镜像 ID (--no-trunc)
$ 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
列出镜像摘要 (--digests)
使用 v2 或更高格式的镜像具有一个称为 摘要 的内容可寻址标识符。只要用于生成镜像的输入不变，摘要值就是可预测的。要列出镜像摘要值，请使用 `--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` 命令中按摘要引用，以及在 Dockerfile 中的 `FROM` 镜像引用中按摘要引用。
过滤 (--filter)
过滤标志 (`-f` 或 `--filter`) 的格式为 "key=value"。如果存在多个过滤器，则传递多个标志（例如，`--filter "foo=bar" --filter "bif=baz"`）。
当前支持的过滤器有
- dangling (布尔值 - true 或 false)
- label (`label=
` 或 `label= = `) - before (`<镜像名称>[:<标签>]`、`<镜像 ID>` 或 `<镜像@摘要>`) - 过滤在给定 id 或引用之前创建的镜像
- since (`<镜像名称>[:<标签>]`、`<镜像 ID>` 或 `<镜像@摘要>`) - 过滤在给定 id 或引用之后创建的镜像
- reference (镜像引用的模式) - 过滤引用与指定模式匹配的镜像
显示未标记的镜像 (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
这将显示未标记的镜像，它们是镜像树的叶子（非中间层）。当镜像的新构建移走了镜像 ID 的 `仓库:标签`，使其成为 `
你可以结合 `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
使用多个 reference 过滤会得到，匹配 A 或 B
$ docker images --filter=reference='busy*:uclibc' --filter=reference='busy*:glibc'
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)
格式化选项 (`--format`) 将使用 Go 模板美观地打印容器输出。
下面列出了 Go 模板的有效占位符
| 占位符 | 说明 |
|---|---|
.ID | 镜像 ID |
.Repository | 镜像仓库 |
.Tag | 镜像标签 |
.Digest | 镜像摘要 |
.CreatedSince | 自镜像创建以来的经过时间 |
.CreatedAt | 镜像创建时间 |
.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
要以 JSON 格式列出所有镜像，请使用 `json` 指令
$ docker images --format json
{"Containers":"N/A","CreatedAt":"2021-03-04 03:24:42 +0100 CET","CreatedSince":"5 days ago","Digest":"\u003cnone\u003e","ID":"4dd97cefde62","Repository":"ubuntu","SharedSize":"N/A","Size":"72.9MB","Tag":"latest","UniqueSize":"N/A","VirtualSize":"72.9MB"}
{"Containers":"N/A","CreatedAt":"2021-02-17 22:19:54 +0100 CET","CreatedSince":"2 weeks ago","Digest":"\u003cnone\u003e","ID":"28f6e2705743","Repository":"alpine","SharedSize":"N/A","Size":"5.61MB","Tag":"latest","UniqueSize":"N/A","VirtualSize":"5.613MB"}