Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled 报错

### 解决 Docker 连接镜像仓库时遇到的超时问题 当面对 `docker registry connection timeout` 错误时，通常是因为网络配置不当或服务器响应缓慢所引起。以下是几种有效的解决方案： #### 修改 `/etc/docker/daemon.json` 对于 Linux 用户而言，在 `/etc/docker/daemon.json` 文件中加入特定设置可以改善这一状况。具体来说，可以通过调整 DNS 设置来优化连接性能[^1]。 ```json { "dns": ["8.8.8.8", "8.8.4.4"] } ``` 此操作旨在指定 Google 的公共 DNS 作为首选项，从而绕过可能存在的本地解析器问题。 #### 配置 Docker Desktop 网络选项（适用于 Windows 和 Mac） 针对使用 Docker Desktop 的用户，可以在应用程序内部更改网络参数而不必手动编辑配置文件。进入 Settings -> Resources -> Network 并勾选 Use the WSL 2 based engine （如果适用），这有助于提高稳定性并减少超时发生的可能性[^2]。 #### 调整客户端请求超时时限 有时增加默认等待时间也能解决问题。通过环境变量控制命令行工具的行为是一个不错的选择。例如，在执行构建之前临时增大超时值： ```bash export DOCKER_CLIENT_TIMEOUT=300 export COMPOSE_HTTP_TIMEOUT=300 ``` 上述指令分别设置了最大允许时间为 300 秒，即五分钟[^3]。 #### 自定义本地私有仓库地址 如果条件允许的话，建立自己的私有注册中心也是一种可行的方法。这样不仅可以避开官方源可能出现的服务中断情况，还能更好地管理团队内的资源访问权限。完成搭建之后记得更新本机的信任证书以及相应的推送拉取路径[^4]。 #### 检查防火墙和其他安全软件的影响 最后但同样重要的是，确认是否有任何网络安全策略阻止了正常的通信过程。关闭不必要的防护措施或将必要的端口列入白名单列表内可能会有所帮助。 ---