让 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 Desktop 镜像源配置教程
教程简介
适用场景
1获取专属域名
登录网站后，在左侧菜单栏的「专属域名」菜单中获取您的专属域名，格式为：https://***.xuanyuan.run
请将 ***.xuanyuan.run 替换为您的专属域名。登录网站后，点击左侧菜单栏的「专属域名」菜单即可获取。
2打开 Docker Desktop 设置
打开 Docker Desktop，点击右上角的设置图标（齿轮）进入 Settings
注意：确保 Docker Desktop 已经启动并正常运行
3配置 Docker Engine
选择左侧的 "Docker Engine"，在右侧 JSON 中增加或修改 registry-mirrors（并入现有配置，勿清空其它字段）：
{
"registry-mirrors": [
"https://***.xuanyuan.run"
]
}⚠️registry-mirrors 中的地址必须带 https:// 前缀。
4重启 Docker
点击右下角的 "Apply & Restart" 按钮重启 Docker，等待 Docker 重启完成
💡重启过程可能需要几分钟时间，请耐心等待
5验证配置
可以通过 CMD 或终端，查看配置是否生效：检查 Registry Mirrors 是否存在对应的镜像源
6镜像搜索步骤
打开 Docker Desktop，点击右下角 "_ Terminal" 打开终端，输入搜索命令：
7镜像下载步骤
打开 Docker Desktop，点击右下角 "_ Terminal" 打开终端，输入下载命令：
⚠️PS: 不加 TAG 默认为 latest，建议指定具体的 TAG 版本进行下载。
8配置说明
为什么配置了 Docker Registry Mirrors 仍然走官方源？
很多用户反馈，已经在 Docker 中配置了镜像源（registry-mirrors），但拉取镜像时仍然访问官方源（docker.io）。
拉取报错如下：
Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client. Timeout exceeded while awaiting headers)这是因为 Docker 的镜像拉取机制是优先尝试使用镜像源，而不是强制始终使用。部分镜像的 tag 或 namespace 特殊（如 docker-library），可能仍绕过镜像源。
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"