跳到正文

Python httpx、aiohttp 代理:同步异步示例

带账号密码的 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 对照

httpx 和 aiohttp 对照
项目httpxaiohttp
代理写在哪Client 或 AsyncClient 的 proxy=每个请求的 proxy=
账号密码写在网址里:user:password@host:port写在网址里,或作为发给代理的请求头
环境变量默认使用;trust_env=False 可关闭默认忽略;trust_env=True 才启用
SOCKS5pip install httpx[socks],再用 socks5:// 网址aiohttp 本身没有涉及;第三方 aiohttp-socks 包提供连接器
默认超时无活动 5 秒后抛 TimeoutException总共 300 秒,连接 30 秒

来自 2026-11-16 读到的 HTTPX、aiohttp 文档和 aiohttp-socks 的 README。

httpx 同步写法

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 换成“我的资产”里的值。

httpx 异步写法,限制并行请求数

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))

仅为示例:信号量是你自己的上限,按目标网站能接受的程度调整。

aiohttp

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 上。

httpx 与 aiohttp 用 SOCKS5

# 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 时才新建。

脚本用 Proxy302 的哪种产品

脚本必须始终从同一个地址出去,比如调用有 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,只有美国出口。没有免费试用。

五步设置并检查出口

  1. 第 1 步:选 HTTP

    买 IP 时选 HTTP,或用动态住宅的 HTTP 端口 2222,到“我的资产”复制地址、端口、账号、密码。

  2. 第 2 步:先用 curl 测

    先运行 curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json。

    预期结果 返回代理 IP 和国家的 JSON。

  3. 第 3 步:跑 httpx 或 aiohttp 示例

    填上三个值运行。

    预期结果 和 curl 测到的是同一个 IP。

  4. 第 4 步:设超时和上限

    显式加上超时,异步代码再加信号量。

  5. 第 5 步:对准目标网站

    出口对上之后才把 ipinfo.io 换掉。

不好用时

httpx.ProxyError 或 ConnectError

检查 地址、端口,以及用的是不是 2222 端口的 http:// 地址。

处理 改正网址,用 curl 测同一个网址。

停止条件 curl 也失败:检查你的网络和“我的资产”里的地址。

407 Proxy Authentication Required

检查 网址里的账号密码,尤其是特殊字符。

处理 给密码做百分号编码,重新复制账号。

停止条件 curl 同样的结果:带订单号提交工单。

aiohttp 不理会环境变量里设的代理

检查 trust_env 默认是 False。

处理 在请求上传 proxy=,或创建 session 时传 trust_env=True。

停止条件 仍然没走代理:打印出口 IP,和 curl 对比。

httpx 报 ReadTimeout,或 aiohttp 卡住

检查 默认超时:httpx 无活动 5 秒,aiohttp 总共 300 秒。

处理 显式设置超时,再加一个带间隔的短重试。

停止条件 每个请求都超时:先用 curl 测代理,再改代码。

每个请求都是同一个 IP

检查 复用的客户端或 session 保持着连接。

处理 想换 IP 就新建客户端,或选轮换线路并开多条连接。

停止条件 你就是要同一个 IP:选会话保持或静态 IP。

httpx 与 aiohttp 代理常见问题

httpx 怎么用代理?

给 httpx.Client 或 httpx.AsyncClient 传 proxy="http://LOGIN:PASSWORD@HOST:PORT"。

aiohttp 怎么用代理?

给 aiohttp.ClientSession 的 session.get 或其他请求方法传 proxy="http://LOGIN:PASSWORD@HOST:PORT"。

aiohttp 支持 SOCKS5 吗?

aiohttp 文档讲的是 HTTP 代理。SOCKS5 要用第三方的 aiohttp-socks 包,它提供 ProxyConnector。

httpx 为什么用了我没设的代理?

httpx 默认读取 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY;传 trust_env=False 可以关掉。

可以同时发多少个请求?

动态线路不限并发连接数,但你访问的网站可能限。用信号量给自己的并发设上限。

参考资料

7
  1. HTTPX:代理

    官方文档 · 确认日期:

    2026-11-16 读到:Client 和顶层函数都有 proxy 参数;账号密码写在网址的 userinfo 里;mounts 可把 HTTP 和 HTTPS 路由到不同代理;SOCKS 需要 pip install httpx[socks] 和 socks5:// 网址。该页只记载 proxy 和 mounts。

  2. HTTPX:环境变量

    官方文档 · 确认日期:

    2026-11-16 读到:HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 设置代理,NO_PROXY 对特定网址关闭代理;默认就会使用环境变量,trust_env=False 可关闭。

  3. HTTPX:超时

    官方文档 · 确认日期:

    2026-11-16 读到:默认在网络无活动 5 秒后抛出 TimeoutException;有 connect、read、write、pool 四种超时;httpx.Timeout(10.0, connect=60.0)。

  4. aiohttp:客户端进阶用法

    官方文档 · 确认日期:

    2026-11-16 读到:proxy= 接收一个网址,支持普通 HTTP 代理和用 CONNECT 升级到 HTTPS 的 HTTP 代理;账号密码可以写在代理网址里;aiohttp 默认不读代理环境变量,trust_env=True 才启用;通过 https:// 连接的代理支持有限;没有提到 SOCKS。

  5. aiohttp:客户端参考

    官方文档 · 确认日期:

    2026-11-16 读到:ClientSession 默认总超时 300 秒、套接字连接超时 30 秒;trust_env 默认为 False。

  6. GitHub 上的 aiohttp-socks

    外部网站资料 · 确认日期:

    2026-11-16 读到:pip install aiohttp_socks;ProxyConnector.from_url("socks5://user:[email protected]:1080");支持 SOCKS4、SOCKS5 和 HTTP CONNECT 代理。这是第三方包,不属于 aiohttp。

  7. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站内产品事实表,2026-11-16 核对:价格(US$,1 PTC = US$1)、租期、协议与端口(HTTP 2222、SOCKS5 3333)、各产品能用哪种协议连接、国家与城市定向、无免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。