Настройка прокси в Puppeteer: авторизация, SOCKS5 и ротация IP | Proxy302

Что нужно до начала

Проект Node.js с установленным Puppeteer и скриптом, который запускает браузер.

Аккаунт Proxy302 с ротационным резидентным трафиком. Линия Budget стоит US$1.50 за GB при любом объёме (US$1.35 за GB при 100 GB), минимальная покупка — 1 GB; подробности на странице тарифов.

Ваши логин и пароль прокси Proxy302. Страница «Мои активы» в консоли показывает HOST, PORT, USERNAME и PASSWORD для всего, что вы купили.

• страница тарифов

• Источники:
• Proxy302: страница тарифов
• Proxy302: адрес, порт и логин прокси

Подключение, поле за полем

Хост шлюза: proxy.proxy302.com — HTTP и SOCKS5 используют один шлюз

Порт для HTTP: 2222 — рекомендованная точка входа для Puppeteer

Порт для SOCKS5: 3333

Аргумент запуска: --proxy-server=http://proxy.proxy302.com:2222

Аутентификация: await page.authenticate({ username, password }) до первого page.goto()

Откуда брать значения: «Мои активы» в консоли Proxy302

• Источники:
• Proxy302: адрес, порт и логин прокси

Полный первый скрипт

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    args: ['--proxy-server=http://proxy.proxy302.com:2222'],
  });

  const page = await browser.newPage();
  await page.authenticate({
    username: 'YOUR_PROXY_USERNAME',
    password: 'YOUR_PROXY_PASSWORD',
  });

  await page.goto('https://ipinfo.io/json');
  console.log('Выход:', await page.$eval('body', (el) => el.textContent));

  await browser.close();
})();

Готов к запуску: подставьте учётные данные Proxy302 и запустите через Node.js.

• Источники:
• Справочник Puppeteer API: LaunchOptions
• Справочник Puppeteer API: page.authenticate()
• Proxy302: адрес, порт и логин прокси

Что делает флаг запуска

--proxy-server — переключатель командной строки Chromium; в его исходном коде стоит комментарий "Uses a specified proxy server, overrides system settings." Puppeteer передаёт его браузеру через опцию args вызова puppeteer.launch(), которую справочник API Puppeteer описывает как "Additional command line arguments to pass to the browser instance." По умолчанию браузер работает в headless-режиме.

Chromium распознаёт схемы прокси http, https, socks4 и socks5, поэтому один и тот же флаг несёт любой из входов: --proxy-server=http://proxy.proxy302.com:2222 или --proxy-server=socks5://proxy.proxy302.com:3333.

• Источники:
• Исходный код Chromium: chrome/common/chrome_switches.h
• Исходный код Chromium: net/base/proxy_server.cc
• Справочник Puppeteer API: LaunchOptions

Что делает page.authenticate()

Справочник API Puppeteer говорит, что page.authenticate() предоставляет странице "credentials for HTTP authentication", и отмечает: "Request interception will be turned on behind the scenes to implement authentication." Вызывайте его до первого page.goto(); чтобы отключить, передайте null.

Поэтому HTTP на порту 2222 — рекомендованная точка входа: браузер проходит обязательный для каждого соединения Proxy302 вход по логину и паролю прямо внутри страницы. Используйте те же логин и пароль, что и в других ваших инструментах; они показаны в разделе «Мои активы».

• Источники:
• Справочник Puppeteer API: page.authenticate()
• Proxy302: адрес, порт и логин прокси

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

Откройте https://ipinfo.io/json через страницу. Поля ip и country должны принадлежать выходу прокси, а не вашему собственному подключению. Если печатается ваш собственный адрес, аргумент запуска не дошёл до экземпляра браузера, которым управляет этот скрипт: сначала выведите IP выхода, затем проверьте, какой браузер запускает и настраивает скрипт. Поля разобраны в инструкции о проверке прокси.

• как проверить IP и страну прокси

Трафик, цена и срок

Ротационный резидентный трафик тарифицируется по гигабайтам на двух линиях: Budget — от US$1.50 за GB (US$1.35 за GB при 100 GB) и Premium — от US$5.00 за GB. Минимальная покупка — 1 GB. Оплата предоплатой, по мере использования, без подписки; купленные GB не сгорают.

• Источники:
• Proxy302: страница тарифов
• Proxy302: страница ротационных резидентных прокси

Ротация IP против липкой сессии в Puppeteer

Страница ротационных резидентных прокси описывает два режима: каждый запрос идёт через другой настоящий домашний IP, а липкая сессия удерживает один резидентный IP на последовательность запросов. Ротация по каждому запросу подходит для парсинга множества страниц, проверок цен и любых задач, где один IP не должен накапливать историю; липкая сессия — для потоков входа, корзин и всего, что привязано к сессии.

Список прокси вести не нужно: один шлюз и один набор учётных данных несут весь трафик. Как именно линия переключается между двумя режимами, на странице продукта не описано — проверьте, а не предполагайте: откройте https://ipinfo.io/json дважды из скрипта и сравните IP выхода; разные адреса означают ротацию по каждому запросу, одинаковый адрес — что сессия удерживает один IP.

