配置了专属域名，docker search 报错
本文适用于：
- • Docker 20+ / 24+
- • 配置了专属域名的用户
- • 使用 docker search 命令时遇到报错
- • 需要了解 docker search 与 docker pull 的区别
当您配置了专属域名后，使用 docker search 命令可能会遇到报错。这是因为 docker search 命令的工作机制与镜像拉取不同。
错误示例
docker search mysql
Error response from daemon: Get "https://index.docker.io/v1/search?q=mysql&n=25": dial tcp 103.252.114.101:443: i/o timeout
问题原因
核心原因：docker search 命令只能查询 Docker Hub（官方 registry），它并不会走您配置的第三方镜像源。
docker search 的实现是调用 Docker Hub 的 API，并不使用 daemon.json 里配置的 registry-mirrors。
重要说明：
- • registry-mirrors 只是用来优化镜像拉取（docker pull），不会影响 search
- • 所以您执行 docker search mysql 的时候，永远是请求官方 Docker Hub
- • 如果您要搜索轩辕镜像，必须显式写出轩辕镜像地址
解决方案
解决方案：显式指定轩辕镜像地址搜索
如果您要搜索轩辕镜像，必须显式写出轩辕镜像地址，例如：
docker search docker.xuanyuan.run/mysql
或者
docker search xxx.xuanyuan.run/mysql
（xxx.xuanyuan.run 替换为您的专属域名）
总结：
- ✅ docker search 不支持配置第三方镜像源
- ✅ 只能查 Docker Hub
- ✅ 查您自己的 registry 要显式指定
你可能还会遇到：
本文由「xuanyuan.cloud」维护
专注国内 Docker / 镜像 / Registry 网络问题
内容基于真实用户环境与实测
← 返回常见问题首页📚 问题目录