Docker镜像仓库搜索Search指令及结果筛选-Docker-PHP中文网

Docker Hub 官方不支持 docker search 的复杂筛选，仅支持 --filter is-official=true 和 is-automated=true 两个基础过滤器，无法按 stars、pulls 或时间排序；推荐使用网页筛选、Docker Hub API 或第三方工具实现精准搜索。

docker镜像仓库搜索search指令及结果筛选

Docker Hub 官方不支持通过 docker search 命令直接进行复杂条件筛选（如按 star 数、官方认证、更新时间等），该命令功能较基础，仅返回关键词匹配的镜像列表及简单元数据。

search 指令的基本用法

执行 docker search 时，Docker CLI 实际向 Docker Hub 的公开 API 发起请求，获取名称或描述中包含关键词的镜像条目。默认最多返回 25 条结果：

docker search nginx —— 搜索含 "nginx" 的镜像
docker search --limit 50 redis —— 最多返回 50 条
docker search --filter is-official=true ubuntu —— 筛选官方镜像（仅支持 is-official 和 is-automated 两个过滤器）

可用的 filter 过滤方式有限

目前 docker search 仅支持两个 --filter 参数，无法按 stars、pulls 或时间排序：

is-official=true：只显示标有 “Official Image” 的镜像（如 ubuntu、nginx）
is-automated=true：只显示启用了自动构建（Automated Build）的镜像（已逐步被 GitHub/GitLab 集成替代，实际使用较少）
注意：--filter stars=100 或 --sort stars 等写法无效，CLI 会忽略或报错

更有效的替代方案

如需精准筛选（比如找 star ≥ 500 的 Redis 镜像，或近 30 天更新的 Python 镜像），推荐以下方式：

直接访问 Docker Hub 网页，利用顶部搜索框 + 左侧筛选栏（Official images / Stars / Last updated）
调用 Docker Hub API 手动查询，例如：
curl "https://www.php.cn/link/641e0c2c35e72adecd8639eb76ebfa18/v2/repositories/search/?page_size=20&q=redis&star_count__gte=500"
使用第三方工具如 docker-hub-cli（支持 stars 排序、关键词高亮等）

搜索结果字段含义说明

终端输出的列分别为：NAME（镜像名）、DESCRIPTION（简短描述）、STARS（点赞数，反映社区认可度）、OFFICIAL（[OK] 表示官方镜像）、AUTOMATED（[OK] 表示自动化构建）。其中 STARS 是重要参考，但注意它不实时同步，且非官方镜像也可有高 star。