К содержимому

Python httpx и aiohttp через прокси: примеры

Готовый код httpx и aiohttp для HTTP-прокси с логином и шесть отличий между библиотеками.

Настройка в одной строке

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
Где указывается проксиproxy= у Client или AsyncClientproxy= в каждом запросе
ЛогинВ адресе: user:password@host:portВ адресе или в заголовках для прокси
Переменные окруженияИспользуются по умолчанию; trust_env=False отключаетИгнорируются по умолчанию; trust_env=True включает
SOCKS5pip install httpx[socks], затем адрес socks5://В aiohttp не описан; сторонний пакет aiohttp-socks добавляет коннектор
Таймаут по умолчаниюTimeoutException после 5 секунд без активности300 секунд всего, 30 секунд на подключение

По документации HTTPX и aiohttp и README aiohttp-socks, прочитанным 16.11.2026.

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

Только пример: прокси указывается в запросе, таймаут — в сессии.

SOCKS5 в httpx и aiohttp

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

Только пример: порт 3333 — SOCKS5 в Proxy302; для HTTP на 2222 дополнительный пакет не нужен.

Шесть подводных камней

1. В старых руководствах используется proxies=; в текущей документации httpx — proxy= и mounts, пользуйтесь ими. 2. Если на машине или в контейнере задан HTTP_PROXY, httpx применит его без вашей просьбы, а aiohttp его проигнорирует, пока вы не передадите trust_env=True. 3. Для SOCKS5 нужны httpx[socks] в httpx и aiohttp-socks в aiohttp.

4. Таймауты различаются: задавайте их явно в обеих библиотеках, чтобы один медленный запрос не определял длительность задачи. 5. Клиент или сессия держат соединения открытыми, а ротационная линия выдаёт новый IP на новое соединение, поэтому одно переиспользуемое соединение сохраняет один IP. 6. Новый клиент на каждый запрос лишает вас повторного использования соединений; держите один клиент и создавайте новый, только когда нужен новый IP.

Какой продукт Proxy302 взять для скрипта

Скрипту, который всегда должен выходить с одного адреса, например для вызова API с белым списком IP, нужен фиксированный IP: статический ISP IP стоит $0,50 за 1 день и $7,99 за 30 дней, IP дата-центра — $0,25 за 1 день и $3,99 за 30 дней. В обоих случаях IP не меняется в срок аренды.

Задаче сбора данных, которой нужно много выходов, подходит динамический резидентный трафик: $1,50 за ГБ в бюджетной линии, $5 за ГБ в премиум-линии, число одновременных соединений на динамических линиях не ограничено. Динамические прокси дата-центра стоят $0,40 за ГБ, выход только из США. Бесплатного теста нет.

Настройка и проверка выхода за 5 шагов

  1. Шаг 1. Выберите HTTP

    Купите IP с протоколом HTTP или используйте ротируемые резидентные на HTTP-порту 2222 и скопируйте HOST, PORT, LOGIN и PASSWORD из «Мои активы».

  2. Шаг 2. Проверьте curl

    Сначала выполните curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json.

    Ожидаемый результат JSON с IP и страной прокси.

  3. Шаг 3. Запустите пример httpx или aiohttp

    Подставьте три значения и запустите.

    Ожидаемый результат Тот же IP, что в проверке curl.

  4. Шаг 4. Задайте таймауты и лимит

    Добавьте явные таймауты, а в асинхронном коде — семафор.

  5. Шаг 5. Направьте на цель

    Меняйте ipinfo.io, только когда выход совпал.

Если не работает

httpx.ProxyError или ConnectError

Проверьте Хост, порт и то, что вы указали адрес http:// на порту 2222.

Решение Исправьте адрес и проверьте тот же адрес в curl.

Когда остановиться curl тоже не работает: проверьте сеть и адрес в «Мои активы».

407 Proxy Authentication Required

Проверьте Логин в адресе, особенно спецсимволы.

Решение Закодируйте пароль в процентной форме и скопируйте логин заново.

Когда остановиться То же в curl: откройте тикет с номером заказа.

aiohttp игнорирует прокси из окружения

Проверьте trust_env по умолчанию False.

Решение Передайте proxy= в запросе или создайте сессию с trust_env=True.

