让 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 无法连接轩辕镜像域名怎么办？

本文适用于：

✅ 结论先看

第一步：统一诊断命令

先执行下面命令进行连通性诊断：

curl -v https://docker.xuanyuan.run/v2/

PowerShell 里的 curl 默认是 Invoke-WebRequest 的别名，不等同于 Linux 的 curl。

建议在 Windows 下明确使用 curl.exe：

curl.exe -v https://docker.xuanyuan.run/v2/

如果你使用 Invoke-WebRequest 得到 401 未经授权，通常也说明服务可达，不属于网络不通。

报错特征	常见原因	建议处理
dial tcp *:443 (或 :80): i/o timeout	到目标 IP 的链路超时，常见于防火墙、出口 ACL、代理节点不稳定	关闭代理重试、换网络验证、放通 80/443、检查企业出口策略
Could not resolve host / no such host	本地 DNS 无法解析域名	切换 DNS（223.5.5.5、114.114.114.114），检查 resolv.conf 和企业 DNS 策略
connect: connection refused	目标端口连接被拒绝，链路中间设备或目标端口异常	分别测试 http/https，核查端口策略与边界防火墙规则
Network is unreachable (常见 IPv6)	本地没有 IPv6 出口	优先走 IPv4，调整网络出口或策略后重试
OpenSSL SSL_connect / certificate verify failed	TLS 链路被代理劫持、证书链异常或系统时间错误	校准时间、停用 HTTPS 劫持代理、检查证书注入策略
EOF	连接建立后中途被重置，常见于代理链路不稳定	关闭或更换代理节点，进行直连对比测试
HTTP/1.1 401 Unauthorized	这是可达信号，说明仓库服务在线	转到账号登录、权限或凭证排查，不再按网络故障处理

如果 curl -v 可正常访问，但 docker login / docker pull 报错，通常是 Docker 运行时代理配置异常。

docker info

重点查看 HTTP Proxy、HTTPS Proxy、No Proxy。可先临时移除代理并重启 Docker 后再测。

你可能还会遇到：

本文由「轩辕镜像」维护
轩辕镜像 | Docker 镜像高效稳定拉取服务
内容基于轩辕镜像真实用户使用与实测整理