问题重现 #

将发送构建上下文至Docker守护进程 213.3MB
步骤1/14：FROM python:3.9
获取"https://registry-1.docker.io/v2/"时出错：无法连接至xx.xxx.xx.xxx:xx。是否需要HTTP代理？

• 终端进程"C:\WINDOWS\System32\WindowsPowerShell\v1.0\powershell.exe -Command docker build --pull --rm -f "Dockerfile" -t python-wa ".""以退出码1终止。
• 终端将被任务复用，按任意键关闭。

可能的原因及解决办法 #

之前正常运行突然出故障，重启没用的话，可以从这几个方向排查：

• 代理配置冲突或失效
  这是最常见的诱因，可能你的系统代理（浏览器代理、VPN代理）最近有变动，或者Docker的代理配置出现异常。
  解决步骤：

  1. 打开Docker Desktop，点击右上角的设置图标（⚙️）
  2. 进入Resources -> Proxies选项卡
  3. 如果是手动配置的代理，先切换成「Use system proxy」；如果当前网络不需要代理，直接选择「No proxy」
  4. 点击「Apply & Restart」重启Docker，再执行构建命令

• 网络环境变更导致连接拦截
  要是你最近切换了网络（比如从家到公司WiFi、开启/关闭VPN），新环境的防火墙、路由器或VPN可能阻止了Docker访问外部镜像仓库。
  解决步骤：

  1. 先用浏览器访问https://registry-1.docker.io，确认网络本身能正常连接Docker Hub
  2. 如果开启了VPN，先断开再尝试docker build命令
  3. 暂时关闭Windows防火墙（仅用于测试，之后记得重新开启），或者检查防火墙规则是否拦截了Docker的网络请求

• Docker网络组件损坏
  Docker Desktop的网络驱动或组件偶尔会出现异常，简单重启可能修复不了，需要重置网络：
  解决步骤：

  1. 打开Docker Desktop设置，进入Troubleshoot选项卡
  2. 先尝试点击「Restart Docker」旁的「Clean up」，选择清理网络相关数据
  3. 若还是不行，试试「Reset to factory defaults」（注意：此操作会清空本地镜像、容器、卷等数据，先备份重要内容），之后重新启动Docker

• DNS解析故障
  系统DNS无法正确解析Docker Hub的域名，也会导致连接失败：
  解决步骤：

  1. 打开Windows「网络和Internet设置」，找到当前网络的DNS服务器配置
  2. 手动添加公共DNS，比如8.8.8.8（谷歌DNS）或1.1.1.1（Cloudflare DNS）
  3. 打开PowerShell，执行命令ipconfig /flushdns刷新DNS缓存
  4. 再次尝试构建镜像

内容的提问来源于stack exchange，提问作者Sanket Wagh