Python Requests 设置代理：超时、异常与凭据保护

一个可控的 HTTP 代理示例

import os
import requests

proxy_url = os.environ["HTTPS_PROXY_URL"]
proxies = {"http": proxy_url, "https": proxy_url}

try:
    response = requests.get(
        "https://example.com/health",
        proxies=proxies,
        timeout=(5, 15),
    )
    response.raise_for_status()
except requests.exceptions.Timeout:
    print("request timed out")
except requests.exceptions.ProxyError:
    print("proxy connection failed")
except requests.exceptions.RequestException as exc:
    print(type(exc).__name__)

timeout=(5, 15) 分别表示连接阶段和读取阶段的等待设置。Requests 官方文档提醒：未显式设置 timeout 时，请求可能长期等待。

环境变量与显式配置

Requests 会读取 http_proxy、https_proxy、all_proxy 和 no_proxy 等环境配置。为了让任务行为可复现，生产代码通常应明确决定是否继承环境代理，并在运行记录中注明。

包含用户名密码的代理 URL 属于敏感信息。官方文档也提醒，把凭据保存在环境变量或版本控制文件中存在风险；实际系统应使用受控的密钥管理机制并限制读取权限。

SOCKS 支持与 DNS

Requests 的 SOCKS 支持是可选功能，需要安装对应依赖。使用 socks5:// 时通常由客户端解析域名，使用 socks5h:// 时交给代理端解析。不要在不理解 DNS 边界时直接切换。

proxies = {
    "http": "socks5h://proxy.example:1080",
    "https": "socks5h://proxy.example:1080",
}

重试必须有限制

连接超时、临时 5xx 或限流可能适合有限重试，但认证失败、参数错误和权限拒绝通常不应盲目重试。只对可安全重放的操作使用退避，并设置最大次数、总时限和随机抖动。

日志中记录异常类别、耗时和匿名化请求标识即可，不应记录完整代理 URL、Proxy-Authorization、Cookie 或响应中的敏感数据。

上线前检查

1. 锁定 Requests 与依赖版本并查看安全更新。
2. 明确代理协议和 DNS 解析位置。
3. 设置连接/读取超时及总体任务截止时间。
4. 为直连、代理失败、认证失败和目标失败分别测试。
5. 保持 TLS 验证开启，使用可信 CA 配置解决证书问题。

常见问题

继续阅读

• 代理 API 调用为什么需要超时、指数退避与随机抖动
• 代理接入日志怎么记录：可排障但不泄露凭据
• 用 curl 测试 HTTP 与 SOCKS5 代理：安全命令与结果判读