Интеграция прокси в Python: примеры

Обновлено 2026-10-18 Около 3 минут чтения

Передавайте настройки MantaProxy в каждом запросе Python к сайту или API. Сначала проверьте один прокси с помощью Requests, затем используйте конфигурацию в своём приложении. Настройки действуют только в программе и не меняют системный прокси.

1. Подготовьте параметры и Python

В разделе управления статическими прокси нажмите выходной IP и скопируйте из панели хост подключения, порт, имя пользователя и пароль прокси. Подготовьте Python 3. Команды ниже создают отдельное окружение и устанавливают Requests с поддержкой SOCKS.

macOS / Linux

python3 -m venv .venv
.venv/bin/python -m pip install "requests[socks]"

Windows PowerShell

py -m venv .venv
.\.venv\Scripts\python.exe -m pip install "requests[socks]"

2. Настройте HTTP или SOCKS5

Замените три значения YOUR_PROXY параметрами одного ресурса. Запускайте пример в том же терминале. Для хоста укажите только IP или домен, без протокола, порта и учётных данных. Программа отдельно запросит пароль; вводимые символы не отображаются.

macOS / Linux

export MANTA_PROXY_HOST="YOUR_PROXY_HOST"
export MANTA_PROXY_PORT="YOUR_PROXY_PORT"
export MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
export MANTA_PROXY_SCHEME="http"

Windows PowerShell

$env:MANTA_PROXY_HOST="YOUR_PROXY_HOST"
$env:MANTA_PROXY_PORT="YOUR_PROXY_PORT"
$env:MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
$env:MANTA_PROXY_SCHEME="http"

Для HTTP оставьте MANTA_PROXY_SCHEME=http, для SOCKS5 укажите socks5h. Ключи http и https описывают адрес назначения, а значения используют протокол прокси. Для сайта HTTPS не нужно менять URL HTTP-прокси на https://. socks5h передаёт разрешение домена прокси, socks5 выполняет его локально.

Полный пример: proxy_example.py

Сохраните код в proxy_example.py или скачайте файл. Специальные символы имени и пароля автоматически кодируются для URL. Программа выводит выходной IP, но не полный адрес прокси.

Скачать полный пример Python

"""Test one MantaProxy resource with Requests. Install: requests[socks]."""

import os
from getpass import getpass
from urllib.parse import quote

import requests


def build_proxies():
    required = ("MANTA_PROXY_HOST", "MANTA_PROXY_PORT", "MANTA_PROXY_USERNAME")
    missing = [name for name in required if not os.environ.get(name)]
    if missing:
        raise SystemExit("Set these variables first: " + ", ".join(missing))

    scheme = os.environ.get("MANTA_PROXY_SCHEME", "http").strip().lower()
    if scheme not in ("http", "socks5h"):
        raise SystemExit("MANTA_PROXY_SCHEME must be http or socks5h.")
    host = os.environ["MANTA_PROXY_HOST"].strip()
    if "://" in host or "/" in host or "@" in host:
        raise SystemExit("Use the host only, without a URL, port or credentials.")
    try:
        port = int(os.environ["MANTA_PROXY_PORT"])
        if not 1 <= port <= 65535:
            raise ValueError
    except ValueError:
        raise SystemExit("MANTA_PROXY_PORT must be a number from 1 to 65535.")

    username = os.environ["MANTA_PROXY_USERNAME"]
    password = os.environ.get("MANTA_PROXY_PASSWORD") or getpass("Proxy password: ")
    if not password:
        raise SystemExit("A proxy password is required.")
    if ":" in host and not host.startswith("["):
        host = "[" + host + "]"
    auth = quote(username, safe="") + ":" + quote(password, safe="")
    proxy_url = f"{scheme}://{auth}@{host}:{port}"
    return {"http": proxy_url, "https": proxy_url}


