现象
在新装的服务器上执行 docker pull nginx:1.27,卡在 Pulling fs layer 很久,最后报 net/http: TLS handshake timeout。重试几次偶尔能拉下一层,完整拉完几乎不可能,docker images 里始终只有半截镜像。
原因
默认镜像仓库在境外,TLS 握手和分层下载都要走国际链路,晚高峰丢包严重就会握手超时。Docker 的这个超时是固定的,命令行参数改不了,只能换成可达的镜像加速地址,或者改用能直连的仓库。
解决步骤
第一步,配置镜像加速并重启服务。写完 daemon.json 后必须 reload 或 restart,否则 Docker 仍按旧配置走。
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{"registry-mirrors": ["https://docker.m.daocloud.io"]}
EOF
sudo systemctl restart docker
第二步,验证加速地址是否真的生效。docker info 里看 Registry Mirrors 一行,再拉一个小镜像测试;地址不可达时会退化成直连,表现依旧是超时,需要换一个可用源。
第三步,大镜像改走离线方式。在能正常拉取的机器上 docker pull 后 docker save 成 tar,传到目标机 docker load;或自建 registry 做内网缓存,避免每次都走公网。
验证
docker pull 能在分钟级完成,docker info 显示镜像地址生效,docker images 里能看到完整的镜像和 TAG,启动容器正常,说明拉取链路已经通了。
小结
TLS handshake timeout 是链路问题,不是镜像坏了。配一个可达的加速地址,再配合离线导入,内网和跨境两种场景基本都能覆盖。
