docker container ls

說明列出容器
用法docker container ls [選項]
別名
docker container list docker container ps docker ps

說明

列出容器

選項

選項預設值說明
-a, --all顯示所有容器（預設僅顯示正在執行的容器）
-f, --filter根據提供的條件篩選輸出
--format使用自訂範本格式化輸出
'table'：以表格格式列印輸出，包含欄位標題（預設）
'table TEMPLATE'：使用指定的 Go 範本以表格格式列印輸出
'json'：以 JSON 格式列印
'TEMPLATE'：使用指定的 Go 範本列印輸出。
參考 https://docker-docs.dev.org.tw/go/formatting/-n, --last		-1顯示最後建立的 n 個容器（包含所有狀態）
-l, --latest顯示最新建立的容器（包含所有狀態）
--no-trunc不要截斷輸出
-q, --quiet僅顯示容器 ID
-s, --size顯示檔案總大小

範例

不要截斷輸出 (--no-trunc)

執行 docker ps --no-trunc 顯示 2 個連結的容器。

$ docker ps --no-trunc

CONTAINER ID                                                     IMAGE                        COMMAND                CREATED              STATUS              PORTS               NAMES
ca5534a51dd04bbcebe9b23ba05f389466cf0c190f1f8f182d7eea92a9671d00 ubuntu:24.04                 bash                   17 seconds ago       Up 16 seconds       3300-3310/tcp       webapp
9ca9747b233100676a48cc7806131586213fa5dab86dd1972d6a8732e3a84a4d crosbymichael/redis:latest   /redis-server --dir    33 minutes ago       Up 33 minutes       6379/tcp            redis,webapp/db

顯示正在執行和已停止的容器 (-a, --all)

docker ps 指令預設僅顯示正在執行的容器。要查看所有容器，請使用 --all（或 -a）旗標

$ docker ps -a

如果可能，`docker ps` 會將暴露的端口分組到一個範圍內。例如，一個暴露 TCP 端口 `100、101、102` 的容器會在 `PORTS` 欄位中顯示 `100-102/tcp`。

顯示容器的磁碟使用量 (--size)

`docker ps --size`（或 `-s`）指令會顯示每個容器的兩種不同的磁碟大小

$ docker ps --size

CONTAINER ID   IMAGE          COMMAND                  CREATED        STATUS       PORTS   NAMES        SIZE
e90b8831a4b8   nginx          "/bin/bash -c 'mkdir "   11 weeks ago   Up 4 hours           my_nginx     35.58 kB (virtual 109.2 MB)
00c6131c5e30   telegraf:1.5   "/entrypoint.sh"         11 weeks ago   Up 11 weeks          my_telegraf  0 B (virtual 209.5 MB)
  • 「大小」資訊顯示每個容器的*可寫入*層所使用的資料量（在磁碟上）
  • 「虛擬大小」是容器使用的唯讀*映像檔*資料和可寫入層所使用的磁碟空間總量。

更多資訊，請參閱容器磁碟大小章節。

過濾 (--filter)

`--filter`（或 `-f`）旗標的格式是一個 `key=value` 鍵值對。如果有多個過濾器，則傳遞多個旗標（例如 `--filter "foo=bar" --filter "bif=baz"`）。

目前支援的過濾器如下：

過濾器說明
id容器的 ID
name容器的名稱
label表示鍵或鍵值對的任意字串。表示為 `<key>` 或 `<key>=<value>`
exited表示容器退出代碼的整數。僅在使用 `--all` 時有效。
status`created`、`restarting`、`running`、`removing`、`paused`、`exited` 或 `dead` 之一
ancestor過濾共用指定映像檔作為祖先的容器。表示為 `<image-name>[:<tag>]`、`<image id>` 或 `<image@digest>`
`before` 或 `since`過濾在指定容器 ID 或名稱之前或之後建立的容器
volume過濾已掛載指定磁碟區或繫結掛載的正在執行的容器。
network過濾連線到指定網路的正在執行的容器。
`publish` 或 `expose`過濾發佈或暴露指定端口的容器。表示為 `<port>[/<proto>]` 或 `<startport-endport>/[<proto>]`
health根據健康檢查狀態過濾容器。 `starting`、`healthy`、`unhealthy` 或 `none` 之一。
isolation僅限 Windows daemon。 `default`、`process` 或 `hyperv` 之一。
is-task過濾作為服務「任務」的容器。布林選項（`true` 或 `false`）

label

`label` 過濾器會根據是否存在 `label` 或 `label` 和值來匹配容器。

以下過濾器會匹配具有 `color` 標籤的容器，不論其值為何。

$ docker ps --filter "label=color"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
673394ef1d4c        busybox             "top"               47 seconds ago      Up 45 seconds                           nostalgic_shockley
d85756f57265        busybox             "top"               52 seconds ago      Up 51 seconds                           high_albattani

以下過濾器會匹配具有 `color` 標籤且值為 `blue` 的容器。

$ docker ps --filter "label=color=blue"

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
d85756f57265        busybox             "top"               About a minute ago   Up About a minute                       high_albattani

