首页/云/Docker 容器速查/docker ps --filter 筛选容器
基础命令50 条

docker ps --filter 筛选容器

按状态、退出码、名称、标签、镜像等维度过滤容器列表,退出码 137 过滤能快速找出被强杀或 OOM 的实例。

Docker 容器速查云更新于 2026-10-12
常用键status=exited / exited=137 / name=web / label=env=prod
其他键ancestor=nginx:1.27 / health=unhealthy / volume=myvol / network=frontend
时间类before= 与 since= 按创建时间过滤

示例

示例
docker ps -a --filter status=exited
docker ps -a --filter exited=137 --format '{{.Names}} {{.Image}}'
docker ps --filter ancestor=nginx:1.27-alpine --format '{{.Names}}'
exited 过滤支持非 0 退出码;137 通常是强杀或 OOM,结合 docker inspect 的 OOMKilled 字段确认。

易错点

  • name= 是子串匹配,名字相近的容器会一起命中,需要精确匹配时用 --format 或 grep -w 再核对
  • 多个 --filter 叠加的语义同类键与异类键不同,复杂组合先小范围试跑确认结果

数据来源与参考

  • Docker 官方 CLI 参考:docker ps --filter(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