本文摘要：在使用docker时遇到无法下载镜像的问题，表现为执行`docker pull`命令下载镜像时，出现“Client.Timeout exceeded”错误。排查网络连接和防火墙设置无果后，通过`docker info`发现是由于`registry-mirrors`配置项中指向了错误的镜像仓库地址。问题最终在修改`/etc/docker/daemon.json`中的镜像仓库地址为正确值后得到解决。对于类似情况，建议首先检查`registry-mirrors`配置及docker其他相关配置项是否正确。

Docker

最近在采用拉取镜像的期间，碰到了一个很诡异的问题，就是不能获取映像。我在部署某些映像时，需要采用拉取镜像 pull指令获取，但是每次获取都会被终止，提示不能访问到映像库房。我不清楚这个问题是从哪里产生的，也不清楚怎样处理。下面是我碰到的问题及处理方法。

$ 拉取镜像 pull nginx
Using default tag: latest
Error response from daemon: Get https://registry-1.拉取镜像.io/v2/: net/http: request canceled (Client.Timeout exceeded while awaiting headers)

由于这个错误信息的信息比较简单，我首先检查了自己的网络访问，确认自己的网络确实是稳定的。然后，我怀疑是防火墙导致的问题，于是关闭了防火墙。但是，这个问题依然存在。

我尝试了许多方法，比如修改拉取镜像的DNS设置、刷新拉取镜像的缓存等等，但都没有效果。最后，我发现这个问题的原因是拉取镜像环境中的一个配置项，即‘registry-mirrors’。

$ 拉取镜像 info
...
Registry Mirrors:
 https://***.***.***.***:****/
 https://***.***.***.***:****/
...

我的问题是因为registry-mirrors设置了错误的映像库房地址，导致不能获取映像。在我的拉取镜像环境中，registry-mirrors配置文件存放的位置为/etc/拉取镜像/daemon.json。我打开这个文件，发现我的映像库房地址已经被设置为错误的地址。我修改这个地址后，重新运行拉取镜像 pull指令，成功地获取了需要的映像。

$ sudo vim /etc/拉取镜像/daemon.json
{
"registry-mirrors": ["https://registry.拉取镜像-cn.com"]
}

总之，这个问题还是比较诡异的，因为我并没有修改什么拉取镜像的配置项，却产生了这样的问题。如果你也碰到了类似的问题，可以先检查一下映像库房地址是否正确，或者检查拉取镜像的一些其他配置项。

名词解释

作为当前文章的名词解释，仅对当前文章有效。

Docker：Docker是一个开源的应用容器引擎，它通过容器化技术，使开发者可以打包应用及其依赖包到一个可移植的容器中，然后发布到任何流行的Linux或Windows机器上运行。在本文中，用户遇到的问题就是在使用Docker下载镜像时遇到了网络连接问题。

Registry-Mirrors：在Docker环境配置中，registry-mirrors是指Docker客户端用于加速拉取官方Docker Hub镜像或其他私有仓库镜像的镜像源地址列表。当Docker pull命令尝试从默认仓库下载镜像时，如果registry-mirrors中有可用的镜像源，Docker会优先尝试从此处下载，以提高下载速度和稳定性。文中提到的问题就是由于registry-mirrors配置了错误的镜像仓库地址导致无法正常下载镜像。

Daemon.json：Daemon.json是Docker守护进程的配置文件，位于Linux系统中的/etc/docker/目录下。此文件用于设置Docker守护进程的启动参数，如本文所述，可以通过修改daemon.json文件来配置registry-mirrors、HTTP代理等全局Docker服务参数。当用户遇到无法下载镜像的问题时，正是在这个文件中找到了并修复了指向错误镜像仓库地址的配置项。