切换语言

Docker 容器 ls

描述列出容器
用法docker container ls [OPTIONS]
别名
docker container list docker container ps docker ps

描述

列出容器

选项

选择违约描述
-a, --allShow all containers （default show just running） （默认仅显示正在运行的容器）
-f, --filter根据提供的条件筛选输出
--format使用自定义模板格式化输出：
'table'：以带有列标题的表格格式打印输出（默认）
'table TEMPLATE'：使用给定的 Go 模板
以表格格式打印输出'json'：以 JSON 格式
打印'TEMPLATE'：使用给定的 Go 模板打印输出。
有关使用模板设置输出格式的更多信息，请参阅 https://docs.docker.com/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命令仅显示正在运行的容器。查看全部 containers 中，请使用--all（或-a） 标志：

$ docker ps -a

docker ps如果可能，将公开的端口分组到单个范围内。例如，一个 公开 TCP 端口的容器100, 101, 102显示100-102/tcp在 这PORTS列。

按容器显示磁盘使用情况 （--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)
  • “size” 信息显示用于每个容器的可写层的数据量（在磁盘上）
  • “虚拟大小” 是用于容器和可写层使用的只读镜像数据的磁盘空间总量。

有关更多信息，请参阅磁盘上的容器大小部分。

筛选 （--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 守护程序。其中之一default,process或hyperv.
is-task筛选作为服务“任务”的容器。布尔选项 （true或false)

标签

这labelfilter 根据是否存在label单独或label以及 价值。

以下筛选条件将容器与colorlabel 的 intent 值。

$ 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

以下筛选条件将容器与colorlabel 替换为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

名字

这namefilter 匹配项的全部或部分容器名称。

以下筛选条件匹配名称中包含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

退出

这exitedfilter 按 exist 状态代码匹配容器。例如，到 筛选已成功退出的容器：

$ 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 守护程序重新启动，这将杀死所有正在运行的容器

地位

这statusfilter 按状态匹配容器。容器状态的可能值为：

地位描述
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

祖先

这ancestorfilter 根据容器的镜像或 它。该过滤器支持以下镜像表示形式：

  • 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-c1image 中，在本例中为 child 之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

创建时间

以前

这beforefilter 仅显示在具有 给定的 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
因为

这sincefilter 仅显示自具有给定 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

卷

这volumefilter 仅显示挂载特定卷或 挂载到特定路径中的卷：

$ 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

网络

这networkfilter 仅显示连接到网络的容器 给定名称或 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 上匹配。以下内容 示例显示了附加到net1网络， 使用 网络 ID 作为筛选条件：

$ 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筛选条件仅显示具有给定端口的已发布或公开端口的容器 number、port range 和/或 protocol。默认协议为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

以下筛选条件匹配在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"}