def main():
    proxies = build_proxies()
    with requests.Session() as session:
        session.trust_env = False
        try:
            response = session.get(
                "https://api.ipify.org?format=json",
                proxies=proxies,
                timeout=(10, 30),
            )
            response.raise_for_status()
            exit_ip = response.json()["ip"]
        except requests.exceptions.ProxyError:
            raise SystemExit("Proxy error: check host, port, protocol and credentials.")
        except requests.exceptions.Timeout:
            raise SystemExit("Timeout: check proxy reachability and the target site.")
        except requests.exceptions.SSLError:
            raise SystemExit("TLS error: check system time and trusted CA certificates.")
        except requests.exceptions.HTTPError as error:
            raise SystemExit(f"HTTP error: {error.response.status_code}")
        except requests.exceptions.RequestException:
            raise SystemExit("Request failed. Check the configuration and network.")
        except (ValueError, KeyError):
            raise SystemExit("The IP check did not return the expected JSON result.")
    print("Exit IP:", exit_ip)


if __name__ == "__main__":
    main()

trust_env=False исключает влияние переменных системного прокси на тест; проверка сертификатов HTTPS остаётся включённой. Если сеть организации требует собственный CA, явно задайте путь к доверенному сертификату в Session. Сервис без интерактивного ввода может получать MANTA_PROXY_PASSWORD через механизм управления секретами; локально используйте запрос пароля.

Использование конфигурации в своих запросах

Разместите код рядом с proxy_example.py и замените адрес своим URL. Сохраните обработку исключений из полного примера. Requests получает HTTP-ответ, но не выполняет JavaScript страницы.

import requests
from proxy_example import build_proxies

with requests.Session() as session:
    session.trust_env = False
    response = session.get(
        "https://example.com/",
        proxies=build_proxies(),
        timeout=(10, 30),
    )
    response.raise_for_status()
    print(response.status_code)

3. Запустите пример и проверьте выход

После задания параметров запустите файл из его каталога:

macOS / Linux

.venv/bin/python proxy_example.py

Windows PowerShell

.\.venv\Scripts\python.exe proxy_example.py
  1. Введите пароль выбранного прокси. При успехе появятся Exit IP и фактический адрес. IP из документации служат иллюстрацией и не подходят для подключения.
  2. Сравните результат с ожидаемым выходом ресурса, затем проверьте свой сайт с той же конфигурацией. Проверка IP и доступ к приложению — отдельные этапы.
  3. timeout=(10, 30) задаёт тайм-ауты соединения и чтения, а не общий лимит 30 секунд. Сначала проверьте один ресурс и запрос; нагрузку подбирайте с учётом тарифа и требований сайта.

4. Устранение неполадок

  • Не заданы MANTA_PROXY или неверный порт: Задайте переменные в терминале, где запускается файл. Порт должен быть числом из панели. Среда редактора и планировщика настраивается отдельно.
  • HTTP 407, ошибка авторизации или Proxy error: Проверьте хост, порт, протокол и данные именно этого прокси. Не используйте пароль сайта или другого ресурса. Ошибка 407 в туннеле HTTPS может отображаться как ProxyError.
  • Missing dependencies for SOCKS support: Установите requests[socks] тем же интерпретатором Python, которым запускается файл. Проверьте выбор виртуального окружения в IDE.
  • Тайм-аут или Read timed out: Проверьте срок действия ресурса и доступность хоста и порта из своей сети, затем сайт назначения. Простое увеличение тайм-аутов и повторов не определяет причину.
  • Ошибка проверки сертификата: Проверьте время системы, CA Python и требования сети организации. При необходимости явно укажите доверенный CA-файл. Не используйте verify=False для исправления подключения или авторизации.
  • Неожиданный выходной IP: Убедитесь, что запускается текущий файл и запрос получает proxies. Проверьте ресурс, выход, регион и доступ к сайту отдельно; передайте поддержке данные с замазанными секретами.

5. Официальная документация и другие инструкции

Requests: proxies / SOCKS · Requests: timeouts / errors · Python: urllib.parse.quote

Другие инструкции: Просмотр и копирование параметров · FAQ по протоколам и настройке · FAQ по диагностике соединения · Связаться с поддержкой

Была ли эта статья полезной?

Ваш отзыв помогает нам улучшить нашу документацию.