Python Requests 代理怎么配置？四种方式与验证

Session 配置

import requests
session = requests.Session()
session.proxies.update({"http": proxy_url, "https": proxy_url})
response = session.get("https://TARGET.EXAMPLE", timeout=(5, 20))
response.raise_for_status()

多个授权请求需要复用代理设置和连接状态时可以使用 Session；长时间运行的代码应使用上下文管理器及时关闭。

Session 还可能保留 Cookie 和请求头，只有授权流程确实需要同一状态时才应复用。独立样本应创建不同 Session 并标注结果，避免无意继承前一次状态。

环境变量配置

# 在运行环境中设置，不要提交到代码仓库
HTTP_PROXY=http://USERNAME:PASSWORD@HOST:PORT
HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT

环境变量适合让同一运行环境中的工具继承设置，但影响范围比单次请求更大。任务结束后应清理，也不要把它写进已提交的配置文件。

环境变量便于部署工具继承设置，但也可能影响测试或子进程。日志中只记录变量是否存在，不记录完整值；范围内任务结束后应及时清理。

最终选择前，先确认这次任务到底需要连续复核，还是需要多个独立样本。

静态住宅地址的重点是连续性，动态住宅地址的重点是独立样本。两者都不应被写成结果保证。

需要进一步了解时，可以查看 静态住宅代理说明、动态住宅代理说明 和 IPIPD 价格页。

命令和参数以 Requests 代理官方文档 为技术核对依据。

检查完成后：SOCKS5 与 DNS 解析

python -m pip install "requests[socks]"
proxies = {
"http": "socks5h://USERNAME:PASSWORD@HOST:PORT",
"https": "socks5h://USERNAME:PASSWORD@HOST:PORT",
}

socks5 表示本机解析目标域名，socks5h 表示由代理端点解析。只能使用账号实际分配的协议。

安装 requests[socks] 只是增加可选的 SOCKS 传输依赖，并不代表已分配端点一定支持 SOCKS5。代码中的 scheme 必须与账号实际获得的协议一致。

超时、异常与出口验证

import requests
try:
r = requests.get("https://IP-ECHO.EXAMPLE", proxies=proxies, timeout=(5, 20))
r.raise_for_status()
print(r.text)
except requests.exceptions.ProxyError:
print("检查协议、主机、端口与认证字段")
except requests.exceptions.Timeout:
print("连接或读取超时")
except requests.exceptions.RequestException as exc:
print(type(exc).name)

不要打印可能含有凭证的 URL 或异常详情。记录中保留允许使用的响应、状态、耗时、端点标签和恢复动作。

示例仅用于已授权的公开页面核验和连接测试，并应使用账号实际分配的协议与认证字段。本文对 IPIPD 产品的表述只限静态住宅地址和动态住宅地址，不承诺访问或平台结果。

ProxyError、Timeout 和更广泛的 RequestException 应分别处理，让操作人员知道该检查端点字段、时间限制还是目标响应。异常输出中不要保留凭证或完整代理 URL。

Python 运行时配置如何交接

Python 交接记录应保存 Python 与 Requests 版本、依赖安装方式、配置范围、timeout、异常类型和 Session 关闭方式。仓库中只保留占位符，认证 URL 由受保护的运行时配置生成。

复核人员要确认当前程序究竟使用单次 proxies 字典、Session.proxies，还是继承环境变量。环境变量可能影响子进程，Session 可能保留 Cookie 和请求头，测试结束后应分别清理。

在代码结构中把网络配置与业务逻辑分开，测试使用固定的授权公开目标。静态住宅地址用于保持一次连续核验条件，动态住宅地址用于独立样本；异常日志不得输出完整代理 URL。

最终记录还应说明出口验证端点、状态码、耗时和恢复动作。无法确认协议、凭证来源、目标授权或返回内容时，应停止程序并关闭 Session，而不是增加并发或目标范围。

自动化测试可以分别覆盖四条路径：单次 proxies 字典是否只影响当前请求，Session 是否按预期复用设置，环境变量清理后是否恢复直连，以及 socks5h 是否按预期改变域名解析位置。每条测试都使用虚拟凭证和固定公开目标，并断言异常类型而不是敏感错误全文。这样升级 Requests 或运行环境后，可以快速发现具体而明显的行为变化。