Как использовать прокси в Python с requests, httpx и aiohttp

URL прокси#

Каждая HTTP-библиотека Python принимает прокси в виде URL. В HodlProxy URL содержит учётные данные и параметры таргетинга в имени пользователя; имя хоста указывает шлюз, а порт выбирает протокол.

# Ротация IP: новый домашний выходной узел в США при каждом новом подключении
http://USER-cc-us:[email protected]:9000

# Закреплённая сессия: один домашний выходной узел в Берлине на 30 минут с идентификатором "job42"
http://USER-cc-de-city-berlin-sid-job42-ttl-30m:[email protected]:9000

# SOCKS5 с удалённым DNS (socks5h), параметры те же
socks5h://USER-cc-us:[email protected]:9001

requests#

Передайте один и тот же URL для http и https; requests автоматически использует CONNECT для целей HTTPS. Объект Session повторно использует соединения, поэтому выходной узел не меняется до закрытия соединения; создавайте отдельный Session для каждой закреплённой задачи, а для нового выходного узла при каждом запросе вызывайте обычный requests.get.

import requests

PROXY = "http://USER-cc-us:[email protected]:9000"
proxies = {"http": PROXY, "https": PROXY}

# Один запрос — один выходной узел
r = requests.get("https://api.ipify.org", proxies=proxies, timeout=30)
print(r.text)

# Закреплённая последовательность: один выходной узел для всех запросов этой сессии
sticky = "http://USER-cc-de-city-berlin-sid-cart42-ttl-15m:[email protected]:9000"
s = requests.Session()
s.proxies = {"http": sticky, "https": sticky}
s.get("https://example.com/product/1", timeout=30)
s.post("https://example.com/cart", json={"id": 1}, timeout=30)

httpx#

httpx принимает один аргумент proxy= (в старых версиях — proxies=). Библиотека поддерживает HTTP/2 до цели через туннель CONNECT и работает так же в асинхронном коде.

import httpx

PROXY = "http://USER-cc-us:[email protected]:9000"

with httpx.Client(proxy=PROXY, timeout=30) as client:
    print(client.get("https://api.ipify.org").text)

# Асинхронный режим: один закреплённый выходной узел на задачу
import asyncio

async def fetch(sid: str, url: str) -> str:
    proxy = f"http://USER-cc-us-sid-{sid}-ttl-10m:[email protected]:9000"
    async with httpx.AsyncClient(proxy=proxy, timeout=30) as client:
        return (await client.get(url)).text

asyncio.run(fetch("task1", "https://api.ipify.org"))

aiohttp#

aiohttp позволяет задавать прокси для каждого запроса или сессии и изначально поддерживает HTTP-прокси; для SOCKS5 требуется коннектор aiohttp-socks.

import aiohttp, asyncio

PROXY = "http://USER-cc-us:[email protected]:9000"

async def main():
    async with aiohttp.ClientSession() as session:
        async with session.get("https://api.ipify.org", proxy=PROXY, timeout=aiohttp.ClientTimeout(total=30)) as r:
            print(await r.text())

asyncio.run(main())

Ротация IP, keep-alive и повторные попытки#

• Новое TCP-соединение означает новый выходной узел. requests.get без Session открывает его при каждом вызове; Session или Client из httpx поддерживает соединения, а значит, сохраняет выходной узел, пока пул не обновит соединение.
• Чтобы получить новый выходной узел внутри сессии, измените значение -sid-; чтобы получать новый при каждом запросе, отправляйте Connection: close.
• При ошибках 403, 429 и ошибках соединения повторите запрос один раз: на шлюзе с ротацией IP повторная попытка будет выглядеть как другой посетитель. Никогда не меняйте выходной узел при повторной попытке посреди закреплённой последовательности.
• Настройте тайм-ауты с учётом типа выходного узла: для резидентских прокси 15 с на подключение и 45 с на чтение, для мобильных — больше.

Как экономить гигабайты#

Трафик резидентских прокси оплачивается за гигабайт в обоих направлениях. Запрашивайте сжатые ответы (в этих библиотеках Accept-Encoding: gzip, br включён по умолчанию), предпочитайте конечные точки JSON страницам HTML и не загружайте изображения, шрифты и мультимедиа, если они не являются нужными данными. Страница размером 350 КБ обходится дёшево, а страница размером 4 МБ с ресурсами — нет.

Частые вопросы#