Google Colab 代理安装依赖失败怎么办：pip、GitHub 与外部数据访问

Colab 中 pip、GitHub 和数据源可能由不同子进程访问。先看失败主机和错误层，再确认当前 runtime 是否把代理变量传给实际命令；runtime 重启后要重新验证。

Colab 中 pip、GitHub 和业务数据源可能由不同子进程访问。先识别失败主机，再确认当前 runtime 是否把代理变量传给实际命令；runtime 重启后需要重新验证。

先判断失败发生在 PyPI、GitHub 还是数据源

pip 失败先看 PyPI 或镜像，clone/Release 失败看 GitHub，数据下载失败看业务数据源。分别记录主机、状态码和错误文本；一条链路成功不能代表其他服务可用。

runtime 中如何设置并验证代理

在当前 notebook 设置代理变量后，只显示变量是否存在或脱敏主机，不打印账号密码和完整 URL。先做出口检测，再用 pip 元数据请求或 Git 轻量请求验证子进程继承。runtime 重启、断开或切换后重新设置并复测。

Python 请求中的代理字段可参考Python requests 怎么设置 HTTP 和 SOCKS5 代理。

如何分别测试 pip、Git 和数据源

每一步成功后再进入下一步。出现权限拒绝、验证码或限流时暂停，不通过提高并发或频繁更换出口继续请求。轻量请求成功但原命令失败，应回查命令参数、包版本、Git 凭据或目标权限。

如果轻量请求仍无法建立连接，可参照代理 IP 连不上先查什么区分全局连接和目标站问题。

下面逐条验证 PyPI、GitHub 和数据源链路；一条成功不代表其他服务可用。

逐条完成验证后再执行大文件或批量操作。

runtime 重启后怎样重新连接

Colab runtime 重启、断开或切换后，临时环境变量可能消失。重新设置后先用脱敏出口检测，再分别执行一次 pip 元数据请求、Git 轻量请求和数据源小响应请求；不要只看变量名存在就判断代理已生效。命令输出只保留目标主机、状态码和错误摘要。

403、429 和认证错误怎么处理

PyPI 元数据失败先查 DNS、TLS、407 或镜像地址；GitHub 失败再查仓库权限和 Git 子进程；数据源返回 403、429、验证码或空结果时暂停自动请求并核对访问规则。某一链路成功不代表其他链路可以扩大请求。

遇到拒绝或验证码时，可参考代理出现 403、429、验证码时先查什么。

在当前 runtime 中验证代理变量

在同一个 Colab runtime 中先设置代理，再验证变量存在但不打印密码：

```python
import os, requests
os.environ["HTTPS_PROXY"] = "http://user:password@proxy.example:8080"
print(bool(os.environ.get("HTTPS_PROXY")))
r = requests.get("https://pypi.org/simple/", timeout=10)
print(r.status_code, r.url) # 200/3xx 表示连接链路可用
```

若 runtime 重启后变量消失，重新执行设置单元；200/3xx 只证明 PyPI 链路可达，GitHub 权限、pip 包版本或数据源认证仍需单独验证。

FAQ

共享 notebook 能否保存完整代理 URL？

不应保存，认证部分应放安全环境，输出只显示是否存在或脱敏主机。

runtime 重启后代理为什么失效？

重启可能结束当前进程并清除临时环境变量。重新设置代理后，应再次检查出口，并分别测试 pip、Git 或目标数据源。

pip 成功但 GitHub 仍失败怎么办？

这只说明包索引链路可用。GitHub 请求可能由独立的 Git 子进程发出，应单独检查其代理继承、仓库权限和目标主机。

代理变量存在是否代表 pip 一定使用了代理？

不代表。还要在当前 runtime 中发起 pip 元数据或小包请求，确认实际连接路径。