桑吉 發表於 2025-12-19 15:55:51

Docker拉取镜像时遇到dial tcp...443:i/o timeout错误的解决方案

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">1. 报错信息</a></li><li><a href="#_label1">2. 配置镜像加速</a></li><li><a href="#_label2">3. 尝试拉取镜像</a></li><li><a href="#_label3">4. 注意事项</a></li><li><a href="#_label4">总结</a></li></ul></div><p>在使用Docker时,我们经常会需要从Docker Hub或其他镜像仓库拉取镜像。</p>
<p>有时由于网络问题我们可能会遇到dial tcp 199.16.156.71:443: i/o timeout这样的错误,这一般是因为Docker客户端在尝试与远程镜像仓库建立连接时超时了。</p>
<p>本文将介绍如何解决这个问题。</p>
<p class="maodian"><a name="_label0"></a></p><h2>1. 报错信息</h2>
<p>当我们尝试运行docker run命令时,如果看到了类似的错误消息,比如:</p>
<blockquote><p>error pulling image configuration: Get https://registry-1.docker.io/v2/.../blobs/sha256/...:&nbsp;<br />dial tcp 199.16.156.71:443: i/o timeout</p></blockquote>
<p>这就是说Docker无法从默认的Docker Hub地址(registry-1.docker.io)成功拉取镜像。</p>
<p class="maodian"><a name="_label1"></a></p><h2>2. 配置镜像加速</h2>
<p>我们可以通过配置Docker使用国内的镜像加速服务。镜像加速服务服务提供了Docker Hub上镜像的本地缓存,从而可以更快地拉取镜像,网络连接也更稳定。</p>
<p>要配置镜像加速,我们需要编辑Docker的配置文件daemon.json。一般来说这个文件位于/etc/docker/目录下。</p>
<p>使用vi编辑器打开或创建daemon.json文件,如果该文件不存在,可以创建一个。</p>
<div class="jb51code"><pre class="brush:bash;">sudo vim /etc/docker/daemon.json</pre></div>
<p><strong>添加或更新镜像源列表</strong></p>
<p>在daemon.json文件中,你可以添加或更新一个名为registry-mirrors的键,其值是一个包含多个镜像加速地址的数组。</p>
<p>例如:</p>
<div class="jb51code"><pre class="brush:json;">{
"registry-mirrors": ["https://hub-mirror.c.163.com", "https://registry.aliyuncs.com", "https://docker.mirrors.ustc.edu.cn"]
}</pre></div>
<p>注意上面列举的镜像源仅供参考,可以根据需要换成适合的镜像源。</p>
<p>修改完成之后保存并关闭文件。vi里面使用:wq</p>
<p><strong>重启Docker服务</strong></p>
<p>重启Docker服务,让更改生效。</p>
<div class="jb51code"><pre class="brush:bash;">sudo systemctl restart docker</pre></div>
<p>在稍早一些版本的系统上可能是:</p>
<div class="jb51code"><pre class="brush:bash;">sudo service docker restart</pre></div>
<p><strong>验证配置</strong></p>
<p>重启Docker服务后,我们可以使用sudo docker info命令来检查Docker的状态,并确保镜像加速已经生效。</p>
<p class="maodian"><a name="_label2"></a></p><h2>3. 尝试拉取镜像</h2>
<p>现在我们可以尝试再次拉取之前遇到问题的镜像。</p>
<p>如果一切设置正确,我们应该能够成功地从镜像加速服务拉取镜像了。</p>
<p class="maodian"><a name="_label3"></a></p><h2>4. 注意事项</h2>
<p>在编辑daemon.json文件时,要确保JSON格式正确,没有多余的逗号、括号或其他字符。</p>
<p>如果在修改daemon.json文件后遇到Docker无法启动的问题,还请检查文件内容是否有误,并进行修复。</p>
<p>不同的镜像加速服务可能支持不同的镜像和标签。</p>
<p>如果你发现某个镜像源无法拉取你需要的镜像,请尝试使用其他镜像源。</p>
<p class="maodian"><a name="_label4"></a></p><h2>总结</h2>
<p>以上为个人经验,希望能给大家一个参考,也希望大家多多支持琼殿技术社区。</p>
頁: [1]
查看完整版本: Docker拉取镜像时遇到dial tcp...443:i/o timeout错误的解决方案