Прокси в Python requests: словарь proxies, переменные окружения и SOCKS5

Параметр proxies

В документации Requests сказано, что прокси можно задать для отдельного запроса через аргумент proxies — словарь, где ключ http или https означает схему целевого адреса. Обратите внимание: даже для ключа https в примерах документации указан URL прокси со схемой http://. Документация подчёркивает, что URL прокси должен содержать схему.

Если в логине или пароле есть специальные символы, закодируйте их. В документации Python сказано, что urllib.parse.quote по умолчанию оставляет символ / как безопасный (safe='/'), поэтому для пароля передайте safe=''.

Параметр proxies: пример

import requests
from urllib.parse import quote

user = quote("USERNAME", safe="")
password = quote("PASSWORD", safe="")
proxy = f"http://{user}:{password}@proxy.proxy302.com:2222"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=(5, 20))
print(r.json())

Замените USERNAME и PASSWORD значениями из «Мои активы». HTTP-прокси Proxy302 — порт 2222.

• Источники:
• Документация Requests: Advanced Usage (Proxies, SOCKS, Timeouts)
• Документация Python: urllib.parse.quote

Session и переменные окружения

Если proxies не передан в запрос, Requests использует стандартные переменные окружения http_proxy, https_proxy, no_proxy и all_proxy, в том числе в верхнем регистре. Документация предупреждает: хранить логин и пароль в переменной окружения или в файле под контролем версий — это риск для безопасности, и так делать настоятельно не рекомендуется.

Для Session документация показывает session.proxies.update(proxies), но предупреждает: значения, заданные так, могут быть перезаписаны прокси из окружения. Чтобы использовать именно свои прокси при наличии переменных окружения, передавайте proxies в каждом запросе явно.

Session и переменные окружения: пример

import requests

session = requests.Session()
r = session.get("https://ipinfo.io/json", proxies=proxies, timeout=(5, 20))
print(r.json())

proxies — тот же словарь, что в примере выше.

• Источники:
• Документация Requests: Advanced Usage (Proxies, SOCKS, Timeouts)

SOCKS5

В документации Requests сказано, что поддержка SOCKS — необязательная возможность, для неё нужны дополнительные библиотеки: python -m pip install 'requests[socks]'. После этого прокси задаётся так же, как HTTP-прокси, со схемой socks5:// в URL.

Схема важна: при socks5 разрешение DNS происходит на стороне клиента, а при socks5h — на стороне прокси. Документация советует socks5h, если домены нужно разрешать на прокси.

SOCKS5: пример

user = quote("USERNAME", safe="")
password = quote("PASSWORD", safe="")
socks = f"socks5h://{user}:{password}@proxy.proxy302.com:3333"
proxies = {"http": socks, "https": socks}

r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=(5, 20))
print(r.json())

Пример продолжает первый (нужны import requests и from urllib.parse import quote) и требует установленного requests[socks]. SOCKS5 у Proxy302 — порт 3333; HTTP — порт 2222.

• Источники:
• Документация Requests: Advanced Usage (Proxies, SOCKS, Timeouts)

Таймауты

По документации Requests, по умолчанию запросы не имеют таймаута, и без него код может зависнуть на минуты и дольше. Одно значение timeout применяется и к подключению, и к чтению; кортеж (подключение, чтение) позволяет задать их отдельно. Таймаут подключения — время ожидания установки соединения, таймаут чтения — ожидание ответа сервера. Если у домена несколько адресов, подключение пробуется к ним по очереди, поэтому общее время может оказаться во много раз больше.

• Источники:
• Документация Requests: Advanced Usage (Proxies, SOCKS, Timeouts)

Проверьте выход

Запросите https://ipinfo.io/json, как в примерах выше. Поля country и org должны описывать прокси, а не ваше подключение. Если виден ваш адрес, прокси не применён: проверьте ключи словаря proxies и то, что он передан в этот запрос. Поля объяснены в руководстве по проверке местоположения прокси.

• руководстве по проверке местоположения прокси

Типичные ошибки

