Puppeteer com proxy autenticado: flag de inicialização e login
Pela equipe de engenharia da ProxyV4 · 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.
--proxy-server=http://ip:port + page.authenticate({ username, password })- 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
- 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
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.
| Ordem | Chamada | O que faz |
|---|---|---|
| 1 | puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }) | Informa ao Chrome qual proxy todas as requisições devem usar |
| 2 | await page.authenticate({ username, password }) | Fornece as credenciais quando o proxy responde com 407 |
| 3 | await 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 combrowser.newPage()precisa de sua própria chamada antes do primeirogoto() - 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:portpela funçãoanonymizeProxy()do pacoteproxy-chaine passe o resultado comoproxyServerparabrowser.createBrowserContext({ proxyServer }) - A configuração funciona da mesma forma com o
puppeteer-extrae opuppeteer-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
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
Autentique a aba
Abra uma página com
const page = await browser.newPage();e chameawait page.authenticate({ username: 'USER', password: 'PASS' });antes de qualquer navegação. - 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
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