Docker ps命令

大纲

Docker ps命令概述

docker ps 命令可以用来列出 Docker容器 相关信息。

Docker ps命令语法

haicoder(www.haicoder.net)# docker ps [OPTIONS]

Docker ps命令参数

案例

显示正在运行的容器

使用 docker ps 命令，显示当前正在运行的 docker容器。

haicoder(www.haicoder.net)# docker ps

运行后，终端显示信息如下图所示：

使用 docker run 命令，启动 docker 容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu
#输出
2b7be687c268e9651b70ad2d84ac9487482dea0587c9e50471c8fcdeea848a77

再次使用 docker ps 命令，显示当前正在运行的 docker 容器, 终端显示信息如下图所示：

此时，正在运行的容器列表有刚才运行的容器信息。

显示最近创建的 N 个容器

使用 docker run 命令，启动五个 docker容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu
bfffa738d6d31404af615a18da1883c66e830ac8a4c11a0e93c05123649f1ee0
haicoder(www.haicoder.net)# docker run -it -d ubuntu
075c757f6a04278993a925cd2a1717557a68cd6631008c1445eaa510abf70ad0
haicoder(www.haicoder.net)# docker run -it -d ubuntu
7ab8cab8d002068f97d94a1e315b89844113fd5d47bea94001d1c7c18e3f06a1
haicoder(www.haicoder.net)# docker run -it -d ubuntu
234972c5a5630b1aa53f955ffaa28509cc20cfe5c6f387d1243a0d418a4fd28d
haicoder(www.haicoder.net)# docker run -it -d ubuntu
275dca19d3afd755ad72ccd5666060b828e90a2166954b8623d8887087d992fc

使用 docker ps 命令，显示当前正在运行的 docker 容器, 终端显示信息如下图所示：

使用 docker ps -n 3 命令，显示当前正在运行的 3 个 docker 容器, 终端显示信息如下图所示：

此时，我们看到只显示了最近运行的 3 个 docker 容器，而并非所有的容器。即，在以上案例中，我们使用 docker ps -n 命令，可以显示最近创建的 N 个 docker容器。

最后，我们使用 docker kill 和 docker rm 命令，删除所有的容器。

haicoder(www.haicoder.net)# docker kill `docker ps -qa` && docker rm `docker ps -qa`
275dca19d3af
234972c5a563
7ab8cab8d002
075c757f6a04
bfffa738d6d3
2b7be687c268
275dca19d3af
234972c5a563
7ab8cab8d002
075c757f6a04
bfffa738d6d3
2b7be687c268

显示所有容器

使用 docker run 命令，启动三个 docker容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu                                
1e4956dd7ef8dca2844a94af218a8f3272d2fbc72df9839e6bb0a5dcca598c65
haicoder(www.haicoder.net)# docker run -it -d ubuntu
bc427c7eb2ad3247dd77198516d2eeda93697861775c6faef48511b534499a5c
haicoder(www.haicoder.net)# docker run -it -d ubuntu
790dd6cfd43e8f552687b5fa4465d81fc49d1ca1af37354c7562618a63364ce0

使用 docker ps 命令，显示当前正在运行的 docker容器, 终端显示信息如下图所示：

使用 docker stop 命令，停止其中两个 docker容器。

haicoder(www.haicoder.net)# docker stop 790dd6cfd43e bc427c7eb2ad 
790dd6cfd43e
bc427c7eb2ad

再次使用 docker ps 命令，显示当前正在运行的 docker容器, 终端显示信息如下图所示：

此时，只显示了正在运行的一个 docker 容器，刚被我们停止的两个 docker 容器，并未显示。

我们使用 docker ps -a 命令，显示所有的 docker 容器，包括运行还是未运行的。

此时，显示了我们创建的三个容器，包括一个运行的和两个未运行的。即，在以上案例中，我们使用 docker ps -a 命令，可以显示所有的 docker容器，包括运行的和未运行的。

最后，我们使用 docker kill 和 docker rm 命令，删除所有的容器。

haicoder(www.haicoder.net)# docker kill `docker ps -qa` ;  docker rm `docker ps -qa`

