Guias · Automação de Navegadores

Como usar proxies com Puppeteer, Playwright e Selenium

Navegadores automatizados exigem proxies para isolar IPs entre sessões ou acessar páginas como usuários de outro país. O desafio comum é que o Chrome ignora nomes de usuário e senhas no argumento --proxy-server, de modo que cada biblioteca oferece seu próprio método para lidar com a autenticação de proxy.

Autor: Bùi Toàn · Atualizado: 19/11/2026

Playwright (Node.js, Python)

  • Ao iniciar um navegador: chromium.launch({ proxy: { server: "http://IP:PORT", username: "user", password: "pass" } }).
  • Um proxy por contexto: browser.newContext({ proxy: { server, username, password } }). Uma única instância do navegador pode executar múltiplos contextos, cada um com seu próprio IP, consumindo muito menos recursos do que iniciar vários navegadores.
  • O Python usa a mesma estrutura com um dicionário: p.chromium.launch(proxy={"server": "http://IP:PORT", "username": "user", "password": "pass"}).
  • O Firefox e o WebKit no Playwright aceitam exatamente a mesma configuração de proxy.

Puppeteer

  1. Inicie o navegador com a flag de linha de comando: puppeteer.launch({ args: ["--proxy-server=http://IP:PORT"] }).
  2. Para cada página, chame await page.authenticate({ username: "user", password: "pass" }) antes de page.goto.
  3. Se precisar de vários proxies em um único navegador, use browser.createBrowserContext({ proxyServer: "http://IP:PORT" }) em versões modernas do Puppeteer, junto com page.authenticate em cada página.
  4. Verifique a conectividade navegando até https://api.ipify.org e lendo o corpo da resposta.

O Selenium pode usar proxies com usuário e senha?

Sim, mas não diretamente. O ChromeDriver não possui parâmetro para usuário e senha de proxy, e a caixa de diálogo de autenticação de proxy do Chrome não pode ser controlada com o Selenium padrão. As alternativas comuns incluem: usar a biblioteca selenium-wire (Python), que aceita proxies no formato http://user:pass@IP:PORT; criar uma pequena extensão do Chrome para gerenciar eventos de autenticação e carregá-la na inicialização; ou usar o Firefox com um perfil onde as credenciais do proxy já estejam salvas. Para novos projetos, o Playwright torna isso muito mais simples.

O que você deve considerar ao executar o Playwright e o Puppeteer com proxies a longo prazo?

Defina timeouts e novas tentativas em erros de rede, feche páginas e contextos ao concluir e limite as sessões simultâneas por IP para evitar erros 429.

  • Defina tempos limite de navegação adequados (30–60 segundos) e implemente lógica de repetição para falhas de rede temporárias.
  • Feche páginas e contextos prontamente após a conclusão para evitar o vazamento de conexões ociosas.
  • Limite as sessões simultâneas executadas em um único IP; os serviços de destino podem retornar 429 se o volume de solicitações de um endereço for muito alto.
  • Alinhe o fuso horário e a localidade do contexto com o país do proxy (timezoneId, locale no Playwright).

Precisa de um proxy? Compre proxies dedicados com ativação automática

Proxies IPv4 dedicados em 9 países a partir de 20.000₫/IP/mês na compra a partir de 2.000 IPs (39.000₫ para 1 IP) e proxies ISP estáticos no Vietnã e EUA. HTTP(S) e SOCKS5 com usuário e senha, largura de banda ilimitada, ativados automaticamente após o pagamento. Observe que os proxies do Vietnã usam atualmente o protocolo HTTP(S) e ainda não suportam SOCKS5.

Comprar proxies agora

Perguntas Frequentes

Por que --proxy-server=http://user:pass@IP:PORT não funciona?+

O Chrome ignora o nome de usuário e a senha nesse argumento. Em vez disso, use page.authenticate (Puppeteer) ou os parâmetros de proxy nativos do Playwright.

Os proxies da ONET podem ser usados com navegadores headless?+

Sim. Os proxies funcionam de forma idêntica sendo executados no modo headless ou GUI.