---
title: "Прокси в Puppeteer с аутентификацией | Proxonym"
description: "Как запускать Puppeteer через прокси: Chrome с флагом --proxy-server, авторизация через page.authenticate, sticky-IP для каждого контекста и выбор локаций."
url: https://proxonym.com/ru/integrations/puppeteer
updated: 2026-10-02T03:03:46+00:00
---

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

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

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

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

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

Параметры подключения

- **Хост**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **Пользователь**: `USERNAME-country-us`

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-сессию на весь сценарий вместо перезагрузки страниц. Полная загрузка страницы может передать несколько мегабайт, поэтому на резидентном тарифе с оплатой за ГБ эти шаги дают заметную разницу.

Советы и подводные камни

- Chrome не поддерживает SOCKS5-прокси, требующие имя пользователя и пароль, поэтому в браузерах используйте HTTP-шлюз на порту 8000.
- page.authenticate() действует на одну страницу, поэтому вызывайте его заново для каждой новой страницы или всплывающего окна.
- Задавайте время жизни sticky-сессии больше, чем работает ваш скрипт (до 120 минут на резидентных прокси), чтобы IP не сменился посреди сценария.
- Если вход в аккаунт или сам аккаунт должен днями работать с одного адреса, статический ISP-прокси подойдёт лучше, чем сессия на резидентных прокси с ротацией.

Читайте также

- [Прокси в Puppeteer и Playwright: аутентификация, ротация и геотаргетинг](https://proxonym.com/ru/blog/puppeteer-playwright-proxies)
- [Ротационные или sticky-прокси: какой тип сессии выбрать](https://proxonym.com/ru/blog/rotating-vs-sticky-sessions)

Застряли на каком-то шаге?

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

- [Справочный центр](https://proxonym.com/ru/help)
- [Коды ошибок шлюза](https://proxonym.com/ru/docs#errors-and-troubleshooting)
- [Проверить прокси](https://proxonym.com/ru/proxy-checker)

## Другие руководства по интеграции

[Все интеграции](https://proxonym.com/ru/integrations)

- [Node.js (JavaScript)](https://proxonym.com/ru/integrations/nodejs)
- [Playwright (JavaScript)](https://proxonym.com/ru/integrations/playwright)
- [AdsPower (Антидетект-браузер)](https://proxonym.com/ru/integrations/adspower)
