Autenticación de proxy en Playwright: una IP estática por contexto
Por el equipo de ingeniería de ProxyV4 · Updated:
Un proxy en Playwright se configura mediante un objeto proxy que contiene server, username y password, y Playwright responde al desafío 407 del proxy de forma automática, sin extensiones ni wrappers. Configúralo en launch() para aplicarlo a todo el navegador o en newContext() para asignar a cada contexto aislado una IP de ProxyV4 diferente dentro del mismo proceso de navegación. Las mismas claves funcionan para Chromium, Firefox y WebKit, tanto desde Node.js como desde Python.
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }- 1 IP1,85 US$
- 3+ IPs1,70 US$
- 10+ IPs1,60 US$
- 25+ IPs1,50 US$
- 50+ IPs1,40 US$
- 100+ IPs1,30 US$
- 200+ IPs1,20 US$
- 500+ IPs1,10 US$
- 1 IP2,25 US$
- 3+ IPs2,10 US$
- 10+ IPs2,00 US$
- 25+ IPs1,90 US$
- 50+ IPs1,80 US$
- 100+ IPs1,70 US$
- 200+ IPs1,60 US$
- 500+ IPs1,50 US$
El objeto proxy, clave por clave
| Clave | Valor de ejemplo | Notas |
|---|---|---|
server | 'http://ip:port' | Solo dirección y puerto; las credenciales no van en esta cadena |
username | 'user' | El nombre de usuario de tu pedido en ProxyV4 |
password | 'pass' | Se envía automáticamente cuando el proxy responde 407 |
bypass | 'localhost,127.0.0.1' | Lista opcional de hosts que deben omitir el proxy |
Para todo el navegador o por contexto
Pasar proxy a chromium.launch() envía todas las páginas de ese navegador a través de una sola IP, lo cual resulta ideal para una tarea única con una sola identidad. Pasarlo a browser.newContext() es el patrón multicuenta: cada contexto tiene sus propias cookies, almacenamiento y proxy, permitiendo que un único proceso de Chromium gestione varias sesiones mostrando distintas direcciones de salida.
Dado que cada IPv4 privada de ProxyV4 se alquila a un solo cliente y mantiene su dirección al renovarse, puedes asignar nombres de contexto a IPs en la configuración y reutilizar esa correspondencia en cada ejecución; un sitio que detectó la cuenta A con una IP la semana pasada verá la misma IP hoy.
Detalles para mantener la coherencia entre contextos
- Algunas combinaciones de Playwright y Chromium en Windows y macOS rechazan proxies por contexto a menos que el navegador también se haya iniciado con un proxy; inícialo con el marcador de posición
proxy: { server: 'http://per-context' }y sobrescríbelo en cada contexto - Configura
timezoneIdylocaleennewContext()para que coincidan con el país del proxy (por ejemplo,America/New_Yorkpara una IP de EE. UU.,Asia/Ho_Chi_Minhpara Vietnam), de modo que el reloj y la salida deIntlconcuerden con la IP - Bloquea imágenes y fuentes con
page.route()cuando solo necesites texto; las páginas cargarán más rápido y la ejecución finalizará antes - Cierra los contextos que ya no necesites; cada uno mantiene abiertas sus propias conexiones
Paso a paso
- 1
Separa la línea de tu proxy
De la línea
ip:port:user:passde tu pedido en ProxyV4, tomaip:portparaservery los dos últimos campos parausernameypassword. - 2
Crea un contexto con el proxy
Ejecuta
const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } }). - 3
Sincroniza la zona horaria y el idioma
Añade
timezoneIdylocalecorrespondientes a la ubicación del proxy en las mismas opciones denewContext(). - 4
Carga el endpoint de IP
Abre
const page = await context.newPage(), ve ahttps://proxyv4.com/api/my-ipy comprueba que la dirección mostrada sea la IP del proxy. Realizar un test de fugas de WebRTC en el mismo contexto es una segunda comprobación útil.
Preguntas frecuentes
Playwright indica 'Proxy is only supported when browser is launched with a proxy'. ¿Cómo lo soluciono?
En Windows y macOS, Chromium puede exigir un proxy a nivel de inicio antes de admitir proxies por contexto. Inicia con chromium.launch({ proxy: { server: 'http://per-context' } }) y luego asigna a cada browser.newContext({ proxy }) la dirección y las credenciales reales.
¿Funciona la misma configuración de proxy en Firefox y WebKit?
Sí. proxy: { server, username, password } es compartido por los tres motores y por las API de Node.js y Python, por lo que solo cambia el iniciador (firefox, webkit).
¿Consumen cuota de tráfico los navegadores headless?
No en los planes de IPv4 privada o ISP estática de ProxyV4; el ancho de banda en ambos es ilimitado, por lo que las páginas pesadas no suponen un coste extra.
Las páginas fallan con un error de túnel en lugar de cargar. ¿Qué debo revisar?
Confirma que server utilice http:// y el puerto correcto, y que el proxy continúe activo en tu panel. La guía de conexión de túnel cubre el resto de causas.
Fuentes
Una IP privada por contexto de Playwright
Proxies HTTP(S) con usuario y contraseña en 7 países, sin límite de tráfico y con la misma dirección al renovar.
Ver precios actuales para EE. UU.