docker search 默认仅查询 Docker Hub 公共仓库，不支持搜索私有镜像仓库；因私有仓库无标准 search API，需改用 curl 调用 /v2/_catalog、Web UI、专用 CLI 或本地清单文件等方式替代。
默认情况下，docker search 命令只查询 Docker Hub 公共仓库，**不支持直接搜索私有镜像仓库中的镜像**。私有仓库（如 Harbor、Nexus、自建 registry）没有开放全局搜索接口，因此无法通过标准 docker search 限定范围查到私有镜像。
私有仓库本身不提供标准 search API
Docker Registry HTTP API 规范（v2）中，GET /v2/_catalog 是唯一接近“列出镜像”的端点，但它：
- 需手动启用（部分私有仓库默认关闭）
- 不支持关键词模糊搜索，只能分页列出所有仓库名（repository name）
- 不返回 tag、描述、星级等
docker search展示的信息 - 需要认证（Bearer Token 或 Basic Auth）
实际可用的替代方法
要“限定范围查找私有镜像”，需绕过 docker search，改用以下方式：
-
用 curl 调用私有仓库的 catalog 接口：例如
curl -u user:pass https://my-registry.example.com/v2/_catalog?n=100，配合grep过滤名称 - 借助私有仓库自带的 Web UI 搜索：Harbor、Nexus Repository 等均提供图形化搜索框，支持按项目/仓库名/tag/时间等筛选
-
使用仓库提供的 CLI 工具：如 Harbor 官方提供
harbor-cli，支持harbor list --project myproj --filter nginx - 本地维护镜像清单文件：在 CI/CD 或运维流程中，将推送记录写入 JSON/YAML，用脚本查询（适合已知命名规范的场景）
为什么不能加参数让 docker search 查私有库
docker search 是硬编码对接 https://hub.docker.com/api/ 的，不接受自定义 registry 地址或认证信息。即使配置了 daemon.json 中的 insecure-registries 或登录了私有库（docker login my-registry.example.com），docker search 依然不会切换目标。
小结：操作建议
若你管理私有仓库，推荐：
- 开启并保护好
/v2/_catalog端点（Harbor 默认开启，Nexus 需在 Repository → Docker (hosted) 中勾选 “Enable Catalog”） - 统一镜像命名规范（如
my-registry.example.com/proj/app:v1.2），便于用curl + grep快速定位 - 避免依赖
docker search管理私有资产，转向仓库原生能力或内部工具链
