Windows环境下使用docker-compose执行pip install时遭遇ConnectTimeoutError

看起来你在Windows 10环境下跟着教程学Docker时，遇到了构建镜像阶段pip连接PyPI超时的问题，试过网上的办法也没解决对吧？我结合Windows环境的特性，给你几个针对性的排查和解决方向，你可以逐个尝试：

• 检查Docker代理配置
  Windows系统如果开启了代理，Docker可能会自动继承，但容器内的网络环境和主机不同，很容易因为代理配置不对导致超时。你可以这么操作：

  1. 打开Docker Desktop的设置面板，找到「Resources」→「Proxies」
  2. 如果之前设置了代理，先切换到「No proxy」，应用设置后重启Docker，再重新执行docker-compose up -d试试
  3. 如果必须使用代理，记得把代理地址改成host.docker.internal:端口（而不是localhost，因为容器里的localhost指向自身，无法访问主机的代理）

• 更换PyPI国内镜像源
  连接官方PyPI超时大多是跨国网络的问题，换成国内镜像源能直接绕过这个障碍。你可以修改Dockerfile里的pip安装命令：
  把原来的RUN pip install -r requirements.txt替换成：

  RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  或者也可以在Dockerfile里提前配置pip默认源，后续所有pip命令都会自动使用：

  RUN mkdir -p /root/.pip && echo "[global]" > /root/.pip/pip.conf && echo "index-url = https://pypi.tuna.tsinghua.edu.cn/simple" >> /root/.pip/pip.conf
  RUN pip install -r requirements.txt
  

• 调整Docker的DNS服务器
  有时候DNS解析失败也会导致无法访问PyPI，你可以手动指定Docker的DNS：

  1. 打开Docker Desktop设置，进入「Resources」→「Network」
  2. 在「DNS servers」里添加国内公共DNS，比如114.114.114.114或者8.8.8.8，应用设置后重启Docker再尝试构建

• 排查Windows防火墙/杀毒软件拦截
  Windows自带防火墙或者第三方杀毒软件可能会误拦截Docker容器的网络请求。你可以暂时关闭这些防护工具，再执行docker-compose up -d测试，如果问题解决了，记得给Docker添加网络访问的权限白名单。

• 尝试单独构建镜像排查问题
  有时候docker-compose的缓存或者配置可能影响构建，你可以先跳过docker-compose，直接用docker build命令单独构建镜像：

  docker build --no-cache -t my-python-app .
  

  加上--no-cache参数能避免使用之前的构建缓存，排除缓存导致的异常。

如果以上方法都试过还是不行，你可以检查一下主机本身能不能正常访问PyPI（比如在浏览器里打开https://pypi.org/simple/flask/），确认主机网络没问题的话，再考虑重置Docker的网络配置（Docker Desktop设置里的「Troubleshoot」→「Reset to factory defaults」，注意这个操作会清除现有容器和镜像，记得备份）。

备注：内容来源于stack exchange，提问作者Matthew Earlywine