让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
配置了专属域名后，docker search 为什么会报错？
本文适用于：
- • Docker 20+ / 24+
- • 配置了专属域名的用户
- • 使用 docker search 命令时遇到报错或超时
- • 需要查找镜像名称、标签，但不确定该用哪种方式
配置了专属域名后，docker search 仍可能报错或超时。这是因为 docker search 与 docker pull 走的是两套机制——前者并不走您配置的镜像加速或专属域名。
错误示例
问题原因
核心原因：默认的 docker search 只会请求 Docker Hub 官方搜索 API，不会使用 daemon.json 中的 registry-mirrors，也不会自动走您的专属域名。
因此执行 docker search mysql 时，请求始终发往官方 Docker Hub；若本机访问 Hub 较慢或被限制，就容易出现超时或报错。
需要区分的一点：
- •
registry-mirrors/ 专属域名主要优化docker pull拉取 - •
docker search不受上述配置影响，默认只查 Docker Hub - • 若要在命令行搜索轩辕镜像，需显式带上专属域名（见下方方案二）
解决方案
方案一：在轩辕镜像网站搜索（推荐）
我们更推荐在网站中查找镜像与标签：支持关键词搜索、查看镜像详情、按标签筛选，还能直接复制拉取命令，比命令行 docker search 更直观，也不受 Docker Hub 网络限制影响。
1️⃣ 搜索镜像
在搜索页输入关键词，可按来源筛选（如 Docker Hub）：
https://xuanyuan.cloud/search?q=mysql&source=docker.io&page=1确认镜像名与标签后，使用 专属域名或登录方式 执行 docker pull 即可。若站内搜不到某镜像，可参考 网页搜索不到镜像怎么办。
方案二：命令行显式指定专属域名
若仍希望在终端搜索，需在命令中显式写出轩辕镜像地址，例如：
或使用您的专属域名：
（将 ***.xuanyuan.run 替换为个人中心中的专属域名）
注意：命令行搜索能力有限，无法像网站那样方便地浏览标签、架构与拉取命令，日常查镜像更建议优先使用方案一。
💡 总结：
- ✅ 默认
docker search只查 Docker Hub，不走专属域名或 mirrors - ✅ 推荐在 轩辕镜像网站 搜索镜像、查看详情与筛选标签
- ✅ 命令行搜索需显式指定
*.xuanyuan.run域名 - ✅ 查好镜像名与 tag 后，用
docker pull拉取即可
你可能还会遇到：
本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理