docker image ls
| 描述 | 列出映象 |
|---|---|
| 用法 | docker image ls [OPTIONS] [REPOSITORY[:TAG]] |
| 別名 | 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.tw/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 命令接受一個可選的 [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 登錄檔或從 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=<key>或label=<key>=<value>) - before (
<映象名>[:<標籤>]、<映象ID>或<image@digest>) - 過濾在給定 ID 或引用之前建立的映象 - since (
<映象名>[:<標籤>]、<映象ID>或<image@digest>) - 過濾在給定 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 中取走 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
使用多個 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"}