В модуле исключений Requests ProxyError — подкласс ConnectionError с описанием «A proxy error occurred». ConnectTimeout означает, что истекло время при подключении к серверу, и запросы с такой ошибкой безопасно повторять; ReadTimeout — что сервер не прислал данные за отведённое время. Проверьте схему в URL прокси, порт (HTTP — 2222, SOCKS5 — 3333) и логин с паролем. Статус 407 означает, что прокси не принял учётные данные; см. руководство по ошибке аутентификации, а проверки по шагам — в руководстве по ошибке подключения. Документация Requests также отмечает, что для https через прокси обычно нужно, чтобы локальная машина доверяла корневому сертификату прокси.

• руководство по ошибке аутентификации
• руководстве по ошибке подключения

• Источники:
• Исходный код Requests: requests.exceptions
• Документация Requests: Advanced Usage (Proxies, SOCKS, Timeouts)

Как это сделать с Proxy302

Для requests нужны адрес, порт, логин и пароль прокси Proxy302. Трафик ротационных резидентных прокси оплачивается за ГБ, страна выхода задаётся при создании прокси; HTTP — порт 2222, SOCKS5 — порт 3333 на proxy.proxy302.com. Статический ISP IP фиксирован на весь срок аренды и не ротируется. В таблице — выходы в 7 странах при нашей последней почасовой проверке; зонд отправляет запрос к ChatGPT, это лишь пример целевого сайта для проверки сети. Прокси не меняет условия ChatGPT: OpenAI предупреждает, что доступ из стран вне её списка может привести к блокировке аккаунта; список стран — в руководстве по поддерживаемым странам. Подробности — на странице ротационных резидентных прокси и в руководстве по проверке местоположения прокси.

• странице ротационных резидентных прокси
• руководстве по проверке местоположения прокси
• руководстве по поддерживаемым странам

Измеренные выходы: ChatGPT, 7 стран

Почасовая проверка зонда Proxy302, 25 октября 2026, 08:29 UTC: по одному запросу к ChatGPT из каждой страны через ротационный резидентный выход, по публичной точке входа Proxy302. Публично показаны только первые три октета IP. Один замер на страну, не среднее; следующие проверки будут отличаться.

• Источники:
• Почасовая проверка связности Proxy302

Как это сделать с Proxy302: шаги

1. Шаг 1

   Откройте страницу ротационных резидентных прокси, выберите линию, оставьте протокол HTTP или выберите SOCKS5 и нажмите «Проверить цену и создать».

2. Шаг 2

   Откройте «Мои активы» (раздел консоли со всем, что вы купили) и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Подключение» есть готовый пример с вашими данными.

3. Шаг 3

   Введите данные в браузер или программу, которую вы настраиваете.

4. Шаг 4

   Подтвердите выход запросом к https://ipinfo.io/json через прокси.

5. Шаг 5

   Из материкового Китая сначала запустите вспомогательную программу на странице «Подключение» и держите её открытой, пока работает прокси.

   • Руководство по вспомогательной программе

Цены и ограничения

Бюджетная линия стоит $1,50 за ГБ, $1,35 за ГБ в пакете 100 ГБ и $1,20 за ГБ при 300 ГБ. Бесплатного пробного периода нет, а минимальная покупка составляет 1 ГБ. Набор доступных локаций меняется ежедневно.

• Источники:
• Факты о продуктах и прайс Proxy302

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

Читайте дальше

Адрес, порт, логин и пароль прокси

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

Ошибка 407: требуется авторизация на прокси

Ответ HTTP 407 приходит от прокси-сервера, а не от сайта, который вы пытаетесь открыть.

ERR_PROXY_CONNECTION_FAILED: что проверить

Ошибка ERR_PROXY_CONNECTION_FAILED появляется в Chrome и Edge, когда браузер не может установить соединение с прокси-сервером.

Как проверить прокси: IP, страна, провайдер

Как за 30 секунд проверить IP, страну и провайдера прокси, почему сервисы расходятся в городе и что значит «чистота» IP. С нашей проверкой трёх сервисов.