显示所有容器 ID

使用 docker run 命令，启动三个 docker 容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu 
c8c6f11276b77b57a081b50b28a20b84c28de0e3c0baf4d261c6b9eff07d60d7
haicoder(www.haicoder.net)# docker run -it -d ubuntu 
463bbe5457134a51078297f5cb7ccbc1d10c7d1d870169cf0096712d68bed2e7
haicoder(www.haicoder.net)# docker run -it -d ubuntu 
4af5cf8ed40dec5d23b7cbe85274553030a25939f327614e2cb826e644d58c45

使用 docker ps 命令，显示当前正在运行的 docker 容器, 终端显示信息如下图所示：

我们使用 docker ps -aq 命令，显示所有的 docker 容器的 ID 信息，包括运行还是未运行的，终端显示如下：

此时，并未显示容器的所有信息，只显示了容器的 ID 信息，此处的 ID 可以配合 docker kill 和 docker rm 等命令，对容器实现批量的管理。

即，在以上案例中，我们使用 docker ps -aq 命令，可以显示所有的 docker 容器的 ID，包括运行的和未运行的。

最后，我们使用 docker kill 和 docker rm 命令，删除所有的容器。

haicoder(www.haicoder.net)# docker kill `docker ps -qa` ;  docker rm `docker ps -qa`

显示容器 ID 的完整形式

使用 docker run 命令，启动 docker容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu
dfeed15d07dbc8af110c407369b592b366a8501dca900e600467629ab1eeb798

使用 docker ps --no-trunc 命令，显示 docker容器 ID 的完整形式，终端显示信息如下图所示：

此时，返回结果中的 CONTAINER ID 列显示的是容器的完整 ID。即，在以上案例中，我们使用 docker ps --no-trunc 命令，显示 docker容器 ID 的完整形式，而不是缩略形式。

最后，我们使用 docker kill 和 docker rm 命令，删除所有的容器。

haicoder(www.haicoder.net)# docker kill `docker ps -qa` ;  docker rm `docker ps -qa`

显示容器大小

使用 docker run 命令，启动 docker容器。

haicoder(www.haicoder.net)# docker run -it -d ubuntu
379e89ce154a5e1a4821eeac352d36506f971c64f8b416ba571a4a02a7e3b45a

使用 docker ps -s 命令，可以显示 docker 容器的大小信息，终端显示信息如下图所示：

此时，返回结果中多了一列 SIZE，SIZE 有两个值，一个是容器真实增加的大小，一个是整个容器的虚拟大小。容器虚拟大小 = 容器真实增加大小 + 容器镜像大小。

即，在以上案例中，我们使用 docker ps -s 命令，可以显示 docker容器大小信息。

最后，我们使用 docker kill 和 docker rm 命令，删除所有的容器。

haicoder(www.haicoder.net)# docker kill `docker ps -qa` ;  docker rm `docker ps -qa`

docker ps命令高级用法

如果容器数量过多，或者想排除干扰容器，可以通过 docker ps --filter 或 docker ps -f ，过滤需要显示的容器。

docker ps过滤规则

选项后跟的都是键值对 key=value (可不带引号），如果有多个过滤条件，就多次使用 filter 选项。例如：

haicoder(www.haicoder.net)# docker ps --filter id=a1b2c3 --filter name=haicoder

相同条件之间的关系是或，不同条件之间的关系是与关系。例如：

haicoder(www.haicoder.net)# docker ps --filter name=haicoder --filter name=hicoder --filter status=running

以上过滤条件会找出 name 包含 haicoder 或 hicoder 并且 status 为 running 的容器。

id 和 name，支持正则表达式，使用起来非常灵活。例如：

haicoder(www.haicoder.net)# docker ps --filter name=^/haicoder$ 

docker ps格式化显示

如果想自定义显示容器字段，可以用格式化选项 --format ，具体参考 docker 格式化。

结果解析

容器状态

Docker ps命令总结

docker ps 命令可以用来列出容器相关信息。

Docker ps命令语法：

docker ps [OPTIONS]