Google Colab 代理 IP 配置指南：网络出口与数据访问

先确认运行环境：Google Colab 托管 Runtime 将 connecting to remote proxies 列为受限活动，因此本文不再把“在托管 Runtime 中连接远程代理”作为可执行推荐，也不能声称购买套餐可以解除平台限制。以下示例仅适用于用户自有、规则明确允许的本地运行时；代理 IP 只改变对外出口，不能替代 API 权限、账号配额或目标服务规则。

Colab Runtime 中代理配置如何生效

环境变量通常作用于当前 Runtime 中会读取它们的 Python 进程，不代表浏览器标签页、所有命令行工具或每个第三方 SDK 都会自动继承。判断配置范围时，应在实际发起请求的库中验证，而不是只看变量已经写入。

在 Colab 单元格中使用环境变量，不要把真实账号密码写入共享 Notebook：

HTTP/HTTPS 与 SOCKS5 配置示例

```python
import os
import requests

from getpass import getpass

proxy_user = os.environ['PROXY_USER']
proxy_password = getpass('Proxy password: ')
proxy_host = os.environ['PROXY_HOST']
proxy_port = os.environ['PROXY_PORT']
proxy_url = f'http://{proxy_user}:{proxy_password}@{proxy_host}:{proxy_port}'
os.environ['HTTP_PROXY'] = os.environ['HTTPS_PROXY'] = proxy_url

baseline = requests.get('https://api.ipify.org?format=json', timeout=15, proxies={})
r = requests.get('https://api.ipify.org?format=json', timeout=15,
proxies={'http': proxy_url, 'https': proxy_url})
print('baseline:', baseline.status_code, baseline.json())
print('proxy:', r.status_code, r.json())
```

必须在同一运行时记录直连基线，再用显式 proxies 请求受控回显端点，并把返回出口与代理服务端记录核对。200 或“不同于本机 IP”不能单独证明已走代理；这也不代表浏览器标签页或其他 Notebook 库会继承配置。

SOCKS5 代理需要安装什么依赖

以 requests 为例，可先在当前 Runtime 安装 SOCKS 支持：

```python
!pip install "requests[socks]"
```

安装完成后重新导入请求库；具体依赖和参数仍以当前 Runtime 与库版本文档为准。

如果代理服务提供 SOCKS5，先安装当前运行时需要的额外依赖，再把协议改成 socks5h://，并确认 requests 使用了正确的连接适配器。不要把 HTTP/HTTPS/SOCKS5 当作资源质量等级。

如何验证 API、依赖安装和数据下载

在允许使用代理的自有运行时中，按“设置代理 IP → 记录直连基线 → 用同一 Runtime 验证受控回显 → 请求目标服务 → 下载数据”的顺序执行。Runtime 重启后，环境变量和临时安装的依赖可能失效，应在 Notebook 开头重复初始化。登录、Token、数据集权限和 API 配额要单独验证，不能把 401/403 都归因于代理 IP。

出口 IP 检测成功只证明网络请求经过了代理 IP。API 还要检查 Token 和响应状态，文件下载还要检查登录、访问权限、重定向与文件大小；将三项分开测试，更容易定位失败发生在哪一层。

Runtime 重启与常见错误排查

• 407：检查协议、主机、端口、账号和密码。
• 401/403：检查 Token、权限、目标服务策略和账号状态。
• 429：检查 API 配额、请求间隔和并发。
• TLS/连接重置/超时：依次检查代理协议、DNS、地区路径和客户端超时。

连续失败时保存 Runtime 版本、依赖版本、目标 URL、状态码和复现单元格，停止重复请求后再逐项复测。

官方文档

Colab Runtime、Python 和请求库会持续更新，配置前可核对：

• Google Colab 常见问题：确认 Runtime、会话和运行环境限制。
• Requests advanced usage：核对代理、认证和 Session 配置。
• Python 环境变量：了解环境变量的作用范围。

FAQ

Google Colab 代理 IP 适合什么场景？

托管 Runtime 不应按本文示例连接远程代理。只有在用户自有且规则允许的运行时，才可用于合规 API 请求；是否需要代理 IP，要看目标服务的地区、协议和账号要求。

Runtime 重启后代理失效怎么办？

在允许的自有运行时中，重新运行依赖安装和环境变量初始化单元格，然后按直连基线、受控回显、真实 API 的顺序检查；托管 Runtime 的平台限制不能通过重复初始化绕过。

出口 IP 已变化但 API 仍然失败怎么办？

说明网络层可能已经生效，应继续检查 Token、账号权限、接口配额、请求参数和目标服务规则。

建议把依赖安装、环境变量设置和出口检测放进 Notebook 的初始化单元格。需要核对代理协议、主机、端口和认证字段时，可参考代理设置帮助。