核心原因是默认连接海外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.iohttps://docker.xuanyuan.mehttps://docker.1ms.run
操作步骤（Windows Docker Desktop）：
- 右上角 ⚙️ → 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 文件 + 换两行源地址就能解决。重点是确认问题类型再动手，避免盲目重启或重装。
