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

Прокси в pyppeteer и PuppeteerSharp: настройка и логин

Прокси указывается в аргументах запуска, а логин передаётся странице; ниже код для Python и C#.

Как обе библиотеки принимают прокси

pyppeteer и PuppeteerSharp запускают Chromium, поэтому прокси — это флаг Chromium в аргументах запуска: args в pyppeteer и Args в LaunchOptions PuppeteerSharp. Chromium ждёт значение флага в виде URI, например http://HOST:PORT.

В флаге нет места для логина и пароля. Передайте их странице через authenticate: она отвечает на запрос входа от прокси.

pyppeteer и PuppeteerSharp рядом

pyppeteer и PuppeteerSharp рядом
Пунктpyppeteer (Python)PuppeteerSharp (.NET)
Установкаpip install pyppeteer (Python 3.8 или новее)dotnet add package PuppeteerSharp
БраузерПо умолчанию встроенный ChromiumBrowserFetcher().DownloadAsync() скачивает браузер
Флаг проксиlaunch(args=["--proxy-server=..."])LaunchOptions { Args = new[] { "--proxy-server=..." } }
Логинawait page.authenticate({"username", "password"})await page.AuthenticateAsync(new Credentials { ... })
Состояние проектаВ README сказано, что проект не поддерживается, и советуют playwright-pythonПеред стартом посмотрите релизы проекта

По документации и исходному коду pyppeteer и PuppeteerSharp, прочитанным 16.11.2026.

pyppeteer: флаг прокси и логин

import asyncio
from pyppeteer import launch

async def main():
    browser = await launch(
        headless=True,
        args=["--proxy-server=http://HOST:2222"],
    )
    page = await browser.newPage()
    await page.authenticate({"username": "LOGIN", "password": "PASSWORD"})
    await page.goto("https://ipinfo.io/json")
    print(await page.evaluate("document.body.innerText"))
    await browser.close()

asyncio.run(main())

Только пример: HOST, LOGIN и PASSWORD замените значениями из «Мои активы».

PuppeteerSharp: флаг прокси и логин

using PuppeteerSharp;

await new BrowserFetcher().DownloadAsync();

await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    Args = new[] { "--proxy-server=http://HOST:2222" }
});
await using var page = await browser.NewPageAsync();
await page.AuthenticateAsync(new Credentials { Username = "LOGIN", Password = "PASSWORD" });
await page.GoToAsync("https://ipinfo.io/json");
Console.WriteLine(await page.EvaluateExpressionAsync<string>("document.body.innerText"));

Только пример: замените HOST, LOGIN и PASSWORD; код записан как операторы верхнего уровня консольного проекта .NET.

HTTP или SOCKS5

В документации Chromium сказано, что в Chrome для SOCKSv5 не поддерживается ни один способ аутентификации, поэтому SOCKS5-прокси с логином через --proxy-server не работает. Берите адрес HTTP с тем же логином: в Proxy302 это порт 2222.

Покупать заново нужно не всегда. Статический ISP IP, арендованный поштучно, подключается и по HTTP на порт 2222, а динамические резидентные и новый Fixed ISP за ГБ принимают оба порта с одними логином и паролем.

Один прокси на браузер, а не на страницу

--proxy-server — флаг процесса браузера, поэтому все страницы в этом браузере используют его. Для нескольких IP запускайте по браузеру на прокси либо направьте один браузер на ротационный шлюз, который выдаёт новый IP на каждое соединение.

В документации Puppeteer сказано, что authenticate в фоне включает перехват запросов, что может влиять на производительность. Эти библиотеки повторяют тот же API, поэтому перед масштабированием измерьте один запуск.

Стоит ли брать pyppeteer для нового проекта

В README pyppeteer репозиторий назван не поддерживаемым и рекомендован playwright-python. Если выбор свободен, в Playwright логин прокси входит в параметры запуска; если нужно остаться на pyppeteer, зафиксируйте версии и проверяйте настройку прокси при каждом обновлении.

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

  1. Шаг 1. Получите HTTP-прокси

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

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

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

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

  3. Шаг 3. Добавьте флаг и authenticate

    Скопируйте пример pyppeteer или PuppeteerSharp и подставьте свои значения.

  4. Шаг 4. Откройте ipinfo.io

    Запустите и прочитайте текст страницы.

    Ожидаемый результат Тот же IP, что на шаге 2.

  5. Шаг 5. Откройте реальную цель

    Меняйте тестовый адрес, только когда IP совпал.

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

