©
本文档使用 PHP中文网手册 发布
列出容器
docker ps [OPTIONS]
名字，简写 | 默认 | 描述 |
|---|---|---|
--all, -a | false | 显示所有容器（默认显示正在运行） |
--filter, -f | 根据提供的条件过滤输出 | |
--format | 漂亮的打印容器使用Go模板 | |
--last, -n | -1 | 显示最后创建的容器（包括所有状态） |
--latest, -l | false | 显示最新创建的容器（包括所有状态） |
--no-trunc | false | 不要截断输出 |
--quiet, -q | false | 只显示数字ID |
--size, -s | false | 显示总文件大小 |
命令 | 描述 |
|---|---|
docker | Docker CLI的基本命令。 |
运行docker ps --no-trunc显示2个链接的容器。
$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 4c01db0b339c ubuntu:12.04 bash 17 seconds ago Up 16 seconds 3300-3310/tcp webapp d7886598dbe2 crosbymichael/redis:latest /redis-server --dir 33 minutes ago Up 33 minutes 6379/tcp redis,webapp/db
docker ps命令仅默认显示正在运行的容器。要查看所有容器，请使用-a（或--all）标志：
$ docker ps -a
docker ps如果可能，将暴露的端口分组到单个范围。例如，100, 101, 102显示TCP端口的容器显示100-102/tcp在PORTS列中。
过滤标志（-f或--filter）格式是一key=value对。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）
目前支持的过滤器是：
过滤 | 描述 |
|---|---|
id | 容器的ID |
name | 容器的名称 |
label | 表示键或键值对的任意字符串 |
existed | 表示容器退出代码的整数。仅适用于--all。 |
status | 一个正在重新开始运行 |
ancestor | 筛选共享给定图像的容器作为祖先。表示为<image-name>：<tag>，<image id>或image @ digest |
before or since | 过滤在给定容器ID或名称之前或之后创建的容器 |
volumn | 过滤运行已安装给定卷或绑定安装的容器。 |
network | 过滤运行连接到给定网络的容器。 |
publish or expose | 过滤发布或公开给定端口的容器。 |
health | 一个健康的|不健康的。根据其健康检查状态过滤容器。 |
isolation | 仅限Windows守护进程。其中一个是 default|process|hyperv。 |
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，restarting，running，removing，paused，exited和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版本12.04.5图像匹配容器：
$ docker ps --filter ancestor=ubuntu:12.04.5CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 82a598284012 ubuntu:12.04.5 "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:12.04.5 "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-volumenetwork过滤器仅显示了连接到网络的具有给定名称或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 test1publish和expose过滤器仅显示已发布或暴露端口与给定的端口号，端口范围，and/or协议的容器。默认协议是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=80CONTAINER 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）使用Go模板漂亮地打印容器输出。
Go模板的有效占位符列在下面：
占位符 | 描述 |
|---|---|
.ID | 容器ID |
.Image | 图像ID |
.Command | 引用的命令 |
.CreatedAt | 容器创建的时间。 |
.RunningFor | 自从容器启动以来的耗时。 |
.Ports | 暴露的端口。 |
.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=641d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd