ProxyV4

Puppeteer com proxy autenticado: flag de inicialização e login

· Updated:

A autenticação de proxy no Puppeteer ocorre em dois lugares: o endereço do proxy vai na flag de inicialização --proxy-server=http://ip:port, e o usuário e a senha vão em await page.authenticate({ username, password }). O Chrome responde ao desafio 407 do proxy com essas credenciais pelo DevTools Protocol, permitindo que seu script Node.js use um IP da ProxyV4 sem extensões no navegador.

Puppeteer · HTTP
--proxy-server=http://ip:port + page.authenticate({ username, password })
IPv4 privado (datacenter)
🇺🇸 Estados Unidos
Em estoque
A partir de
US$ 1,10 / IP / mês
Descontos por quantidade
  • 1 IPUS$ 1,85
  • 3+ IPsUS$ 1,70
  • 10+ IPsUS$ 1,60
  • 25+ IPsUS$ 1,50
  • 50+ IPsUS$ 1,40
  • 100+ IPsUS$ 1,30
  • 200+ IPsUS$ 1,20
  • 500+ IPsUS$ 1,10
Comprar Estados Unidos
IPv4 privado (datacenter)
🇸🇬 Singapura
Em estoque
A partir de
US$ 1,10 / IP / mês
Descontos por quantidade
  • 1 IPUS$ 1,85
  • 3+ IPsUS$ 1,70
  • 10+ IPsUS$ 1,60
  • 25+ IPsUS$ 1,50
  • 50+ IPsUS$ 1,40
  • 100+ IPsUS$ 1,30
  • 200+ IPsUS$ 1,20
  • 500+ IPsUS$ 1,10
Comprar Singapura

Autenticação de proxy no Puppeteer: um exemplo completo

Passe o endereço do proxy em --proxy-server e o login via page.authenticate() antes da primeira navegação. Este script faz exatamente isso e exibe o IP de saída para você confirmar o proxy em uma única execução:

// 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();
  }
})();

A saída deve mostrar o status 200 e o IP do proxy. Um erro 407, ERR_TUNNEL_CONNECTION_FAILED ou o seu próprio IP indica que uma das duas etapas está faltando; o guia de proxy não funcionando lista as causas comuns para cada ferramenta.

Por que o login não faz parte da flag

O Chrome não aceita credenciais dentro de --proxy-server. Se você definir --proxy-server=http://user:pass@ip:port, o navegador não conseguirá utilizar o valor e as requisições falharão, geralmente com ERR_NO_SUPPORTED_PROXIES. Mantenha na flag apenas o endereço e a porta, e passe o login para a página.

OrdemChamadaO que faz
1puppeteer.launch({ args: ['--proxy-server=http://ip:port'] })Informa ao Chrome qual proxy todas as requisições devem usar
2await page.authenticate({ username, password })Fornece as credenciais quando o proxy responde com 407
3await page.goto(url, { waitUntil: 'domcontentloaded' })Carrega o destino por meio do proxy autenticado

Abas, contextos e mais de um IP

  • O page.authenticate() é definido por página: cada aba criada com browser.newPage() precisa de sua própria chamada antes do primeiro goto()
  • A flag de inicialização fixa um único proxy para todo o navegador. Para ter um IP diferente por contexto em um único processo do Chrome, passe cada http://user:pass@ip:port pela função anonymizeProxy() do pacote proxy-chain e passe o resultado como proxyServer para browser.createBrowserContext({ proxyServer })
  • A configuração funciona da mesma forma com o puppeteer-extra e o puppeteer-extra-plugin-stealth
  • Sempre finalize com browser.close(), inclusive em blocos de erro, caso contrário os processos do Chrome headless se acumularão no servidor

Puppeteer com proxy SOCKS5

O Chrome pode usar um proxy SOCKS5 (--proxy-server=socks5://IP:PORT), mas não consegue autenticar nele, e o page.authenticate() não se aplica a SOCKS. Com um proxy da ProxyV4 (o SOCKS5 é oferecido fora do Vietnã; os IPs do Vietnã são apenas HTTP), você tem duas opções simples: alterar o pedido para o modo HTTP ou duplo e usar o exemplo acima, ou deixar que o proxy-chain abra um encaminhador local sem senha que faça o login por você:

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);

O login por whitelist de IP é uma terceira opção: adicione o IP público da máquina ao pedido e o Chrome se conectará sem nenhuma credencial.

Escolhendo IPs para uma frota de Puppeteer