Страница показывает ваш собственный IP

Проверьте Стоит ли флаг в аргументах запуска в виде --proxy-server=http://HOST:PORT, со схемой.

Решение Исправьте аргумент и запустите новый браузер: уже запущенный сохраняет старую настройку.

Когда остановиться Всё равно ваш IP: проверьте этот же адрес в curl.

ERR_PROXY_CONNECTION_FAILED

Проверьте Хост и порт и то, достаёт ли ваша сеть до порта прокси.

Решение Исправьте или проверьте из другой сети.

Когда остановиться Адрес и порт верны: см. инструкцию про ошибку соединения.

407 или окно входа

Проверьте Вызывается ли authenticate до первого перехода и скопирован ли логин целиком.

Решение Поставьте вызов authenticate выше goto и скопируйте логин заново.

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

Адрес SOCKS5 с логином не подключается

Проверьте Chrome не поддерживает аутентификацию SOCKS5.

Решение Используйте адрес HTTP, порт 2222.

Когда остановиться Не повторяйте попытки с SOCKS5 здесь: используйте HTTP на порту 2222.

Браузер не стартует после указания пути

Проверьте executablePath или ExecutablePath заменяет встроенный Chromium; pyppeteer предупреждает, что это рискованно.

Решение Уберите параметр и сначала возьмите встроенный браузер.

Когда остановиться Нужен свой Chrome: подберите версию, которую поддерживает библиотека.

pyppeteer и PuppeteerSharp: прокси, частые вопросы

Как задать прокси в pyppeteer?

Передайте в launch() args=["--proxy-server=http://HOST:PORT"], а перед первым goto вызовите await page.authenticate({"username": ..., "password": ...}).

Как задать прокси в PuppeteerSharp?

Положите "--proxy-server=http://HOST:PORT" в LaunchOptions.Args и вызовите page.AuthenticateAsync(new Credentials { Username = ..., Password = ... }).

Можно ли написать логин прямо в значении --proxy-server?

На это не стоит рассчитывать: флаг ждёт идентификатор прокси, а для логина в библиотеках есть authenticate.

Работает ли SOCKS5 с логином и паролем?

В Chrome нет: он не поддерживает аутентификацию SOCKS5. Используйте адрес HTTP на порту 2222.

Поддерживается ли pyppeteer?

В его README сказано, что репозиторий не поддерживается, и советуют playwright-python.

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

7
  1. Справочник pyppeteer: launch() и Page.authenticate

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

    Прочитано 16.11.2026: у launch() параметр args — список дополнительных флагов процесса браузера; executablePath заменяет встроенный Chromium, страница предупреждает, что это рискованно; Page.authenticate(credentials) принимает словарь с username и password.

  2. pyppeteer на GitHub

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

    Прочитано 16.11.2026: назван неофициальным портом puppeteer на Python; в заметке о статусе сказано, что репозиторий не поддерживается и давно получает лишь небольшие правки, рекомендован playwright-python; нужен Python 3.8 или новее.

  3. API PuppeteerSharp: LaunchOptions

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

    Прочитано 16.11.2026: LaunchOptions.Args — массив строк с дополнительными аргументами браузера; Headless по умолчанию true; ExecutablePath заменяет встроенный Chromium. На главной странице документации — команда dotnet add package PuppeteerSharp.

  4. Исходный код PuppeteerSharp: IPage.AuthenticateAsync

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

    Прочитано 16.11.2026: Task AuthenticateAsync(Credentials credentials) в IPage, класс Credentials с полями Username и Password; передача null отключает аутентификацию.

  5. Документация Puppeteer: Page.authenticate

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

    Прочитано 16.11.2026: задаёт данные для HTTP-аутентификации; для её реализации в фоне включается перехват запросов, что может влиять на производительность.

  6. Документация Chromium: поддержка прокси в Chrome

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

    Прочитано 16.11.2026: флаги командной строки вроде --proxy-server ждут идентификаторы прокси в формате URI; в Chrome для SOCKSv5 не поддерживается ни один способ аутентификации.

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

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

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

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

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