ProxyV4

Puppeteer con proxy autenticado: flag de inicio y autenticación

· 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.

Puppeteer · HTTP
--proxy-server=http://ip:port + page.authenticate({ username, password })
IPv4 privado (centro de datos)
🇺🇸 Estados Unidos
Disponible
Desde
1,10 US$ / IP / mes
Descuentos por volumen
  • 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$
Comprar Estados Unidos
IPv4 privado (centro de datos)
🇸🇬 Singapur
Disponible
Desde
1,10 US$ / IP / mes
Descuentos por volumen
  • 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$
Comprar Singapur

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.

OrdenLlamadaQué hace
1puppeteer.launch({ args: ['--proxy-server=http://ip:port'] })Le indica a Chrome qué proxy debe utilizar cada solicitud
2await page.authenticate({ username, password })Proporciona las credenciales cuando el proxy responde con un 407
3await 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 con browser.newPage() requiere su propia llamada antes del primer goto()
  • 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:port por anonymizeProxy() del paquete proxy-chain y entrega el resultado como proxyServer a browser.createBrowserContext({ proxyServer })
  • La configuración funciona igual con puppeteer-extra y puppeteer-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. 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. 2

    Autentica la pestaña

    Abre una página con const page = await browser.newPage(); y llama a await page.authenticate({ username: 'USER', password: 'PASS' }); antes de cualquier navegación.

  3. 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. 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

Related articles

Proxies por plataforma
Proxies para web scraping: un pool fijo de IP con tráfico ilimitado
Proxies de web scraping para Python, Scrapy, Playwright y Selenium: pool de IPv4 privadas e ISP estáticas con ancho de banda ilimitado y tarifa fija por IP.
Configuración de proxy
Autenticación de proxy en Playwright: una IP estática por contexto
Asigna a cada contexto de Playwright su propio proxy HTTP(S) con autenticación en Node.js o Python, ajusta zona horaria e idioma a la IP y valida la salida.
Configuración de proxy
Proxies autenticados en Node.js: Axios, fetch nativo y Got
Enruta peticiones de Node.js y TypeScript mediante un proxy HTTP(S) autenticado: https-proxy-agent para Axios, undici ProxyAgent para fetch y hpagent para Got.
Herramientas gratuitas
Convierte una lista de proxies al formato que espera tu herramienta
Convierte listas de proxies en tu navegador entre ip:port:user:pass, user:pass@ip:port, URL http://, URI SOCKS5, arrays JSON y archivos FoxyProxy por lotes.
Proxies por plataforma
Proxies para rank tracking SEO: vea la página de resultados que ve un usuario local
Proxies de rank tracking SEO con IPv4 privada en EE. UU., Reino Unido, Vietnam, Japón y 4 mercados más: rankings, packs locales y anuncios como los ven allí.
Proxies por plataforma
Proxies para YouTube: evita que el strike de un canal afecte al resto
Proxies de YouTube para creadores multicanal y equipos: una ISP estática o IPv4 por canal para que un strike o cierre en uno no afecte al resto.
IPV4 · united states
Pool de proxies IPv4 privados de EE. UU. para scraping, seguimiento de posiciones y verificación de anuncios
Compra proxies IPv4 privados de EE. UU.: IP estáticas de datacenter, un cliente por IP y ancho de banda ilimitado. Para scraping, rastreo de SERP y anuncios.
IPV4 · singapore
Proxy IPv4 privado de Singapur: una IP fija por tienda y cuenta publicitaria
Proxy IPv4 privado de Singapur: IP de datacenter fija y exclusiva para tiendas Lazada y Shopee SG, cuentas de anuncios de Singapur y automatización regional.