# docker compose ps

## 描述

* 列出当前 Compose 项目下所有容器 (containers)，显示它们当前的状态和映射的端口。
* 默认只显示正在运行 (running) 的容器。如果加 `--all` 可以把已停止 (stopped) 的容器也显示出来。

示例：

```
$ docker compose ps
NAME            IMAGE     COMMAND           SERVICE    CREATED         STATUS          PORTS
example-foo-1   alpine    "/entrypoint.…"   foo        4 seconds ago   Up 2 seconds    0.0.0.0:8080->80/tcp
```

如果使用 `--all`：

```
$ docker compose ps --all
NAME            IMAGE     COMMAND           SERVICE    CREATED          STATUS         PORTS
example-foo-1   alpine    "/entrypoint.…"   foo        4 seconds ago    Up 2 seconds   0.0.0.0:8080->80/tcp
example-bar-1   alpine    "/entrypoint.…"   bar        4 seconds ago    exited (0)
```

## 选项

`docker compose ps` 支持以下选项：

| 选项            | 描述                                                                                              |
| ------------- | ----------------------------------------------------------------------------------------------- |
| `-a, --all`   | 显示所有容器 (包括停止的容器)。                                                                               |
| `--filter`    | 按属性过滤 (当前只支持 `status` 状态过滤)。                                                                    |
| `--status`    | 只列出某种状态 (status) 的容器。可选值有：`paused`、`restarting`、`removing`、`running`、`dead`、`created`、`exited`。 |
| `--format`    | 自定义输出格式。支持几种模板：`table` (表格，这是默认)、`json`，以及自定义 Go 模板。                                            |
| `--no-trunc`  | 不截断 (truncate) 输出中的字段 (比如名称、命令等较长字段)。                                                           |
| `--orphans`   | 包括 “孤儿服务” 对应的容器 (即不在当前 Compose 项目定义中的服务容器)。默认是 `true`。                                          |
| `-q, --quiet` | 只显示容器 ID (不显示完整表格)。                                                                             |
| `--services`  | 只显示服务名称 (而不是具体容器)。                                                                              |