让 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 pull 提示无法连接 docker.sock / daemon 未运行怎么办？

本文适用于：

• 报错含 unix:///var/run/docker.sock、no such file or directory
• 提示 daemon is running、Cannot connect to the Docker daemon
• Windows 命名管道 npipe:////./pipe/docker_engine 连接失败
• Linux / Docker Desktop / WSL2 / CI 环境中 Docker CLI 无法连上本地引擎

先搞清一点：这是本机 Docker 引擎未就绪，与镜像源无关

docker pull 会先通过 Unix socket（Linux）或命名管道（Windows）连接本地 Docker daemon。若 sock 不存在、引擎未启动或路径指错，CLI 会立刻失败，请求根本不会发到轩辕镜像或任何 Registry。请先让 docker info 成功，再重试拉取。

典型报错示例

docker pull docker.xuanyuan.run/library/nginx:1.30.4-alpine3.24-perl failed to connect to the docker API at unix:///var/run/docker.sock; check if the path is correct and if the daemon is running: dial unix /var/run/docker.sock: connect: no such file or directory

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

error during connect: Get "http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.24/...": open //./pipe/docker_engine: The system cannot find the file specified.

常见原因

Docker 未安装或未启动：本机没有 dockerd，或服务已停止，导致 /var/run/docker.sock 不存在
Docker Desktop 未打开：Windows / macOS 上 CLI 依赖 Desktop 提供的引擎；图标未运行时会出现 sock / named pipe 错误
WSL2 集成未就绪：在 WSL 发行版内执行 docker，但 Desktop 的「WSL integration」未对该发行版开启，或 Linux 引擎尚未启动完成
权限不足：Linux 上当前用户不在 docker 组，且未使用 sudo，可能表现为 permission denied（与 sock 不存在需区分）
DOCKER_HOST 指错：环境变量指向远程或不存在的 socket / TCP 地址
CI 或容器内无 Docker：Job / 容器未挂载 docker.sock，也未配置 DinD（Docker-in-Docker），CLI 无处可连

处理建议

1）先确认本地引擎是否可用

在执行任何 docker pull 之前，先跑诊断命令：

docker info ls -l /var/run/docker.sock # Linux echo "DOCKER_HOST=${DOCKER_HOST}"

docker info 能正常输出 Server 信息，说明 CLI 已连上 daemon，再重试拉取。

2）按系统启动 Docker

Linux（systemd）：sudo systemctl start docker，并可用 sudo systemctl enable --now docker 设为开机自启
Docker Desktop：打开应用，等到状态为 Engine running；Windows 下确认 Settings → General 中引擎已启用
WSL2：在 Desktop → Resources → WSL integration 中开启当前发行版，回到 WSL 再执行 docker info

3）检查权限与 DOCKER_HOST

Linux 将用户加入 docker 组后重新登录：sudo usermod -aG docker $USER
若设置过 DOCKER_HOST，临时取消后再试：unset DOCKER_HOST
CI / 容器场景需挂载宿主机 sock，或使用官方 DinD 镜像；否则本环境根本没有 Docker API

4）引擎正常后再拉取

docker info 通过后，再执行原先的 pull。若此时变成超时、证书、manifest 等错误，说明本地引擎已通，应按对应 FAQ 继续排查（见下方区分）。

与相近错误的区分

连不上 docker.sock / daemon：本地引擎未就绪 → 按本文启动 Docker / 修路径
连不上轩辕域名：daemon 正常，但访问 Registry 超时 / 拒绝 → 查网络、代理、DNS
DNS 超时、TLS 证书错误：请求已发出，卡在解析或握手阶段，与 sock 无关

你可能还会遇到：

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