Когда остановиться Прокси всё равно нет: выведите IP выхода и сравните с curl.

ReadTimeout в httpx или зависание в aiohttp

Проверьте Таймауты по умолчанию: в httpx 5 секунд без активности, в aiohttp 300 секунд всего.

Решение Задайте явные таймауты и короткий повтор с паузой.

Когда остановиться Все запросы уходят в таймаут: сначала проверьте прокси в curl, потом меняйте код.

У всех запросов один и тот же IP

Проверьте Переиспользуемый клиент или сессия держит соединение открытым.

Решение Для нового IP создайте нового клиента или возьмите ротационную линию и несколько соединений.

Когда остановиться Один IP нужен намеренно: выберите сессию с одним IP или статический IP.

httpx и aiohttp с прокси: частые вопросы

Как использовать прокси в httpx?

Передайте proxy="http://LOGIN:PASSWORD@HOST:PORT" в httpx.Client или httpx.AsyncClient.

Как использовать прокси в aiohttp?

Передайте proxy="http://LOGIN:PASSWORD@HOST:PORT" в session.get или другой метод запроса aiohttp.ClientSession.

Поддерживает ли aiohttp SOCKS5?

Документация aiohttp описывает HTTP-прокси. Для SOCKS5 есть сторонний пакет aiohttp-socks с ProxyConnector.

Почему httpx использует прокси, которого я не задавал?

httpx по умолчанию читает HTTP_PROXY, HTTPS_PROXY и ALL_PROXY; передайте trust_env=False, чтобы отключить.

Сколько параллельных запросов можно отправлять?

Динамические линии не ограничивают число одновременных соединений, но сайт, к которому вы обращаетесь, может. Ограничьте собственный параллелизм семафором.

Ссылки и источники

7
  1. HTTPX: прокси

    Официальная документация · Проверено:

    Прочитано 16.11.2026: параметр proxy у Client и функций верхнего уровня; логин и пароль в userinfo адреса; mounts для маршрутизации HTTP и HTTPS на разные прокси; для SOCKS нужны pip install httpx[socks] и адрес socks5://. На странице описаны только proxy и mounts.

  2. HTTPX: переменные окружения

    Официальная документация · Проверено:

    Прочитано 16.11.2026: HTTP_PROXY, HTTPS_PROXY и ALL_PROXY задают прокси, NO_PROXY отключает его для отдельных адресов; переменные окружения используются по умолчанию, trust_env=False это отключает.

  3. HTTPX: таймауты

    Официальная документация · Проверено:

    Прочитано 16.11.2026: по умолчанию TimeoutException после 5 секунд без сетевой активности; таймауты connect, read, write и pool; httpx.Timeout(10.0, connect=60.0).

  4. aiohttp: расширенное использование клиента

    Официальная документация · Проверено:

    Прочитано 16.11.2026: proxy= принимает адрес, поддерживаются обычные HTTP-прокси и HTTP-прокси, которые поднимаются до HTTPS через CONNECT; логин можно указать в адресе прокси; aiohttp по умолчанию не читает переменные окружения прокси, trust_env=True это включает; поддержка прокси, к которым подключаются по https://, ограничена; SOCKS не упоминается.

  5. aiohttp: справочник клиента

    Официальная документация · Проверено:

    Прочитано 16.11.2026: таймаут ClientSession по умолчанию — 300 секунд всего и 30 секунд на подключение сокета; trust_env по умолчанию False.

  6. aiohttp-socks на GitHub

    Сторонний источник · Проверено:

    Прочитано 16.11.2026: pip install aiohttp_socks; ProxyConnector.from_url("socks5://user:[email protected]:1080"); поддерживает прокси SOCKS4, SOCKS5 и HTTP CONNECT. Это сторонний пакет, а не часть aiohttp.

  7. Факты о продуктах Proxy302 и прайс

    Наблюдение за продуктом · Проверено:

    Файл фактов сайта, проверен 16.11.2026: цены в US$ (1 PTC = US$1), сроки аренды, протоколы и порты (HTTP 2222, SOCKS5 3333), по какому протоколу подключается каждый продукт, страны и города, бесплатного теста нет.

Готовы попробовать?

Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.