---
title: "Python Requests 代理设置（HTTP 与 SOCKS5） | Proxonym"
description: "为 Python Requests 配置轮换代理：proxies 字典、身份验证、按国家和城市定位、粘性会话、SOCKS5 以及 502 错误重试。"
url: https://proxonym.com/zh/integrations/python-requests
updated: 2026-10-02T03:03:46+00:00
---

# 如何在 Python Requests 中使用代理

Requests 只需一个 proxies 字典，即可通过 Proxonym 发送流量。本指南涵盖身份认证、地理定位、轮换 IP 与粘性 IP、SOCKS5，以及网关错误的重试。

- 共 6 步
- 12 分钟完成配置
- 复制即用的代码

开始之前

- Python 3.10 或更高版本
- Requests 2.x；如需 SOCKS5，还需安装 socks 可选依赖
- Proxonym 住宅代理或移动代理套餐

连接参数

- **主机**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **用户名**: `USERNAME-country-us`

1. **安装 Requests**: 使用 pip 安装 Requests。socks 可选依赖会一并安装 PySocks，只有使用 SOCKS5 端点时才需要它。 Shell `python -m pip install requests python -m pip install "requests[socks]" # only for SOCKS5`
2. **通过网关发送请求**: 将凭据写入代理 URL，并将其同时用于 `http` 和 `https` 两个键。HTTPS 目标通过 CONNECT 隧道传输，因此代理 URL 本身仍使用 `http://` 协议前缀。 Python `import requests PROXY = "http://USERNAME:PASSWORD@gw.proxonym.com:8000" proxies = {"http": PROXY, "https": PROXY} response = requests.get("https://api.ipify.org", proxies=proxies, timeout=60) print("Exit IP:", response.text)`
3. **定位国家、州、城市或 ASN**: 这个辅助函数会根据关键字参数，按网关要求的顺序构建用户名。使用小写的 ISO 国家代码，空格用下划线代替，州和城市二选一，不要同时指定。 Python `import requests def proxy_for(**params): """proxy_for(country="us", city="new_york", session="a7k2", lifetime=30)""" user = "USERNAME" for key in ("country", "state", "city", "asn", "session", "lifetime"): if key in params: user += f"-{key}-{params[key]}" url = f"http://{user}:PASSWORD@gw.proxonym.com:8000" return {"http": url, "https": url} for proxies in ( proxy_for(country="us", city="new_york"), proxy_for(country="de", state="bavaria"), proxy_for(country="us", asn=7922), ): info = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=60).json() print(info["ip"], info.get("city"), info.get("country"))`
4. **轮换 IP 或保持同一 IP**: 不带会话参数时，每个新连接都会获得一个新 IP，而 `requests.get()` 每次调用都会建立新连接。复用上一步的 `proxy_for()`，添加一个最多 32 位字母和数字的会话 ID，即可将同一 IP 最长保持 120 分钟。 Python `import secrets import requests # Rotating: a new exit IP on every call for _ in range(3): print(requests.get("https://api.ipify.org", proxies=proxy_for(country="us"), timeout=60).text) # Sticky: the same exit IP for up to 30 minutes sticky = proxy_for(country="us", session=secrets.token_hex(4), lifetime=30) for _ in range(3): print(requests.get("https://api.ipify.org", proxies=sticky, timeout=60).text)`
5. **使用 SOCKS5 端点**: 安装 PySocks 后，将两个键都指向 1080 端口。`socks5h://` 协议前缀会在代理端解析主机名，使 DNS 查询不经过您自己的网络。 Python `import requests PROXY = "socks5h://USERNAME-country-gb:PASSWORD@gw.proxonym.com:1080" proxies = {"http": PROXY, "https": PROXY} print(requests.get("https://api.ipify.org", proxies=proxies, timeout=60).text)`
6. **重试网关错误**: 为暂时性故障挂载重试策略，并捕获 `ProxyError`：网关拒绝建立隧道时，Requests 会抛出该异常。重试无法解决 407、402 或 403，请先修正凭据、余额或目标网站方面的问题。 Python `import requests from requests.adapters import HTTPAdapter from urllib3.util.retry import Retry retry = Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 504]) session = requests.Session() session.mount("http://", HTTPAdapter(max_retries=retry)) session.mount("https://", HTTPAdapter(max_retries=retry)) PROXY = "http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000" proxies = {"http": PROXY, "https": PROXY} try: response = session.get("https://example.com", proxies=proxies, timeout=(10, 60)) response.raise_for_status() print(response.status_code, len(response.text)) except requests.exceptions.ProxyError as exc: # The message includes the gateway status, for example 407 or 502 print("Gateway refused the tunnel:", exc) except requests.exceptions.RequestException as exc: print("Request failed:", exc)`

