Puppeteer con proxy autenticado: flag de inicio y autenticación
Por el equipo de ingeniería de ProxyV4 · Updated:
La autenticación de proxy en Puppeteer se realiza en dos partes: la dirección del proxy se indica en el flag de inicio --proxy-server=http://ip:port, y el usuario y la contraseña se pasan a await page.authenticate({ username, password }). Chrome responde al desafío 407 del proxy con estas credenciales mediante DevTools Protocol, lo que permite que tu script de Node.js use una IP de ProxyV4 sin extensiones de navegador.
--proxy-server=http://ip:port + page.authenticate({ username, password })- 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 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$
Autenticación de proxy en Puppeteer: un ejemplo completo
Pasa la dirección del proxy en --proxy-server y las credenciales mediante page.authenticate() antes de la primera navegación. Este script hace exactamente eso e imprime la IP de salida para que puedas confirmar el proxy en una sola ejecución:
// npm i puppeteer
const puppeteer = require('puppeteer');
const PROXY = { host: 'IP', port: 'PORT', username: 'USER', password: 'PASS' };
(async () => {
const browser = await puppeteer.launch({
args: [`--proxy-server=http://${PROXY.host}:${PROXY.port}`],
});
try {
const page = await browser.newPage();
await page.authenticate({ username: PROXY.username, password: PROXY.password });
const res = await page.goto('https://proxyv4.com/api/my-ip', { waitUntil: 'domcontentloaded' });
console.log(res.status(), await page.evaluate(() => document.body.innerText));
} finally {
await browser.close();
}
})();La salida debería mostrar el estado 200 y la IP del proxy. Un 407, ERR_TUNNEL_CONNECTION_FAILED o tu propia IP significa que falta una de las dos partes; el proxy no funciona enumera las causas habituales según cada herramienta.
Por qué el acceso no forma parte del flag
Chrome no acepta credenciales dentro de --proxy-server. Si escribes --proxy-server=http://user:pass@ip:port, el navegador no puede usar el valor y las solicitudes fallan, normalmente con ERR_NO_SUPPORTED_PROXIES. Limita el flag a la dirección y el puerto, y pasa el acceso a la página.
| Orden | Llamada | Qué hace |
|---|---|---|
| 1 | puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }) | Le indica a Chrome qué proxy debe utilizar cada solicitud |
| 2 | await page.authenticate({ username, password }) | Proporciona las credenciales cuando el proxy responde con un 407 |
| 3 | await page.goto(url, { waitUntil: 'domcontentloaded' }) | Carga el destino a través del proxy autenticado |
Pestañas, contextos y más de una IP
page.authenticate()se configura por página: cada pestaña creada conbrowser.newPage()requiere su propia llamada antes del primergoto()- El flag de inicio fija un único proxy para todo el navegador. Para usar una IP diferente por contexto en un mismo proceso de Chrome, pasa cada
http://user:pass@ip:portporanonymizeProxy()del paqueteproxy-chainy entrega el resultado comoproxyServerabrowser.createBrowserContext({ proxyServer }) - La configuración funciona igual con
puppeteer-extraypuppeteer-extra-plugin-stealth - Finaliza siempre con
browser.close(), incluso en rutas de error, o los procesos de Chrome headless se acumularán en el servidor
Puppeteer con un proxy SOCKS5
Chrome puede usar un proxy SOCKS5 (--proxy-server=socks5://IP:PORT), pero no puede iniciar sesión en él, y page.authenticate() no se aplica a SOCKS. Con un proxy de ProxyV4 (SOCKS5 se ofrece fuera de Vietnam; las IP de Vietnam son solo HTTP), tienes dos opciones claras: cambiar el pedido a HTTP o modo dual y usar el ejemplo anterior, o permitir que proxy-chain abra un reenviador local sin contraseña que inicie sesión por ti:
const proxyChain = require('proxy-chain');
const local = await proxyChain.anonymizeProxy('socks5://USER:PASS@IP:PORT');
const browser = await puppeteer.launch({ args: [`--proxy-server=${local}`] });
// ... when done:
await browser.close();
await proxyChain.closeAnonymizedProxy(local, true);La autenticación por lista blanca de IP es una tercera vía: añade la IP pública de la máquina al pedido y Chrome se conectará sin necesidad de credenciales.
Elección de IP para una flota de Puppeteer
Chrome headless descarga páginas completas, scripts e imágenes, por lo que el tráfico medido se acumula rápidamente. Los proxies IPv4 privados y los proxies ISP estáticos de ProxyV4 no tienen medición de ancho de banda, cada IP sirve a un único cliente y la renovación mantiene la misma dirección, lo cual es fundamental cuando una sesión o lista de permitidos depende de ella. Compara el producto IPv4 privado con el producto ISP estático si el sitio de destino trata los rangos de datacenter de forma diferente.
Paso a paso
- 1
Inicia Chrome con la dirección del proxy
Inicia el navegador con
const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });, utilizando la IP y el puerto de tu pedido de ProxyV4. - 2
Autentica la pestaña
Abre una página con
const page = await browser.newPage();y llama aawait page.authenticate({ username: 'USER', password: 'PASS' });antes de cualquier navegación. - 3
Comprueba la IP de salida
Navega con
await page.goto('https://proxyv4.com/api/my-ip');y comprueba que la respuesta muestre la dirección del proxy. - 4
Cierra el navegador
Termina con
await browser.close();para que no quede ningún proceso de Chrome en ejecución.
Preguntas frecuentes
¿Qué causa ERR_NO_SUPPORTED_PROXIES en Puppeteer?
Incluir credenciales dentro del flag, como en --proxy-server=http://user:pass@ip:port. Usa --proxy-server=http://ip:port y pasa el usuario y la contraseña mediante page.authenticate().
Mi primera pestaña funciona, pero una nueva pestaña da HTTP 407. ¿Por qué?
La autenticación se guarda por página. Llama a await newTab.authenticate({ username, password }) en cada página que abras antes de que navegue.
¿Puede un mismo navegador de Puppeteer usar varios proxies a la vez?
No solo mediante el flag de inicio. Usa proxy-chain para convertir cada proxy autenticado en una dirección local y asigna a cada contexto de navegador su propio proxyServer, o inicia un navegador por proxy.
¿Cómo pruebo muchos proxies antes de usarlos en Puppeteer?
Pégalos en el verificador de proxies; procesa hasta 100 a la vez y no almacena contraseñas.
¿Por qué page.authenticate() no funciona con mi proxy SOCKS5?
Chrome no admite autenticación con usuario y contraseña para SOCKS5, por lo que Puppeteer no tiene nada que responder. Usa el modo HTTP del pedido, un reenviador local de proxy-chain o el acceso por lista blanca de IP.
Fuentes
IP sin límites de tráfico para headless Chrome
IPv4 privadas en 7 países e ISP estáticas en EE. UU. y Vietnam, asignadas automáticamente tras el pago, con un solo cliente por IP.
Ver precios de EE. UU. en tiempo real