-
Установите Puppeteer
При установке пакета также скачивается подходящая сборка Chrome for Testing. Сохраняйте примеры как файлы
.mjs, чтобы использоватьimportиawaitверхнего уровня.Shell npm install puppeteer -
Запустите 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(); -
Сохраняйте один 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', }); -
Используйте отдельный 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(); -
Согласуйте браузер с местоположением
Укажите в имени пользователя страну, штат или город, а затем согласуйте с ними часовой пояс и язык, чтобы браузер и 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)); -
Экономьте трафик и обрабатывайте ошибки
Резидентный трафик тарифицируется за ГБ, поэтому блокируйте ненужные изображения, медиафайлы и шрифты. При отклонённом туннеле
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-сессию на весь сценарий вместо перезагрузки страниц. Полная загрузка страницы может передать несколько мегабайт, поэтому на резидентном тарифе с оплатой за ГБ эти шаги дают заметную разницу.