O Chrome headless baixa páginas inteiras, scripts e imagens, por isso o tráfego tarifado se esgota rapidamente. Os proxies IPv4 privados e ISP estáticos da ProxyV4 não têm medição de consumo de banda, cada IP atende a apenas um cliente e a renovação mantém o mesmo endereço, o que é fundamental quando uma sessão ou lista de permissões está associada a ele. Compare o produto de IPv4 privado com o produto de ISP estático caso o site de destino trate faixas de datacenter de forma diferente.

Passo a passo

  1. 1

    Inicie o Chrome com o endereço do proxy

    Inicie o navegador com const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });, usando o IP e a porta do seu pedido na ProxyV4.

  2. 2

    Autentique a aba

    Abra uma página com const page = await browser.newPage(); e chame await page.authenticate({ username: 'USER', password: 'PASS' }); antes de qualquer navegação.

  3. 3

    Verifique o IP de saída

    Navegue com await page.goto('https://proxyv4.com/api/my-ip'); e verifique se a resposta exibe o endereço do proxy.

  4. 4

    Encerre o navegador

    Finalize com await browser.close(); para que nenhum processo do Chrome continue em execução.

Perguntas frequentes

O que causa o ERR_NO_SUPPORTED_PROXIES no Puppeteer?

Credenciais dentro da flag, como em --proxy-server=http://user:pass@ip:port. Use --proxy-server=http://ip:port e passe o usuário e a senha via page.authenticate().

Minha primeira aba funciona, mas uma nova aba recebe HTTP 407. Por quê?

A autenticação é armazenada por página. Chame await newTab.authenticate({ username, password }) em cada página aberta antes da navegação.

Um único navegador Puppeteer pode usar vários proxies ao mesmo tempo?

Não apenas pela flag de inicialização. Use o proxy-chain para transformar cada proxy autenticado em um endereço local e atribua a cada contexto do navegador seu próprio proxyServer, ou inicie um navegador por proxy.

Como testo muitos proxies antes de passá-los para o Puppeteer?

Cole-os no verificador de proxy; ele processa até 100 por vez e não armazena senhas.

Por que o page.authenticate() não funciona com meu proxy SOCKS5?

O Chrome não suporta login com usuário e senha para SOCKS5, portanto não há o que o Puppeteer responder. Use o modo HTTP do pedido, um encaminhador local do proxy-chain ou o login por whitelist de IP.

Fontes

IPs sem limite de tráfego para Chrome headless

IPv4 dedicado em 7 países e ISP estático nos EUA e Vietnã, liberados automaticamente após o pagamento, um cliente por IP.

Ver preços dos EUA em tempo real

Related articles

Proxies por plataforma
Proxies para web scraping: pool fixo de IPs com tráfego ilimitado
Proxies de web scraping para Python, Scrapy, Playwright e Selenium: pool de IPs IPv4 privados e ISP estáticos, tráfego ilimitado e preço fixo por IP.
Configuração de proxy
Autenticação de proxy no Playwright: um IP estático por contexto
Defina um proxy HTTP(S) autenticado para cada contexto do Playwright em Node.js ou Python, alinhe fuso horário e locale ao IP e confirme o endereço de saída.
Configuração de proxy
Proxies autenticados no Node.js: Axios, fetch nativo e Got
Roteie requisições Node.js e TypeScript via proxy HTTP(S) autenticado: https-proxy-agent no Axios, undici ProxyAgent no fetch e hpagent no Got.
Ferramentas gratuitas
Reescreva uma lista de proxies no formato que sua ferramenta precisa
Converta listas de proxies no navegador entre ip:port:user:pass, user:pass@ip:port, URLs http://, URIs SOCKS5, arrays JSON e arquivos do FoxyProxy, em lote.
Proxies por plataforma
Proxies para monitoramento de SEO: veja a página de resultados que um usuário local vê
Proxies de SEO com IPv4 privado nos EUA, Reino Unido, Vietnã, Japão e mais 4 mercados, para ver rankings, pacotes locais e anúncios como os usuários locais.
Proxies por plataforma
Proxies para YouTube: impeça que o strike de um canal atinja os demais
Proxies de YouTube para criadores e equipes multicanal: um ISP estático ou IPv4 por canal para que um strike ou encerramento fique restrito a esse canal.
IPV4 · united states
Pool de Proxies IPv4 Privados dos EUA para Scraping, Rastreamento de Ranking e Verificação de Anúncios
Compre proxies IPv4 privados dos EUA: IPs estáticos de datacenter, um cliente por IP e banda ilimitada. Para scraping, rastreio de SERP e checar anúncios.
IPV4 · singapore
Proxy IPv4 Privado de Singapura: Um IP Fixo por Loja e Conta de Anúncios
Proxy IPv4 privado de Singapura: IP de datacenter estático e exclusivo para lojas Lazada e Shopee SG, contas de anúncios em Singapura e automação regional.