docker search 命令用于在 Docker Hub 中搜索公开镜像但不下载,支持 --limit、--filter 等选项筛选结果,输出含 NAME、DESCRIPTION、STARS、OFFICIAL、AUTOMATED 五列信息,且不支持私有仓库搜索。

Docker 的 search 命令用于在 Docker Hub(默认仓库)中查找公开可用的镜像,它不下载镜像,只列出匹配结果。
基本用法:搜索关键词
直接运行 docker search 加上镜像名称关键词即可:
-
docker search nginx—— 查找包含 “nginx” 的所有公开镜像 -
docker search redis—— 查找 Redis 相关镜像
常用选项控制输出
添加参数可筛选和优化结果展示:
-
--limit N:限制返回条数,例如docker search --limit 5 ubuntu -
--filter is-official=true:只显示官方认证镜像(带 ✅ 标识),如docker search --filter is-official=true python -
--filter stars=100:只显示星标数 ≥100 的镜像,例如docker search --filter stars=50 mysql
识别可信镜像的关键信息
搜索结果每行包含五列:NAME、DESCRIPTION、STARS、OFFICIAL、AUTOMATED:
-
OFFICIAL 为 [OK] 表示是 Docker 官方维护的镜像(如
nginx、httpd) - STARS 数值越高,通常代表社区使用越广泛、更新越活跃
- AUTOMATED 为 [OK] 表示该镜像由 Dockerfile 自动构建,源码透明可追溯
注意:search 不支持私有仓库或自建 Registry
docker search 默认只查询 Docker Hub。若要搜索私有仓库(如公司内网 registry),需先登录并使用对应仓库的 Web 界面或 API,命令行不支持。


















