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

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

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

Playwright принимает настройки прокси вместе с именем пользователя и паролем — при запуске или для каждого контекста браузера. В руководстве: аутентификация, закреплённые IP для каждого контекста, согласование браузера с местоположением IP и устойчивая навигация.

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

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

  • Node.js 20 или новее либо Python 3.10 или новее для примера на Python
  • Playwright и хотя бы один установленный браузер
  • Тариф Proxonym на резидентные или мобильные прокси
Получить учётные данные прокси

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

  1. Установите Playwright и браузер

    Установите библиотеку, затем скачайте браузер, которым планируете управлять. Сохраняйте примеры на JavaScript как файлы .mjs, чтобы использовать import и await верхнего уровня.

    Shell
    npm install playwright
    npx playwright install chromium
  2. Запустите браузер через шлюз

    Передайте шлюз, имя пользователя и пароль в опции proxy. Playwright сам отвечает на запрос авторизации шлюза, так что дополнительный шаг аутентификации не нужен.

    JavaScript
    // launch.mjs
    import { chromium } from 'playwright';
    
    const browser = await chromium.launch({
      proxy: {
        server: 'http://gw.proxonym.com:8000',
        username: 'USERNAME',
        password: 'PASSWORD',
      },
    });
    const page = await browser.newPage();
    await page.goto('https://api.ipify.org');
    console.log('Exit IP:', await page.textContent('body'));
    await browser.close();
  3. Дайте каждому контексту свой закреплённый IP

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

    JavaScript
    // contexts.mjs
    import { randomBytes } from 'node:crypto';
    import { chromium } from 'playwright';
    
    const browser = await chromium.launch();
    
    for (const country of ['us', 'gb', 'de']) {
      const context = await browser.newContext({
        proxy: {
          server: 'http://gw.proxonym.com:8000',
          username: `USERNAME-country-${country}-session-${randomBytes(4).toString('hex')}-lifetime-30`,
          password: 'PASSWORD',
        },
      });
      const page = await context.newPage();
      await page.goto('https://api.ipify.org');
      console.log(country, await page.textContent('body'));
      await context.close();
    }
    await browser.close();
  4. Согласуйте локаль и часовой пояс с IP

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

    JavaScript
    const context = await browser.newContext({
      proxy: {
        server: 'http://gw.proxonym.com:8000',
        username: 'USERNAME-country-fr-city-paris-session-p4r1s-lifetime-30',
        password: 'PASSWORD',
      },
      locale: 'fr-FR',
      timezoneId: 'Europe/Paris',
    });
    const page = await context.newPage();
    await page.goto('https://ipinfo.io/json');
    console.log(await page.textContent('body'));
  5. Экономьте трафик и повторяйте неудачные переходы

    Блокируйте изображения, медиафайлы и шрифты, чтобы сократить оплачиваемый трафик, и повторяйте переходы, которые завершились ошибкой туннеля или тайм-аутом. Отказ шлюза проявляется как ошибка, например net::ERR_TUNNEL_CONNECTION_FAILED.

    JavaScript
    await context.route('**/*', (route) => {
      const type = route.request().resourceType();
      return ['image', 'media', 'font'].includes(type) ? route.abort() : route.continue();
    });
    
    async function gotoWithRetry(page, url, tries = 3) {
      for (let attempt = 1; ; attempt++) {
        try {
          return await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60_000 });
        } catch (err) {
          console.error(`attempt ${attempt}:`, err.message.split('\n')[0]);
          if (attempt === tries) throw err;
        }
      }
    }
    
    const response = await gotoWithRetry(page, 'https://example.com');
    console.log('Status:', response?.status());
  6. Используйте те же настройки в Python

    Playwright для Python принимает те же ключи прокси. Установите его командами pip install playwright и playwright install chromium, затем передайте прокси при запуске или в new_context().

    Python
    from playwright.sync_api import sync_playwright
    
    with sync_playwright() as p:
        browser = p.chromium.launch(proxy={
            "server": "http://gw.proxonym.com:8000",
            "username": "USERNAME-country-us",
            "password": "PASSWORD",
        })
        page = browser.new_page()
        page.goto("https://api.ipify.org")
        print("Exit IP:", page.text_content("body"))
        browser.close()

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

Может ли Playwright использовать SOCKS5 с именем пользователя и паролем?

Playwright умеет подключаться к SOCKS5-серверам, но его поля для имени пользователя и пароля работают с HTTP-прокси. Если вы проходите аутентификацию по учётным данным, используйте http://gw.proxonym.com:8000. HTTP-эндпоинт туннелирует HTTPS через CONNECT и принимает те же параметры таргетинга и сессий, так что, выбрав его для автоматизации браузера, вы ничего не теряете.

Где задавать прокси: при запуске или для каждого контекста?

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

Playwright для Python работает так же?

Да. Опция proxy принимает те же ключи server, username и password в launch() и new_context(), а те же параметры имени пользователя управляют ротацией, sticky-сессиями и геотаргетингом. Асинхронный API ведёт себя точно так же, поэтому примеры на JavaScript с этой страницы можно перенести построчно.

Почему page.goto завершается по тайм-ауту при работе через прокси?

Обычные причины — тяжёлые страницы и медленные целевые сайты. Шлюз прерывает запрос к целевому сайту через 60 секунд с кодом 504, поэтому дожидайтесь domcontentloaded, а не networkidle, блокируйте изображения и медиафайлы и повторяйте запрос с новым ID сессии. Повторяющиеся ошибки туннеля, напротив, указывают на проблему с учётными данными, балансом или на заблокированный целевой сайт.

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

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

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