Docker 运行 hello-world 镜像失败或超时问题排查与解决

Docker 运行 hello-world 镜像失败或超时问题排查

在运行 Docker hello-world 镜像时，若遇到连接超时或无法找到本地镜像的错误（如 Unable to find image 'hello-world:latest' locally），通常是由于默认的 Docker 镜像源访问速度较慢或不稳定导致的。

解决方案：更换镜像源

可以通过配置 Docker 守护进程文件来使用加速镜像源。

1. 配置加速地址

编辑 /etc/docker/daemon.json 文件，添加 registry-mirrors 配置项。

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://do.nark.eu.org",
    "https://dc.j8.work",
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.nju.edu.cn"
  ]
}
EOF

2. 重启 Docker 服务

sudo systemctl daemon-reload
sudo systemctl restart docker
sudo systemctl status docker

3. 验证配置

执行以下命令检查镜像源是否生效：

docker info

输出中应包含 Registry Mirrors 部分。

4. 测试运行

docker run hello-world

若成功拉取并运行，则问题解决。也可通过 docker images 查看已下载的镜像。