Debian系统GCE中pip install报NewConnectionError故障求助

我之前在Google Compute Engine的Debian实例上也碰到过完全一样的报错，折腾了好一会儿才搞定，给你整理几个实用的排查和解决步骤：

1. 先验证基础网络连通性 #

别一开始就死磕pip，先确认实例能不能正常访问外网：

• 执行 ping pypi.org 看看能不能收到响应，如果完全丢包，那问题出在实例的网络配置，不是pip本身
• 用curl测试HTTPS连接：curl -v https://pypi.org/simple/，如果返回无法连接的错误，说明出站HTTPS流量被拦截了

2. 检查GCE的防火墙规则 #

GCE默认的VPC防火墙可能限制了出站流量：

• 登录GCP控制台，找到实例所属的VPC网络，查看出站防火墙规则，确保有允许TCP 443端口（HTTPS）出站的规则
• 还要确认实例的网络标签和防火墙规则的目标标签匹配，别把规则加到了其他实例组上

3. 排查系统级网络限制 #

Debian系统本身的网络配置也可能出问题：

• 查看iptables规则：sudo iptables -L，检查有没有禁止出站443端口的规则，如果有，需要删除对应的规则
• 检查代理环境变量：执行 echo $http_proxy 和 echo $https_proxy，如果输出了错误的代理地址，执行 unset http_proxy https_proxy 清空，然后重新尝试pip安装

4. 更换PyPI镜像源（网络通但连不上官方源） #

如果基础网络没问题，但就是访问PyPI官方源失败，可以换成国内的镜像源：

• 临时使用：pip install <package-name> -i https://pypi.tuna.tsinghua.edu.cn/simple
• 永久配置：创建 ~/.pip/pip.conf 文件，写入以下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

5. 确认实例的外部IP状态 #

如果你的实例只有内部IP，没有分配外部静态/临时IP，那肯定没法直接访问外网：

• 要么给实例分配一个外部IP，要么配置Cloud NAT让内部实例通过NAT网关访问外网

6. 重启网络服务或实例 #

有时候网络配置缓存会导致奇怪的问题：

• 重启Debian网络服务：sudo systemctl restart networking
• 如果还是不行，直接在GCP控制台重启实例，再试pip安装

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