国内用户首次拉取Docker镜像超时，根本原因是默认连接海外Docker Hub延迟高或不通，最直接有效的解法是配置国内镜像加速器，通过修改daemon.json或Docker Desktop设置添加如"https://docker.m.daocloud.io"等稳定镜像源并重启服务，可将拉取时间从数十秒降至几秒。
安装 Docker 后首次拉取镜像（比如 docker run hello-world）报超时，不是安装出错，而是默认连海外 Docker Hub 太慢或不通。国内用户最直接有效的解法，就是配置国内镜像加速器——它不改 Docker 本身，只把请求“转接”到更快的本地缓存节点。
确认确实是网络超时问题
别急着改配置，先快速验证：
- 运行
docker pull hello-world，卡在 "waiting" 或 "pulling fs layer" 几十秒以上，基本就是网络问题 - 执行
ping registry-1.docker.io，如果不通、高丢包（>5%）或延迟 >200ms，说明链路有问题 - 用
curl -v https://registry-1.docker.io/v2/测试 HTTPS 连通性，看是否卡在 TLS 握手或无响应
配置国内镜像加速器（Windows/macOS 推荐）
用 Docker Desktop 图形界面操作最稳妥：
- 右上角 ⚙️ → Settings → 左侧选 Docker Engine
- 在 JSON 编辑框中，把
"registry-mirrors"替换为以下任一或多个地址（2026 年实测稳定、无需登录）：["https://docker.m.daocloud.io", "https://docker.xuanyuan.me", "https://docker.1ms.run"] - 点击 Apply & Restart，等待 Docker 重启完成
- 验证是否生效：终端运行
docker info | findstr "Registry Mirrors"（Windows）或docker info --format '{{.RegistryConfig.Mirrors}}'（macOS/Linux），应看到你填的地址
Linux 系统手动配置 daemon.json
适合服务器或 CLI 环境：
- 创建或编辑配置文件：
sudo mkdir -p /etc/docker && sudo nano /etc/docker/daemon.json - 填入标准格式（注意逗号和引号）：
{"registry-mirrors": ["https://docker.m.daocloud.io", "https://docker.xuanyuan.me"]} - 保存后重载并重启：
sudo systemctl daemon-reload && sudo systemctl restart docker - 检查结果：
sudo docker info | grep -A 5 "Registry Mirrors"
构建阶段内部源也要同步优化
镜像加速器只管 FROM 和 docker pull，但 RUN apt update、RUN npm install 这类命令仍走系统默认源。需按基础镜像类型加换源指令：
-
Debian/Ubuntu：在 RUN 前加
RUN sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list -
CentOS/RHEL：替换
/etc/yum.repos.d/CentOS-Base.repo中的baseurl为阿里云或清华源地址 -
Node.js：加
RUN npm config set registry https://registry.npmmirror.com -
Python：加
RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
配好镜像源后，再跑 docker pull hello-world 或构建镜像，通常几秒内就能完成。这不是修 bug，是绕过瓶颈的常规操作。
