故障排查

docker pull timeout 怎么排查？

中国区访问 Docker Hub 时，常见问题包括连接慢、TLS handshake timeout、manifest 拉取失败、blob 下载中断。下面是优先级较高的排查路径。

1. 确认是否配置 registry mirror

docker info | grep -A 5 "Registry Mirrors"

如果没有镜像源，建议先配置专属 Docker Hub mirror，再测试小镜像。

2. 先测试小镜像

docker pull hello-world:latest
docker pull alpine:3.20

小镜像失败通常是网络、DNS、daemon 配置或服务可用性问题；大镜像失败还可能与带宽、连接中断和配额有关。

3. 检查 daemon.json 格式

JSON 多一个逗号、少一个引号都会导致 Docker daemon 读取失败。可以用 JSON Formatter 先验证。

4. 仍然失败时

记录错误信息、镜像名、时间和系统环境。登录 Prefetch Edge 后可以查看专属镜像源和剩余流量，避免把配额耗尽误判为网络故障。