Técnico

    Playwright + proxy residencial: setup definitivo

    Configuração completa do Playwright com proxies residenciais rotativos e fingerprint estável.

    04 de junho de 20267 min de leituraPostado por: Equipe RH7
    Capa do post “Playwright + proxy residencial: setup definitivo”, categoria Scraping, com identidade visual RH7.
    Compartilhar
    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

    Teste com 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

    Teste com 1 GB
    RH7 Proxys

    Sobre o autor

    Equipe RH7

    Equipe da RH7 Proxys: proxies residenciais, mobile e Rotativa CPA com suporte humano 24/7 em português.

    Gostou do conteúdo?

    Compartilhe este artigo com quem precisa ler.

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