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.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 命令接受一個可選的 [倉庫[:標籤]] 引數，該引數將列表限制為與引數匹配的映象。如果你指定了 倉庫 但沒有 標籤，則 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"}