切换语言

docker container ls

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

描述

列出容器

选项

选项默认描述
-a, --all显示所有容器（默认只显示运行中的）
-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 命令仅显示正在运行的容器。要查看所有容器，请使用 --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 有用。
statuscreated、restarting、running、removing、paused、exited 或 dead 之一
ancestor筛选共享指定镜像作为祖先的容器。表示为 <image-name>[:<tag>]、<image id> 或 <image@digest>
before or since过滤在给定容器 ID 或名称之前或之后创建的容器
volume过滤已挂载指定卷或绑定挂载的运行中容器。
network筛选连接到指定网络的运行中容器。
publish or expose筛选发布或暴露给定端口的容器。表示为 <port>[/<proto>] 或 <startport-endport>/[<proto>]
health根据容器的健康检查状态过滤容器。取值为 starting、healthy、unhealthy 或 none 之一。
isolation仅限 Windows 守护进程。取值 default、process 或 hyperv 之一。
is-task过滤作为服务“任务”的容器。布尔选项（true 或 false）

标签

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 过滤器匹配容器名称的全部或部分。

以下筛选器匹配所有名称包含字符串 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 过滤器根据退出状态码匹配容器。例如，要筛选已成功退出的容器：

$ 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 守护进程重启会终止所有运行中的容器

状态

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 过滤器根据其镜像或其子镜像来匹配容器。该过滤器支持以下镜像表示形式：

  • 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 过滤器仅显示在具有给定 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 过滤器仅显示自具有给定 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 过滤器仅显示挂载了特定卷或在特定路径挂载了卷的容器：

$ 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 过滤器仅显示连接到具有给定名称或 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 过滤器仅显示具有给定端口号、端口范围和/或协议的已发布或公开端口的容器。未指定时，默认协议为 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 范围内暴露了 TCP 端口的容器：

$ 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"}