核心原因是默认连接海外Docker Hub导致延迟高或不可达，解决方案是配置2026年实测可用的国内镜像加速器（如https://docker.m.daocloud.io等），并按基础镜像类型优化构建阶段内部源。

构建 Docker 镜像时因网络超时失败，核心原因是 默认连接海外 Docker Hub 服务延迟高或不可达，尤其在国内常见。这不是 Dockerfile 写法问题，而是网络链路与镜像源配置问题。解决关键在于绕过直连、缩短路径、提升可靠性。

确认是否真是网络超时

先别急着改配置，快速验证问题性质：

• 运行 docker pull hello-world，看是否卡在 "waiting" 或 "pulling fs layer"
• 执行 ping registry-1.docker.io，若不通或丢包率高（>5%），基本锁定网络层
• 用 curl -v https://registry-1.docker.io/v2/ 测试 HTTPS 连通性，观察是否卡在 TLS 握手或响应超时
• 如果 docker pull 成功但 docker build 失败，说明是构建过程中某条 RUN 指令（如 apt update 或 npm install）触发了额外网络请求，需单独优化

配置国内可用的镜像加速器（最常用有效）

这是 90% 场景下的首选方案。2026 年实测稳定、无需登录的公共加速地址包括：

• https://docker.m.daocloud.io
• https://docker.xuanyuan.me
• https://docker.1ms.run

操作步骤（Windows Docker Desktop）：

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• 右上角 ⚙️ → Settings → 左侧选 Docker Engine
• 在 JSON 编辑框中，将 "registry-mirrors" 替换为上述任一地址（建议填全三个，提高容错）
• 格式示例：

  {"registry-mirrors": ["https://docker.m.daocloud.io", "https://docker.xuanyuan.me", "https://docker.1ms.run"]}

• 点击 Apply & Restart
• 重启后运行 docker info | findstr "Registry Mirrors"（Windows）确认生效

针对构建阶段内部网络请求做专项优化

Dockerfile 中的 RUN 指令（如安装依赖）可能走系统默认源，不受 registry-mirrors 影响。需按基础镜像类型分别处理：

• Debian/Ubuntu 镜像：在 RUN apt update && apt install -y ... 前加换源指令，例如：
  RUN sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list
• CentOS/RHEL 镜像：替换 /etc/yum.repos.d/ 下 repo 文件中的 baseurl 为阿里云或清华源
• Node.js/npm 镜像：在 RUN npm install 前加 RUN npm config set registry https://registry.npmmirror.com
• Python/pip 镜像：添加 RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

备用方案：DNS 与代理兜底

当加速器也失效时，可叠加以下手段：

• DNS 优化：在 Docker Desktop Settings → General → ✔️ “Use the host’s DNS settings” 取消勾选，手动填入 8.8.8.8 和 114.114.114.114
• 启用代理（如有）：Settings → Resources → Proxies → 填写 HTTP/HTTPS 代理地址（注意：需确保代理本身稳定且支持 Docker 协议）
• 临时禁用 IPv6：某些网络环境下 IPv6 解析异常，可在 Docker Desktop Settings → Docker Engine JSON 中加入：
  "ipv6": false, "fixed-cidr-v6": ""

不复杂但容易忽略——多数超时问题，靠改一个 JSON 文件 + 换两行源地址就能解决。重点是确认问题类型再动手，避免盲目重启或重装。