docker 镜像 ls

描述列出图像
用法docker image ls [OPTIONS] [REPOSITORY[:TAG]]
别名
docker image list docker images

描述

默认情况下docker images将显示所有顶级图像、它们的存储库和标签以及它们的大小。

docker buildDocker 镜像具有中间层，可以提高可重用性、减少磁盘使用量，并通过允许缓存每个步骤来加快速度。默认情况下不显示这些中间层。

是SIZE图像及其所有父图像所占用的累积空间。这也是您创建docker save映像时创建的 Tar 文件的内容所使用的磁盘空间。

如果图像具有多个存储库名称或标签，则该图像将被多次列出。该单个图像（可通过其匹配来识别IMAGE ID）仅用完SIZE列出的一次。

选项

选项默认描述
-a, --all显示所有图像（默认隐藏中间图像）
--digests显示摘要
-f, --filter根据提供的条件过滤输出
--format使用自定义模板设置输出格式：
'table'：以带有列标题的表格格式打印输出（默认）
'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出
'json'：以 JSON 格式打印
'TEMPLATE'：打印使用给定的 Go 模板输出。有关使用模板格式化输出的更多信息，
请参阅 https://docker.github.net.cn/go/formatting/
--no-trunc不要截断输出
-q, --quiet仅显示图像 ID

例子

列出最近创建的图像

$ 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，则仅列出与该存储库和标签匹配的图像。要查找java 存储库中带有标签的所有本地图像8，您可以使用：

$ 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 (--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 或更高版本格式的图像具有称为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命令中的摘要进行引用，以及 FROMDockerfile 中的映像引用。

过滤（--filter）

过滤标志（-f或--filter）格式为“key=value”。如果有多个过滤器，则传递多个标志（例如，--filter "foo=bar" --filter "bif=baz"）。

目前支持的过滤器有：

  • 悬空（布尔值 - true 或 false）
  • 标签 (label=<key>或label=<key>=<value>)
  • before ( <image-name>[:<tag>], <image id>or <image@digest>) - 过滤在给定 id 或引用之前创建的图像
  • 因为 ( <image-name>[:<tag>],<image id>或<image@digest>) - 过滤自给定 id 或引用后创建的图像
  • 参考（图像参考的模式） - 过滤参考与指定模式匹配的图像

显示未标记的图像（悬空）

$ 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从映像 ID 中删除、保留其<none>:<none>标记或未标记时，就会出现这些映像。如果在容器当前正在使用图像时尝试删除该图像，则会发出警告。通过使用此标志，它允许批量清理。

您可以将其与以下命令结合使用docker rmi：

$ docker rmi $(docker images -f "dangling=true" -q)

8abc22fbb042
48e5f45168b9
bf747efa0e2f
980fe10e5736
dea752e4e117
511136ea3c5a

如果存在任何正在使用这些未标记映像的容器，Docker 会向您发出警告。

显示带有给定标签的图像

过滤器根据单独的值或值与值label的存在来匹配图像。labellabel

以下过滤器将图像与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"}