## 常见问题

### 为什么 Requests 报错“Tunnel connection failed: 407”？

网关拒绝了代理 URL 中的凭据。请从控制台重新复制用户名和密码，用短横线连接定位参数，并对密码中的特殊字符进行 URL 编码。如果同一段代码在一台机器上正常、在另一台上却失败，请检查是否有 HTTPS_PROXY 环境变量覆盖了您的设置。

### Requests 支持 SOCKS5 代理吗？

支持，只需用 pip install "requests[socks]" 安装 socks 可选依赖（会一并安装 PySocks）。使用 socks5h://USERNAME:PASSWORD@gw.proxonym.com:1080，让主机名在代理端解析。定位参数和会话参数的用法与 HTTP 端点相同，因此切换协议时无需修改用户名。

### 如何并行发送大量请求？

Requests 是同步库，因此请在 ThreadPoolExecutor 中执行调用，或改用 httpx、aiohttp 等异步客户端。Proxonym 不限并发会话数，每个账户的突发请求上限约为每秒 10,000 次，因此实际瓶颈通常在目标网站。如果某个工作线程需要稳定的 IP，请为它分配独立的会话 ID。

### 可以用 httpx 或 aiohttp 代替 Requests 吗？

可以。在 httpx 中，创建 Client 或 AsyncClient 时传入 proxy="http://USERNAME:PASSWORD@gw.proxonym.com:8000"。在 aiohttp 中，将同一个 URL 作为每个请求的 proxy 参数传入。这两个库都会使用连接池，因此复用同一连接的请求，在连接关闭前都会沿用同一个出口 IP。

技巧与注意事项

- 如果密码中含有 @、: 或 /，请先用 urllib.parse.quote(password, safe="") 进行 URL 编码，再写入代理 URL。
- requests.Session 会复用连接，因此即使不带会话参数，对同一主机的调用也会一直使用同一个出口 IP，直到该连接关闭。
- HTTPS_PROXY 等环境变量的优先级高于在 Session 上设置的代理，因此请在每次调用时传入 proxies=，或设置 session.trust_env = False。
- 务必设置超时：Requests 默认会无限期等待，而网关会在目标请求超过 60 秒后以 504 结束请求。

延伸阅读

- [Python Requests 代理指南：认证、轮换、重试与 SOCKS5](https://proxonym.com/zh/blog/python-requests-proxies)
- [网页抓取防封禁：12 个实用技巧](https://proxonym.com/zh/blog/web-scraping-without-getting-blocked)

卡在某一步了？

大多数故障都可以从错误代码中找到原因。请先查看错误代码，再单独测试代理。

- [帮助中心](https://proxonym.com/zh/help)
- [网关错误代码](https://proxonym.com/zh/docs#errors-and-troubleshooting)
- [测试您的代理](https://proxonym.com/zh/proxy-checker)

## 更多集成指南

[全部集成](https://proxonym.com/zh/integrations)

- [Scrapy (Python 框架)](https://proxonym.com/zh/integrations/scrapy)
- [Selenium (Python 库)](https://proxonym.com/zh/integrations/selenium)
- [AdsPower (指纹浏览器)](https://proxonym.com/zh/integrations/adspower)
