Проксі для headless-браузерів (Playwright, Puppeteer): робочі конфігурації

Автоматизація дій у веб-браузерах за допомогою Playwright або Puppeteer без використання проксі-інфраструктури швидко впирається в жорсткі обмеження антифрод-систем. Сучасні захисні комплекси (Cloudflare, Akamai, Datadome) аналізують не лише фінгерпринти, але й репутацію IP-адреси, з якої надходять запити. Без грамотного налаштування мережевого шару будь-який headless-скрипт виявляється після кількох ітерацій, отримуючи масові CAPTCHA або повне блокування доступу.

Правильне підключення проксі в Puppeteer чи Playwright дозволяє розподіляти навантаження, підтримувати сесії та імітувати поведінку реальних користувачів із різних географічних локацій. Розберемо практичні конфігурації підключення та авторизації для обох фреймворків.

Конфігурація проксі в Puppeteer

У Puppeteer налаштування мережевого проксі відбувається безпосередньо під час ініціалізації екземпляра Chromium через параметри запуску (launch arguments).

Передача через аргументи запуску

Для підключення використовується прапор --proxy-server. Базовий синтаксис виглядає наступним чином:

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    headless: true,
    args: ['--proxy-server=http://185.130.5.15:8080']
  });

  const page = await browser.newPage();

  await page.goto('https://httpbin.org/ip');

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

Авторизація з логіном і паролем

Chromium не підтримує передачу облікових даних у форматі http://user:pass@ip:port безпосередньо через аргумент --proxy-server. Для цього використовується метод page.authenticate():

const browser = await puppeteer.launch({
  headless: true,
  args: ['--proxy-server=http://185.130.5.15:8080']
});

const page = await browser.newPage();

// Авторизація проксі з логіном і паролем puppeteer
await page.authenticate({
  username: 'proxy_user',
  password: 'proxy_password'
});

await page.goto('https://httpbin.org/ip');

Особливості SOCKS5

Для протоколу SOCKS5 використовується відповідна префіксація в аргументах:

--proxy-server=socks5://185.130.5.15:1080

Якщо проксі SOCKS5 вимагає авторизації, базовий page.authenticate() у деяких версіях Chromium може працювати нестабільно. У таких випадках застосовують сторонні плагіни або перенаправлення через локальний тунель.

Конфігурація проксі в Playwright

Playwright пропонує більш гнучку архітектуру для роботи з мережевими протоколами. На відміну від Puppeteer, де проксі задається на рівні всього процесу браузера, Playwright дозволяє визначати проксі-конфігурації як для всього браузера, так і для окремих ізольованих контекстів (BrowserContext).

Налаштування на рівні контексту

Об'єкт proxy передається безпосередньо у параметри launch або newContext, причому авторизаційні дані вказуються в єдиній структурі:

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch({
    proxy: {
      server: 'http://185.130.5.15:8080',
      username: 'proxy_user',
      password: 'proxy_password'
    }
  });

  // Кожен контекст може мати власні мережеві параметри
  const context = await browser.newContext();

  const page = await context.newPage();

  await page.goto('https://httpbin.org/ip');

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

Підтримка Playwright proxy SOCKS5

Playwright коректно обробляє SOCKS5-проксі з аутентифікацією "з коробки". Достатньо вказати префікс socks5:// у параметрі server:

const context = await browser.newContext({
  proxy: {
    server: 'socks5://185.130.5.15:1080',
    username: 'proxy_user',
    password: 'proxy_password'
  }
});

Архітектурні нюанси та захист від витоків

Sticky Sessions vs Rotating Proxies

При автоматизації вибір типу ротації залежить від завдань:

• Rotating Proxies (зміна IP на кожен запит): Ідеально підходить для парсингу публічних даних великого обсягу.
• Sticky Sessions (прив'язка IP на час сесії): Необхідні при роботі з авторизованими акаунтами, кошиками покупок або багатокроковими формами, де раптова зміна IP викликає перевірку безпеки.

Захист від витоку реального IP та антидетект

Використання проксі не гарантує анонімності, якщо сам браузер видає свою природу через WebRTC або заголовок Chromium. За замовчуванням WebRTC може виконувати STUN-запити вхідними каналами, минаючи проксі-сервер, що призводить до витоку реального IP-адреси пристрою.

Щоб мінімізувати витоки в Puppeteer, застосовують комплекси затирання слідів, такі як puppeteer-extra-plugin-stealth, а також примусово вимикають WebRTC через аргументи запуску:

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');

puppeteer.use(StealthPlugin());

const browser = await puppeteer.launch({
  args: [
    '--proxy-server=http://185.130.5.15:8080',
    '--disable-webrtc',
    '--enforce-webrtc-ip-permission-check'
  ]
});

Для стабільного обходу блокувань критично використовувати перевірену мережеву інфраструктуру. Сервіс StableProxy надає високоефективні резидентські та ISP-проксі з підтримкою HTTP/HTTPS та SOCKS5, які гарантують відсутність витоків даних та високий траст з боку захисних систем.

Порівняльна таблиця: Puppeteer vs Playwright

Параметр конфігурації	Puppeteer	Playwright
Рівень визначення проксі	Глобально при запуску процесу	На рівні Browser або окремого BrowserContext
Передача авторизації	Через окремий async-метод page.authenticate()	Вбудована у конфігураційний об'єкт proxy
Підтримка SOCKS5 з паролем	Потребує додаткових хаків / плагінів	Повна підтримка "з коробки"
Ізоляція IP між вкладками	Складна (потрібні окремі процеси)	Легка (різні BrowserContext в одному процесі)