НовинкаБезлимитные резидентные прокси: трафик без учёта объёма по фиксированной цене. От $33,25/день

JavaScript · Руководство по интеграции

Как использовать прокси в Puppeteer

Puppeteer направляет Chrome на прокси с помощью флага запуска и отвечает на запрос авторизации шлюза через page.authenticate(). В руководстве также: sticky-сессии, отдельный IP для каждого контекста браузера, согласование с местоположением IP и облегчённая загрузка страниц.

  • 6 шагов
  • Настройка за 12 мин
  • Готовый код для копирования

Перед началом работы

  • Node.js 22 или новее
  • Puppeteer 22 или новее
  • Тариф Proxonym на резидентные или мобильные прокси
Получить учётные данные прокси

Уже наш клиент? Имя пользователя и пароль — в личном кабинете.

  1. Установите Puppeteer

    При установке пакета также скачивается подходящая сборка Chrome for Testing. Сохраняйте примеры как файлы .mjs, чтобы использовать import и await верхнего уровня.

    Shell
    npm install puppeteer
  2. Запустите Chrome через шлюз

    Chrome игнорирует учётные данные внутри --proxy-server, поэтому передавайте там только хост и порт, а имя пользователя и пароль укажите через page.authenticate() до первого перехода.

    JavaScript
    // launch.mjs
    import puppeteer from 'puppeteer';
    
    const browser = await puppeteer.launch({
      args: ['--proxy-server=http://gw.proxonym.com:8000'],
    });
    const page = await browser.newPage();
    await page.authenticate({ username: 'USERNAME', password: 'PASSWORD' });
    
    await page.goto('https://api.ipify.org');
    console.log('Exit IP:', await page.evaluate(() => document.body.innerText));
    await browser.close();
  3. Сохраняйте один IP на всю сессию

    Страница открывает много подключений, и при имени пользователя с ротацией каждое из них может выходить с другого IP. Добавьте ID сессии через -session-, чтобы все подключения шли через один IP, и задайте -lifetime- больше длительности задачи — до 120 минут.

    JavaScript
    import { randomBytes } from 'node:crypto';
    
    const session = randomBytes(4).toString('hex');
    await page.authenticate({
      username: `USERNAME-country-us-session-${session}-lifetime-30`,
      password: 'PASSWORD',
    });
  4. Используйте отдельный IP для каждого контекста браузера

    Контексты браузера хранят cookies и подключения раздельно, и у каждого может быть собственный прокси. Задайте каждому контексту свой ID сессии или страну, чтобы работать от имени нескольких цифровых личностей в одном процессе Chrome.

    JavaScript
    // contexts.mjs
    import { randomBytes } from 'node:crypto';
    import puppeteer from 'puppeteer';
    
    const browser = await puppeteer.launch();
    
    async function openIdentity(country) {
      const context = await browser.createBrowserContext({
        proxyServer: 'http://gw.proxonym.com:8000',
      });
      const page = await context.newPage();
      await page.authenticate({
        username: `USERNAME-country-${country}-session-${randomBytes(4).toString('hex')}-lifetime-30`,
        password: 'PASSWORD',
      });
      return page;
    }
    
    const pages = await Promise.all(['us', 'gb', 'de'].map(openIdentity));
    for (const page of pages) {
      await page.goto('https://api.ipify.org');
      console.log(await page.evaluate(() => document.body.innerText));
    }
    await browser.close();
  5. Согласуйте браузер с местоположением

    Укажите в имени пользователя страну, штат или город, а затем согласуйте с ними часовой пояс и язык, чтобы браузер и IP не противоречили друг другу.

    JavaScript
    await page.authenticate({
      username: 'USERNAME-country-de-city-berlin-session-b3x9-lifetime-30',
      password: 'PASSWORD',
    });
    await page.emulateTimezone('Europe/Berlin');
    await page.setExtraHTTPHeaders({ 'Accept-Language': 'de-DE,de;q=0.9' });
    
    await page.goto('https://ipinfo.io/json');
    console.log(await page.evaluate(() => document.body.innerText));
  6. Экономьте трафик и обрабатывайте ошибки

    Резидентный трафик тарифицируется за ГБ, поэтому блокируйте ненужные изображения, медиафайлы и шрифты. При отклонённом туннеле page.goto() выбрасывает net::ERR_TUNNEL_CONNECTION_FAILED — такой запрос стоит повторить с новым ID сессии, а отклонённая авторизация возвращается как статус 407.

    JavaScript
    await page.setRequestInterception(true);
    page.on('request', (request) => {
      if (['image', 'media', 'font'].includes(request.resourceType())) request.abort();
      else request.continue();
    });
    
    try {
      const response = await page.goto('https://example.com', {
        waitUntil: 'domcontentloaded',
        timeout: 60_000,
      });
      console.log('Status:', response?.status());
    } catch (err) {
      console.error('Navigation failed:', err.message);
    }

Часто задаваемые вопросы

Почему Puppeteer выдаёт ошибку ERR_TUNNEL_CONNECTION_FAILED?

Шлюз отказался открыть туннель к целевому сайту. 402 означает, что баланс пуст или срок действия тарифа истёк, а 403 — что целевой сайт заблокирован по правилам допустимого использования; 502 и 504 — временные ошибки, поэтому повторите запрос с новым ID сессии. Проблемы с авторизацией выглядят иначе: статус страницы 407 или ошибка ERR_INVALID_AUTH_CREDENTIALS, если page.authenticate() не был вызван.

Может ли каждая страница или вкладка использовать свой IP?

Да. Создайте для каждой цифровой личности контекст браузера с собственным proxyServer, открывайте страницы внутри него и аутентифицируйте каждую страницу именем пользователя с другим ID сессии или другой страной. Страницы в одном контексте делят cookies и подключения, поэтому считайте один контекст одной цифровой личностью с одним закреплённым IP.

Меняет ли headless-режим работу прокси?

Нет. Флаг прокси, шаг аутентификации и параметры имени пользователя одинаковы в headless-режиме и в режиме с окном. Различается отпечаток браузера, поэтому согласуйте часовой пояс, язык и viewport с местоположением выходного IP и поддерживайте реалистичную для посещаемого сайта частоту запросов.

Как сократить трафик на страницу?

Блокируйте изображения, медиафайлы и шрифты с помощью перехвата запросов, дожидайтесь domcontentloaded, а не полного простоя сети, и используйте одну sticky-сессию на весь сценарий вместо перезагрузки страниц. Полная загрузка страницы может передать несколько мегабайт, поэтому на резидентном тарифе с оплатой за ГБ эти шаги дают заметную разницу.

Готовы подключить прокси? Получите учётные данные

Выберите тариф, скопируйте имя пользователя и пароль из личного кабинета и запустите код выше.

  • Оплата по мере использования
  • Мгновенная активация
  • Принимаем криптовалюту
  • Без автопродления