-
Установите Playwright и браузер
Установите библиотеку, затем скачайте браузер, которым планируете управлять. Сохраняйте примеры на JavaScript как файлы
.mjs, чтобы использоватьimportиawaitверхнего уровня.Shell npm install playwright npx playwright install chromium -
Запустите браузер через шлюз
Передайте шлюз, имя пользователя и пароль в опции
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(); -
Дайте каждому контексту свой закреплённый 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(); -
Согласуйте локаль и часовой пояс с 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')); -
Экономьте трафик и повторяйте неудачные переходы
Блокируйте изображения, медиафайлы и шрифты, чтобы сократить оплачиваемый трафик, и повторяйте переходы, которые завершились ошибкой туннеля или тайм-аутом. Отказ шлюза проявляется как ошибка, например
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()); -
Используйте те же настройки в 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 сессии. Повторяющиеся ошибки туннеля, напротив, указывают на проблему с учётными данными, балансом или на заблокированный целевой сайт.
