docker search 仅查询 docker hub 公共镜像,不查本地;基础语法为 docker search 关键词,支持 --limit、--no-trunc 和 --filter(如 is-official=true、stars=50)等参数精准筛选,结果按星级和官方标识排序,但搜到的是仓库名而非具体标签。
直接用 docker search 就能在命令行快速查找 docker hub 上的公共镜像,它不查本地镜像,只连 docker hub 的索引服务做关键词匹配。
基础搜索:输入关键词即可
语法最简:后面跟一个词,比如镜像名或功能关键词。
-
docker search nginx—— 查所有含 “nginx” 的仓库名 -
docker search python—— 查 Python 相关的基础镜像、发行版、框架封装等 -
docker search postgres—— 查 PostgreSQL 官方或社区维护的镜像
默认返回 25 条,按星级(STARS)和是否官方(OFFICIAL)综合排序。带 ✅ 的 OFFICIAL 表示 Docker 官方维护,稳定性与更新保障更高,优先考虑。
控制结果数量和完整性
避免信息刷屏或描述被截断,常用两个参数:
-
--limit N:限制最多显示 N 条,例如docker search --limit 10 redis -
--no-trunc:显示完整 DESCRIPTION,不省略后半段,适合看清楚用途或适用场景,例如docker search --no-trunc alpine
用 --filter 精准筛选
这个选项能帮你跳过低星、非官方或非自动构建的镜像,提升效率。
-
--filter is-official=true:只看官方镜像,如docker search --filter is-official=true node -
--filter stars=50:只显示星级 ≥ 50 的,例如docker search --filter stars=50 ubuntu -
--filter is-automated=true:只显示 GitHub 触发自动构建的镜像(部分社区维护项目使用)
多个 filter 可叠加,用空格分隔,比如:docker search --filter is-official=true --filter stars=100 httpd
注意:搜的是仓库名,不是标签
docker search 找到的是镜像仓库(如 python、nginx),不是具体版本(如 python:3.11-slim 或 nginx:1.25-alpine)。拉取时必须指定 tag,否则默认是 :latest,可能不稳定。
建议搜索后打开对应镜像的 Docker Hub 页面(如 https://www.php.cn/link/61ff912aec1b33f9ac603a67fb18fd94),查看支持的 tags、文档说明和构建时间。
私有 Registry(如 Harbor、quay.io)不支持 docker search,需用其 Web 界面或专用 CLI 工具。











