docker报Error response from daemon: Get https://registry-1.docker.io/v2/library/image-name/manifests/

灰太狼 2024-03-17 19:36 106阅读 0赞

前天在使用 Docker 进行容器化部署时，遇到 TLS 握手超时的错误。在这里我将分享如何解决此问题。

### 错误信息 ###

错误信息：`Error response from daemon: Get https://registry-1.docker.io/v2/library/image-name/manifests/tag: net/http: TLS handshake timeout`

这个错误通常在从 Docker 镜像仓库拉取镜像的过程中出现，意味着 Docker 守护进程无法建立与 TLS 连接相关的握手阶段。

### 解决方案 ###

1.  检查网络连接
    
    首先，确保网络连接正常并且可以访问 Docker 镜像仓库（`registry-1.docker.io`）。尝试通过浏览器访问该地址，以确认网络连接正常。
2.  检查代理配置
    
    如果计算机使用了代理服务器，请确保 Docker 守护进程可以正确地配置和使用代理。按照以下步骤进行检查和设置：
    
     *  编辑 Docker 配置文件 `daemon.json`，通常位于 `/etc/docker/` 目录下。
     *  在文件中添加以下代理配置参数：
        
            {
              "proxies": {
                "default": {
                  "httpProxy": "http://your-proxy-server:proxy-port",
                  "httpsProxy": "http://your-proxy-server:proxy-port"
                }
              }
            }
     *  替换 `your-proxy-server` 和 `proxy-port` 分别为代理服务器地址和端口。
     *  保存并关闭文件，然后重启 Docker 守护进程。
3.  调整 TLS 超时设置
    
    如果网络环境较差，或者 Docker 镜像仓库的响应时间较长，可以尝试调整 Docker 守护进程的 TLS 超时设置。按照以下步骤进行操作：
    
     *  编辑 Docker 配置文件 `daemon.json`，通常位于 `/etc/docker/` 目录下。
     *  在文件中添加以下参数：
        
            {
              "max-concurrent-downloads": 10,
              "max-concurrent-uploads": 10,
              "default-address-pool": [{"base": "10.0.0.0/8", "size": 24}],
              "live-restore": true,
              "max-download-attempts": 10,
              "max-event-backlog": 100,
              "max-retry-attempts": 10,
              "registry-mirrors": ["https://your-registry-mirror"]
            }
     *  替换 `your-registry-mirror` 为使用的镜像仓库地址。
     *  保存并关闭文件，然后重启 Docker 守护进程。
4.  更新 Docker 版本
    
    如果使用的是较早版本的 Docker，尝试升级到最新版本，因为 Docker 更新版本通常包含了对 TLS 连接问题的解决方案。
5.  检查防火墙设置
    
    某些防火墙规则可能会阻止 Docker 和镜像仓库之间的TLS通信。可以尝试禁用防火墙或者添加适当的规则来允许 TLS 连接。

### 总结 ###

通过上述步骤，解决 Docker TLS 握手超时错误。确保逐一检查、配置和测试，以达到最佳效果。希望我的分享对您解决此问题提供帮助。