Playwright + proxy residencial: setup definitivo
Configuração completa do Playwright com proxies residenciais rotativos e fingerprint estável.

Sumário do artigo
Requisitos do acesso autorizado
Use fontes próprias ou autorizadas e APIs documentadas quando disponíveis. Confirme as condições da fonte antes de coletar. Interrompa a tarefa se houver recusa de acesso ou verificação, respeite os limites e procure os canais oficiais em vez de trocar identidade para continuar. Registre localização, horário, escopo permitido e consumo de dados.
Quando usar saídas residenciais no Playwright
Proxy residencial rotativa
Teste com 1 GB
R$ 9,90 por 1 GB
Rotativa CPA e residencial descrevem origens de rede diferentes. Para Playwright, escolha conforme a matriz de QA regional e os requisitos da fonte autorizada. IP residencial não representa confiança superior perante CDNs ou firewalls, nem altera a natureza automatizada da execução.
Em testes autorizados, uma rede residencial pode permitir comparar como uma aplicação própria responde a diferentes saídas de acesso. Registre IP, região e sessão, mantenha limites agregados por domínio e não apresente contextos como pessoas distintas. Nenhum tipo de proxy garante execução sem interrupções ou permite superar recusas de acesso.
Instalação e Preparação do Ambiente
Antes de configurar o proxy, garanta que seu ambiente Node.js está atualizado. O Playwright evolui rápido, e novas versões frequentemente trazem melhorias na forma como o contexto do navegador lida com autenticação de rede.
npm init -y
npm i playwright
npx playwright install chromium
A escolha do Chromium é padrão para a maioria das automações devido à sua engine robusta, mas o Playwright também permite aplicar as mesmas configurações de proxy no Firefox e Webkit de forma nativa.
Configuração Básica de Proxy no Playwright
A maneira mais direta de passar um proxy no Playwright é através do método launch. É recomendável utilizar o formato padrão de servidor:porta para garantir compatibilidade.
const { chromium } = require('playwright');
(async () => {
const browser = await chromium.launch({
proxy: {
server: 'http://seu-servidor-proxy:porta',
username: 'seu-usuario',
password: 'sua-senha'
}
});
const context = await browser.newContext();
const page = await context.newPage();
await page.goto('https://rh7.io/ferramentas/meu-ip');
console.log(await page.textContent('body'));
await browser.close();
})();
Embora funcional, este setup é básico. Para automação profissional, precisamos lidar com a rotação de IPs e a persistência de sessão. Se o objetivo for manter o mesmo IP para uma sequência de ações (como login e extração de dados), você deve utilizar proxies residenciais fixas ou sessões de stickiness em proxies rotativos.
Requisitos do acesso autorizado
Use fontes próprias ou autorizadas e APIs documentadas quando disponíveis. Confirme as condições da fonte antes de coletar. Interrompa a tarefa se houver recusa de acesso ou verificação, respeite os limites e procure os canais oficiais em vez de trocar identidade para continuar. Registre localização, horário, escopo permitido e consumo de dados.
Gerenciamento de Múltiplos Contextos e Sessões
Uma das maiores vantagens do Playwright é a capacidade de isolar sessões através de BrowserContexts. Cada contexto funciona como uma instância de navegador limpa, com seus próprios cookies e cache, sem o overhead de abrir múltiplos processos do executável do Chrome.
Em cenários de scraping massivo, você pode criar um pool de contextos, cada um vinculado a um nó diferente da sua rede de proxies residenciais. Isso otimiza o uso de memória do servidor e acelera a coleta de dados significativamente.
const context1 = await browser.newContext({ proxy: { server: '...' } });
const context2 = await browser.newContext({ proxy: { server: '...' } });
Essa abordagem permite que você teste diferentes estratégias de geolocalização simultaneamente, verificando como o site se comporta em diferentes regiões do Brasil. Para validar o funcionamento de cada nó, utilize ferramentas como o proxy-tester antes de iniciar o loop de automação.
Estratégias de Rotação e Sticky Sessions
Existem dois fluxos principais ao trabalhar com IPs residenciais: a rotação a cada requisição e as sessões persistentes. No primeiro caso, cada page.goto() ou requisição XHR utiliza um novo IP. Isso é ideal para crawlers que varrem milhares de páginas públicas.
Já as Sticky Sessions são fundamentais quando há necessidade de manter o estado. Se você está automatizando um processo de checkout ou acesso a painéis administrativos, o IP deve permanecer o mesmo durante todo o fluxo do usuário dentro do site. No serviço da RH7 Proxys, isso geralmente é controlado via modificação no parâmetro de nome de usuário (ex: usuario-session-12345), informando ao gateway que aquele contexto deve manter o mesmo IP residencial pelo tempo que durar a sessão ou até expirar o TTL (Time to Live).
Otimização de Performance em Automação Larga Escala
Ao escalar o Playwright com milhares de requisições, o consumo de banda e CPU torna-se o principal gargalo. Para economizar recursos (e largura de banda do seu plano de proxy), você deve bloquear o carregamento de recursos desnecessários para a extração de dados, como imagens, estilos CSS e fontes.
await page.route('**/*.{png,jpg,jpeg,gif,svg,css,woff,pdf}', route => route.abort());
Filtrar recursos pode reduzir consumo, mas a economia depende da página e deve ser medida. Em QA visual, bloquear CSS ou imagens pode invalidar o teste; em pesquisa permitida, mantenha os recursos necessários ao dado solicitado. Compare uma execução completa com a versão otimizada e registre as diferenças antes de adotar o filtro.
Depuração e Testes de Conectividade
Antes de colocar o script em produção, é vital validar se o proxy está sendo aplicado corretamente e se não há vazamentos de WebRTC ou DNS que revelem o IP real do seu servidor de automação. O Playwright oferece ferramentas de inspeção, mas a validação programática é mais eficiente.
Acesse serviços de detecção de IP internamente no seu script e logue o resultado. Se o IP retornado for diferente do IP esperado da sua lista de proxies, a configuração de autenticação ou o DNS do sistema pode estar interferindo. Para ferramentas rápidas de validação manual, verifique o meu ip dentro do navegador automatizado.
Se encontrar problemas de timeout ou erros 407 (Proxy Authentication Required), verifique se o seu IP de saída está devidamente autorizado no painel ou se o formato user:pass está seguindo o padrão de caracteres especiais escapados, conforme exigido pela especificação URI.
Requisitos do acesso autorizado
Use fontes próprias ou autorizadas e APIs documentadas quando disponíveis. Confirme as condições da fonte antes de coletar. Interrompa a tarefa se houver recusa de acesso ou verificação, respeite os limites e procure os canais oficiais em vez de trocar identidade para continuar. Registre localização, horário, escopo permitido e consumo de dados.
Requisitos do acesso autorizado
Use fontes próprias ou autorizadas e APIs documentadas quando disponíveis. Confirme as condições da fonte antes de coletar. Interrompa a tarefa se houver recusa de acesso ou verificação, respeite os limites e procure os canais oficiais em vez de trocar identidade para continuar. Registre localização, horário, escopo permitido e consumo de dados.
Requisitos do acesso autorizado
Use fontes próprias ou autorizadas e APIs documentadas quando disponíveis. Confirme as condições da fonte antes de coletar. Interrompa a tarefa se houver recusa de acesso ou verificação, respeite os limites e procure os canais oficiais em vez de trocar identidade para continuar. Registre localização, horário, escopo permitido e consumo de dados.
Proxy residencial rotativa
Teste com 1 GB
R$ 9,90 por 1 GB

Sobre o autor
Equipe RH7
Equipe da RH7 Proxys: proxies residenciais, mobile e Rotativa CPA com suporte humano 24/7 em português.
Categoria
TécnicoNewsletter RH7
Quer mais conteúdo como esse?
Receba 1 email por semana com cases, scripts e bastidores.
Receba novos guias técnicos
1 e-mail por semana, conteúdo prático sobre proxies, scraping e operações.