• страница ротационных резидентных прокси

• Источники:
• Proxy302: страница ротационных резидентных прокси

Пройти по URL, затем проверить поведение выхода

// Шлюз и учётные данные между задачами не меняются.
for (const url of urls) {
  await page.goto(url, { waitUntil: 'domcontentloaded' });
  // ...извлеките нужное
}

// Проверьте, какой режим у вашей линии: дважды откройте страницу-эхо IP
// и сравните IP выхода.
for (let i = 0; i < 2; i++) {
  await page.goto('https://ipinfo.io/json', { waitUntil: 'domcontentloaded' });
  console.log('Выход:', await page.$eval('body', (el) => el.textContent));
}

Готов к запуску: подставьте учётные данные Proxy302 и запустите через Node.js.

SOCKS5 в Puppeteer

Вход SOCKS5 — порт 3333 на том же шлюзе. Загвоздка сидит в самом браузере: SOCKS5-клиент Chromium — движка, которым управляет Puppeteer, — отправляет приветствие, предлагающее ровно один метод, "no authentication", и рукопожатие продолжается, только если сервер выберет его. SOCKS5-аутентификацию по логину и паролю Chromium не предлагает никогда, а каждое соединение Proxy302 требует ваш логин и пароль.

Практичных пути три. Первый: HTTP на порту 2222 — аутентификация проходит от начала до конца через page.authenticate(), как показано выше, и больше ничего не меняется. Второй: запустить на своей машине небольшой локальный форвардер, который принимает неавторизованное соединение браузера и пересылает его на авторизованный вход SOCKS5 — это оправдано только для задач, которым нужен именно SOCKS5, ведь обычный веб-трафик HTTP-путь несёт так же. Третий: работать с SOCKS5 из инструмента вне браузера, который сам выполняет SOCKS5-аутентификацию по логину и паролю.

• Источники:
• Исходный код Chromium: net/socket/socks5_client_socket.cc
• Proxy302: адрес, порт и логин прокси

SOCKS5 вне браузера: curl

curl -x socks5h://USERNAME:[email protected]:3333 https://ipinfo.io/json

Готов к запуску: подставьте учётные данные Proxy302 и запустите через Node.js.

• Источники:
• Документация libcurl: CURLOPT_PROXY
• Proxy302: адрес, порт и логин прокси

Почему socks5h, а не socks5

Сохраняйте h в socks5h://. Документация libcurl определяет socks5h:// как "SOCKS5 Proxy. Proxy resolves URL hostname", тогда как обычный socks5:// разрешает имя хоста на вашей машине до соединения с прокси. Разрешение на стороне прокси держит представление сайта о вашем DNS в согласии с IP выхода. Та же документация подтверждает стиль учётных данных scheme://username:password@hostname из команды выше.

• Источники:
• Документация libcurl: CURLOPT_PROXY

Частые ошибки и что проверить

net::ERR_NO_SUPPORTED_PROXIES: Список ошибок Chromium описывает её так: "There are no supported proxies in the provided list." Проверьте значение --proxy-server: сохраните поддерживаемую схему (http:// или socks5://) и корректный host:port.

net::ERR_PROXY_CONNECTION_FAILED: "Could not create a connection to the proxy server. An error occurred either in resolving its name, or in connecting a socket to it" — по списку ошибок Chromium. Проверьте написание хоста proxy.proxy302.com, порт 2222 (HTTP) или 3333 (SOCKS5) и что ваша сеть пропускает исходящие подключения к шлюзу.

HTTP 407 или повторяющиеся запросы авторизации: page.authenticate() должен отработать до первого page.goto(). Скопируйте логин и пароль заново — без лишних пробелов и переносов строк.

Страницы открываются, но показывают ваш IP: Аргумент запуска не дошёл до этого экземпляра браузера. Сначала выведите IP выхода, затем проверьте, что скрипт запускает именно тот браузер, который настраивает.

Таймауты на медленных сайтах: Поднимите таймаут page.goto() для этой задачи и убедитесь, что на аккаунте ещё есть трафик.

• Источники:
• Исходный код Chromium: net/base/net_error_list.h
• Proxy302: адрес, порт и логин прокси

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

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

Прокси для Playwright

Playwright прокси с логином и паролем: IP дата-центра для тестов и CI, ротационные резидентные от $1,50/ГБ для сайтов, которые блокируют серверы.

Посмотреть параметры и цену

Прокси для Selenium

Selenium прокси с авторизацией в Chrome: HTTP-прокси в ChromeOptions и встроенный в Selenium обработчик BiDi, без расширений. Статические IP дата-центра для тестов.

Посмотреть параметры и цену

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

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

Цены

Резидентные прокси от $1,50 за ГБ, статические ISP IP $7,99 и IP дата-центров $3,99 в месяц. Без подписки.