name

`name` 過濾器會匹配容器名稱的全部或部分。

以下過濾器會匹配名稱包含 `nostalgic_stallman` 字串的所有容器。

$ docker ps --filter "name=nostalgic_stallman"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9b6247364a03        busybox             "top"               2 minutes ago       Up 2 minutes                            nostalgic_stallman

您也可以過濾名稱中的子字串，如下所示

$ docker ps --filter "name=nostalgic"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox             "top"               3 seconds ago       Up 1 second                             i_am_nostalgic
9b6247364a03        busybox             "top"               7 minutes ago       Up 7 minutes                            nostalgic_stallman
673394ef1d4c        busybox             "top"               38 minutes ago      Up 38 minutes                           nostalgic_shockley

exited

`exited` 過濾器會根據退出狀態碼匹配容器。例如，要過濾已成功退出的容器

$ docker ps -a --filter 'exited=0'

CONTAINER ID        IMAGE             COMMAND                CREATED             STATUS                   PORTS                      NAMES
ea09c3c82f6e        registry:latest   /srv/run.sh            2 weeks ago         Exited (0) 2 weeks ago   127.0.0.1:5000->5000/tcp   desperate_leakey
106ea823fe4e        fedora:latest     /bin/sh -c 'bash -l'   2 weeks ago         Exited (0) 2 weeks ago                              determined_albattani
48ee228c9464        fedora:20         bash                   2 weeks ago         Exited (0) 2 weeks ago                              tender_torvalds

依退出訊號過濾

您可以使用過濾器來找出以狀態碼 `137` 退出的容器，這表示它們被 `SIGKILL(9)` 殺死。

$ docker ps -a --filter 'exited=137'

CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                       PORTS               NAMES
b3e1c0ed5bfe        ubuntu:latest       "sleep 1000"           12 seconds ago      Exited (137) 5 seconds ago                       grave_kowalevski
a2eb5558d669        redis:latest        "/entrypoint.sh redi   2 hours ago         Exited (137) 2 hours ago                         sharp_lalande

以下任何事件都會導致 `137` 狀態碼

  • 容器的 `init` 程序被手動殺死
  • `docker kill` 殺死容器
  • Docker daemon 重新啟動，殺死所有正在執行的容器

status

`status` 過濾器會根據狀態匹配容器。容器狀態的可能值如下：

狀態說明
created從未啟動過的容器。
running正在執行的容器，由 `docker start` 或 `docker run` 啟動。
paused已暫停的容器。請參閱 `docker pause`。
restarting由於容器的指定重新啟動策略而正在啟動的容器。
exited不再執行的容器。例如，容器內的程序已完成，或者使用 `docker stop` 指令停止了容器。
removing正在移除的容器。請參閱 `docker rm`。
dead「失效」的容器；例如，由於外部程序佔用資源而僅部分移除的容器。 `dead` 容器無法（重新）啟動，只能移除。

例如，要過濾 `running` 狀態的容器

$ docker ps --filter status=running

CONTAINER ID        IMAGE                  COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox                "top"               16 minutes ago      Up 16 minutes                           i_am_nostalgic
d5c976d3c462        busybox                "top"               23 minutes ago      Up 23 minutes                           top
9b6247364a03        busybox                "top"               24 minutes ago      Up 24 minutes                           nostalgic_stallman

要過濾 `paused` 狀態的容器

$ docker ps --filter status=paused

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS                      PORTS               NAMES
673394ef1d4c        busybox             "top"               About an hour ago   Up About an hour (Paused)                       nostalgic_shockley

ancestor

`ancestor` 過濾器會根據其映像檔或其後代來匹配容器。此過濾器支援以下映像檔表示方式

  • image
  • image:tag
  • image:tag@digest
  • short-id
  • full-id

如果未指定 `tag`，則使用 `latest` 標籤。例如，要過濾使用最新 `ubuntu` 映像檔的容器

$ docker ps --filter ancestor=ubuntu

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace
5d1e4a540723        ubuntu-c2           "top"               About a minute ago   Up About a minute                       admiring_sammet
82a598284012        ubuntu              "top"               3 minutes ago        Up 3 minutes                            sleepy_bose
bab2a34ba363        ubuntu              "top"               3 minutes ago        Up 3 minutes                            focused_yonath

匹配基於 `ubuntu-c1` 映像檔的容器，在本例中，它是 `ubuntu` 的子項

$ docker ps --filter ancestor=ubuntu-c1

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace

匹配基於 `ubuntu` 版本 `24.04` 映像檔的容器

$ docker ps --filter ancestor=ubuntu:24.04

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:24.04        "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

以下匹配基於層 `d0e008c6cf02` 或在其層堆疊中具有此層的映像檔的容器。

$ docker ps --filter ancestor=d0e008c6cf02

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:24.04        "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

建立時間

before

`before` 過濾器僅顯示在具有指定 ID 或名稱的容器之前建立的容器。例如，建立以下容器

$ docker ps

CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
9c3527ed70ce        busybox     "top"         14 seconds ago       Up 15 seconds                          desperate_dubinsky
4aace5031105        busybox     "top"         48 seconds ago       Up 49 seconds                          focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat

使用 `before` 過濾將得到

$ docker ps -f before=9c3527ed70ce

CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
4aace5031105        busybox     "top"         About a minute ago   Up About a minute                      focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat
since

`since` 過濾器僅顯示自具有指定 ID 或名稱的容器以來建立的容器。例如，使用與 `before` 過濾器相同的容器

$ docker ps -f since=6e63f6ff38b0

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9c3527ed70ce        busybox     "top"         10 minutes ago      Up 10 minutes                           desperate_dubinsky
4aace5031105        busybox     "top"         10 minutes ago      Up 10 minutes                           focused_hamilton

volume

`volume` 過濾器僅顯示掛載特定磁碟區或在特定路徑中掛載磁碟區的容器

$ docker ps --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"

CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

$ docker ps --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"

CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

network

`network` 過濾器僅顯示連線到具有指定名稱或 ID 的網路的容器。

以下過濾器會匹配連線到名稱包含 `net1` 的網路的所有容器。

$ docker run -d --net=net1 --name=test1 ubuntu top
$ docker run -d --net=net2 --name=test2 ubuntu top

$ docker ps --filter network=net1

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

網路過濾器會匹配網路的名稱和 ID。以下範例顯示使用網路 ID 作為過濾器，所有連線到 `net1` 網路的容器

$ docker network inspect --format "{{.ID}}" net1

8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5

$ docker ps --filter network=8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

publish 和 expose

`publish` 和 `expose` 過濾器僅顯示已發佈或暴露具有指定端口號、端口範圍和/或協定的端口的容器。未指定時，預設協定為 `tcp`。

以下過濾器會匹配所有已發佈端口 80 的容器

$ docker run -d --publish=80 busybox top
$ docker run -d --expose=8080 busybox top

$ docker ps -a

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                   NAMES
9833437217a5        busybox             "top"               5 seconds ago       Up 4 seconds        8080/tcp                dreamy_mccarthy
fc7e477723b7        busybox             "top"               50 seconds ago      Up 50 seconds       0.0.0.0:32768->80/tcp   admiring_roentgen

$ docker ps --filter publish=80

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS                   NAMES
fc7e477723b7        busybox             "top"               About a minute ago   Up About a minute   0.0.0.0:32768->80/tcp   admiring_roentgen

以下過濾器會匹配所有已暴露 TCP 端口範圍為 `8000-8080` 的容器

$ docker ps --filter expose=8000-8080/tcp

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9833437217a5        busybox             "top"               21 seconds ago      Up 19 seconds       8080/tcp            dreamy_mccarthy

以下過濾器會匹配所有已暴露 UDP 端口 `80` 的容器

$ docker ps --filter publish=80/udp

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

格式化輸出 (--format)

格式化選項 (--format) 使用 Go 模板來美化容器輸出。

Go 模板的有效佔位符如下所示

佔位符說明
.ID容器 ID
.Image映像檔 ID
.Command引號括起來的命令
.CreatedAt容器建立的時間。
.RunningFor容器啟動後的經過時間。
.Ports公開的埠。
.State容器狀態（例如：「created」、「running」、「exited」）。
.Status容器狀態，包含持續時間和健康狀態的詳細資訊。
.Size容器磁碟大小。
.Names容器名稱。
.Labels指派給容器的所有標籤。
.Label此容器特定標籤的值。例如 '{{.Label "com.docker.swarm.cpu"}}'
.Mounts掛載在此容器中的磁碟區名稱。
.Networks附加到此容器的網路名稱。

使用 --format 選項時，ps 命令將會完全按照模板宣告的方式輸出資料，或者在使用 table 指令時，也會包含欄位標題。

以下範例使用不含標題的模板，並針對所有正在執行的容器輸出以冒號 (:) 分隔的 ID 和 Command 項目

$ docker ps --format "{{.ID}}: {{.Command}}"

a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA
c1d3b0166030: /bin/sh -c yum -y up
41d50ecd2f57: /bin/sh -c #(nop) MA

若要以表格格式列出所有正在執行的容器及其標籤，您可以使用

$ docker ps --format "table {{.ID}}\t{{.Labels}}"

CONTAINER ID        LABELS
a87ecb4f327c        com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd
01946d9d34d8
c1d3b0166030        com.docker.swarm.node=debian,com.docker.swarm.cpu=6
41d50ecd2f57        com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd

若要以 JSON 格式列出所有正在執行的容器，請使用 json 指令

$ docker ps --format json
{"Command":"\"/docker-entrypoint.…\"","CreatedAt":"2021-03-10 00:15:05 +0100 CET","ID":"a762a2b37a1d","Image":"nginx","Labels":"maintainer=NGINX Docker Maintainers \u003cdocker-maint@nginx.com\u003e","LocalVolumes":"0","Mounts":"","Names":"boring_keldysh","Networks":"bridge","Ports":"80/tcp","RunningFor":"4 seconds ago","Size":"0B","State":"running","Status":"Up 3 seconds"}