Puppeteer: ротация прокси на страницу, контекст или браузер

Три способа ротации

По страницам API Puppeteer и README proxy-chain (прочитано 13 ноября 2026) и фактам о продуктах Proxy302.

• Источники:
• API Puppeteer: BrowserContextOptions
• README proxy-chain (apify/proxy-chain)
• Факты о продуктах и прайс Proxy302

Почему нет прокси на страницу

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

Учётные данные передаёт Page.authenticate. Puppeteer предупреждает, что для этого в фоне включается перехват запросов, что может влиять на производительность, поэтому вызывайте его только на нужных страницах и до первого перехода.

• Источники:
• API Puppeteer: BrowserContextOptions
• API Puppeteer: Page.authenticate

Контекст на каждый прокси

import puppeteer from 'puppeteer'

const proxies = [
  { server: 'http://HOST1:2222', username: 'LOGIN1', password: 'PASSWORD1' },
  { server: 'http://HOST2:2222', username: 'LOGIN2', password: 'PASSWORD2' },
]

const browser = await puppeteer.launch()
for (const p of proxies) {
  const context = await browser.createBrowserContext({ proxyServer: p.server })
  const page = await context.newPage()
  await page.authenticate({ username: p.username, password: p.password })
  await page.goto('https://ipinfo.io/json')
  console.log(await page.evaluate(() => document.body.innerText))
  await context.close()
}
await browser.close()

Только пример. Замените HOST, LOGIN и PASSWORD значениями из «Мои активы». Каждый запуск печатает данные IP этого прокси.

Браузер на каждый прокси, с proxy-chain

Когда нужен целый браузер на прокси, флаг запуска принимает URL, но Chrome не берёт из него логин и пароль. Библиотека proxy-chain запускает небольшой локальный прокси с логином и возвращает локальный URL для --proxy-server; по окончании работы браузера его закрывают.

Chrome не поддерживает методы аутентификации SOCKS5, поэтому браузеру нужен HTTP-адрес.

• Источники:
• README proxy-chain (apify/proxy-chain)
• Заметки Chromium о настройке прокси

Браузер на каждый прокси

import puppeteer from 'puppeteer'
import { anonymizeProxy, closeAnonymizedProxy } from 'proxy-chain'

const localUrl = await anonymizeProxy('http://LOGIN:PASSWORD@HOST:2222')
const browser = await puppeteer.launch({ args: [`--proxy-server=${localUrl}`] })
const page = await browser.newPage()
await page.goto('https://ipinfo.io/json')
console.log(await page.evaluate(() => document.body.innerText))
await browser.close()
await closeAnonymizedProxy(localUrl, true)

Только пример. Нужно сначала выполнить npm install puppeteer proxy-chain. Замените HOST, LOGIN и PASSWORD.

Один ротируемый шлюз

С динамическими резидентными прокси задаётся один прокси — proxy.proxy302.com, HTTP порт 2222, — а выходной IP меняется сам. Без сессии каждое новое соединение получает новый IP, а повторно используемое сохраняет его. Страница открывает несколько соединений, поэтому разные запросы одной страницы могут выходить с разных IP.

Если странице нужен один IP, создайте прокси с сессией; на Бюджетной линии в консоли есть 10, 30, 60 и 120 минут или своё число минут от 1 до 120. Для адреса, неизменного несколько дней, берите статический IP. Бюджетная линия стоит $1,50 за ГБ.

• Динамические резидентные прокси

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

Один браузер, один шлюз

import puppeteer from 'puppeteer'

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://proxy.proxy302.com:2222'],
})
for (let i = 0; i < 3; i++) {
  const page = await browser.newPage()
  await page.authenticate({ username: 'LOGIN', password: 'PASSWORD' })
  await page.goto('https://ipinfo.io/json')
  console.log(await page.evaluate(() => document.body.innerText))
  await page.close()
}
await browser.close()

Только пример. Замените LOGIN и PASSWORD значениями из «Мои активы». Если две страницы печатают один IP, соединение было использовано повторно: для следующей задачи возьмите новый контекст или браузер.

Выбор и проверка за 4 шага

1. Шаг 1

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

2. Шаг 2

   Скопируйте хост, порт, логин и пароль из «Мои активы» и выберите протокол HTTP, потому что в Chrome нет логина SOCKS5.

   • Настройка прокси в Puppeteer

3. Шаг 3

   Запустите один из примеров с двумя прокси или двумя запусками и сравните поле ip в ipinfo.io/json.

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

4. Шаг 4

   Только после этого добавляйте реальную задачу. Соблюдайте условия сайтов и держите разумную частоту запросов.

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

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

Что почитать дальше

Настройка прокси в Puppeteer

Задайте HTTP-прокси в Puppeteer через --proxy-server, page.authenticate и контексты браузера и проверьте IP выхода.

Настройка прокси в Puppeteer

Направьте Puppeteer на proxy.proxy302.com через --proxy-server и пройдите аутентификацию page.authenticate() на HTTP-порту 2222; новый IP на каждом новом подключении или липкая сессия, а SOCKS5 на порту 3333 — для инструментов вне браузера.

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

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

Ротируемые резидентные прокси

Реальные домашние IP в 195+ странах; премиум-линия добавляет таргетинг по штату и крупному городу. Смена IP на каждое новое подключение или липкие сессии. От $1,50/ГБ, $1,35/ГБ при 100 ГБ. HTTP и SOCKS5.

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