httpx.ProxyError 或 ConnectError
检查 地址、端口,以及用的是不是 2222 端口的 http:// 地址。
处理 改正网址,用 curl 测同一个网址。
停止条件 curl 也失败:检查你的网络和“我的资产”里的地址。
带账号密码的 HTTP 代理,httpx 和 aiohttp 的现成代码,以及两个库之间六处不一样的地方。
httpx 在创建客户端时接收代理:httpx.Client(proxy=URL) 或 httpx.AsyncClient(proxy=URL),账号密码写在网址里,格式 user:password@host:port。aiohttp 是每个请求单独传:session.get(url, proxy=URL),带账号密码的写法一样。
两个库里都用代理的 HTTP 地址(Proxy302 是 2222 端口)。密码里有 @ 或 : 这类字符时,要在网址里做百分号编码,比如用 urllib.parse.quote。
| 项目 | httpx | aiohttp |
|---|---|---|
| 代理写在哪 | Client 或 AsyncClient 的 proxy= | 每个请求的 proxy= |
| 账号密码 | 写在网址里:user:password@host:port | 写在网址里,或作为发给代理的请求头 |
| 环境变量 | 默认使用;trust_env=False 可关闭 | 默认忽略;trust_env=True 才启用 |
| SOCKS5 | pip install httpx[socks],再用 socks5:// 网址 | aiohttp 本身没有涉及;第三方 aiohttp-socks 包提供连接器 |
| 默认超时 | 无活动 5 秒后抛 TimeoutException | 总共 300 秒,连接 30 秒 |
来自 2026-11-16 读到的 HTTPX、aiohttp 文档和 aiohttp-socks 的 README。
import httpx
PROXY = "http://LOGIN:PASSWORD@HOST:2222"
with httpx.Client(proxy=PROXY, timeout=httpx.Timeout(20.0, connect=10.0)) as client:
print(client.get("https://ipinfo.io/json").json())
仅为示例:LOGIN、PASSWORD、HOST 换成“我的资产”里的值。
import asyncio
import httpx
PROXY = "http://LOGIN:PASSWORD@HOST:2222"
async def fetch(client, sem, url):
async with sem:
r = await client.get(url)
return r.status_code
async def main(urls):
sem = asyncio.Semaphore(10) # your own cap on parallel requests
async with httpx.AsyncClient(proxy=PROXY, timeout=20.0) as client:
print(await asyncio.gather(*(fetch(client, sem, u) for u in urls)))
asyncio.run(main(["https://ipinfo.io/json"] * 3))
仅为示例:信号量是你自己的上限,按目标网站能接受的程度调整。
import asyncio
import aiohttp
PROXY = "http://LOGIN:PASSWORD@HOST:2222"
async def main():
timeout = aiohttp.ClientTimeout(total=30, connect=10)
async with aiohttp.ClientSession(timeout=timeout) as session:
async with session.get("https://ipinfo.io/json", proxy=PROXY) as resp:
print(await resp.json())
asyncio.run(main())
仅为示例:代理写在请求上,超时写在 session 上。
# pip install "httpx[socks]" aiohttp_socks
import asyncio
import aiohttp
import httpx
from aiohttp_socks import ProxyConnector
SOCKS = "socks5://LOGIN:PASSWORD@HOST:3333"
# httpx
with httpx.Client(proxy=SOCKS) as client:
print(client.get("https://ipinfo.io/json").json())
# aiohttp: SOCKS goes through a connector, not the proxy= argument
async def main():
connector = ProxyConnector.from_url(SOCKS)
async with aiohttp.ClientSession(connector=connector) as session:
async with session.get("https://ipinfo.io/json") as resp:
print(await resp.json())
asyncio.run(main())
仅为示例:Proxy302 的 SOCKS5 端口是 3333;用 2222 的 HTTP 不需要额外的包。
1. 旧教程用 proxies=;httpx 现在的文档里是 proxy= 和 mounts,请用这两个。2. 你的机器或容器里设了 HTTP_PROXY,httpx 会不打招呼就用上,aiohttp 则忽略它,除非传 trust_env=True。3. SOCKS5 在 httpx 里要 httpx[socks],在 aiohttp 里要 aiohttp-socks。
4. 超时不一样:两个库都显式设置,别让一个慢请求决定任务跑多久。5. 客户端或 session 会保持连接,轮换线路每个新连接换一个 IP,所以复用一条连接就是同一个 IP。6. 每个请求都新开客户端会丢掉连接复用;复用一个客户端,只在想换 IP 时才新建。
脚本必须始终从同一个地址出去,比如调用有 IP 白名单的 API,就需要固定 IP:静态 ISP IP 1 天 US$0.50、30 天 US$7.99,机房 IP 1 天 US$0.25、30 天 US$3.99,租期内都保持同一个 IP。
需要很多出口的采集任务适合动态住宅流量:低价线路 US$1.50/GB,优质线路 US$5/GB,动态线路不限并发连接数。动态机房代理 US$0.40/GB,只有美国出口。没有免费试用。
买 IP 时选 HTTP,或用动态住宅的 HTTP 端口 2222,到“我的资产”复制地址、端口、账号、密码。
先运行 curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json。
预期结果 返回代理 IP 和国家的 JSON。
填上三个值运行。
预期结果 和 curl 测到的是同一个 IP。
显式加上超时,异步代码再加信号量。
出口对上之后才把 ipinfo.io 换掉。
检查 地址、端口,以及用的是不是 2222 端口的 http:// 地址。
处理 改正网址,用 curl 测同一个网址。
停止条件 curl 也失败:检查你的网络和“我的资产”里的地址。
检查 网址里的账号密码,尤其是特殊字符。
处理 给密码做百分号编码,重新复制账号。
停止条件 curl 同样的结果:带订单号提交工单。
检查 trust_env 默认是 False。
处理 在请求上传 proxy=,或创建 session 时传 trust_env=True。
停止条件 仍然没走代理:打印出口 IP,和 curl 对比。
检查 默认超时:httpx 无活动 5 秒,aiohttp 总共 300 秒。
处理 显式设置超时,再加一个带间隔的短重试。
停止条件 每个请求都超时:先用 curl 测代理,再改代码。
检查 复用的客户端或 session 保持着连接。
处理 想换 IP 就新建客户端,或选轮换线路并开多条连接。
停止条件 你就是要同一个 IP:选会话保持或静态 IP。
给 aiohttp.ClientSession 的 session.get 或其他请求方法传 proxy="http://LOGIN:PASSWORD@HOST:PORT"。
aiohttp 文档讲的是 HTTP 代理。SOCKS5 要用第三方的 aiohttp-socks 包,它提供 ProxyConnector。
官方文档 · 确认日期:
2026-11-16 读到:Client 和顶层函数都有 proxy 参数;账号密码写在网址的 userinfo 里;mounts 可把 HTTP 和 HTTPS 路由到不同代理;SOCKS 需要 pip install httpx[socks] 和 socks5:// 网址。该页只记载 proxy 和 mounts。
官方文档 · 确认日期:
2026-11-16 读到:HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 设置代理,NO_PROXY 对特定网址关闭代理;默认就会使用环境变量,trust_env=False 可关闭。
官方文档 · 确认日期:
2026-11-16 读到:默认在网络无活动 5 秒后抛出 TimeoutException;有 connect、read、write、pool 四种超时;httpx.Timeout(10.0, connect=60.0)。
官方文档 · 确认日期:
2026-11-16 读到:proxy= 接收一个网址,支持普通 HTTP 代理和用 CONNECT 升级到 HTTPS 的 HTTP 代理;账号密码可以写在代理网址里;aiohttp 默认不读代理环境变量,trust_env=True 才启用;通过 https:// 连接的代理支持有限;没有提到 SOCKS。
官方文档 · 确认日期:
2026-11-16 读到:ClientSession 默认总超时 300 秒、套接字连接超时 30 秒;trust_env 默认为 False。
外部网站资料 · 确认日期:
2026-11-16 读到:pip install aiohttp_socks;ProxyConnector.from_url("socks5://user:[email protected]:1080");支持 SOCKS4、SOCKS5 和 HTTP CONNECT 代理。这是第三方包,不属于 aiohttp。
产品观察 · 确认日期:
站内产品事实表,2026-11-16 核对:价格(US$,1 PTC = US$1)、租期、协议与端口(HTTP 2222、SOCKS5 3333)、各产品能用哪种协议连接、国家与城市定向、无免费试用。
注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。