Técnico

    Headless Chrome em Docker com proxy

    Como rodar Headless Chrome em Docker com proxy autenticado: imagem base, flags, autenticação de proxy, limites de memória e escala em containers.

    06 de junho de 20266 min de leituraPostado por: Equipe RH7
    Capa do post “Headless Chrome em Docker com proxy”, categoria Tutorial, com identidade visual RH7.
    Compartilhar
    Sumário do artigo

    Executar o Google Chrome em modo headless dentro de containers Docker é o padrão de ouro para automação web moderna, web scraping de alta performance e testes de interface (QA). No entanto, o desafio técnico surge ao tentar equilibrar uma imagem leve, o consumo de recursos e a integração de proxies autenticados. Sem a configuração correta, você enfrenta bloqueios de sites alvo, vazamentos de WebRTC ou instabilidade do processo binário do Chrome em ambientes Linux isolados.

    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.

    Preparando o Dockerfile para Performance

    Proxy residencial rotativa

    Teste com 1 GB

    R$ 9,90 por 1 GB

    Teste com 1 GB

    O maior erro ao criar imagens Docker para Chrome é utilizar imagens base pesadas como Ubuntu completo ou esquecer as dependências essenciais de renderização do Linux. Uma abordagem eficiente utiliza a base node:slim ou python:slim, instalando apenas o que é estritamente necessário para o binário do Chromium rodar.

    Dependências essenciais do Linux

    O Chrome depende de bibliotecas de fontes e renderização que não vêm por padrão em imagens Docker enxutas. Você precisará de pacotes como libnss3, libatk-bridge2.0-0 e libx11-xcb1. Abaixo, um exemplo de Dockerfile otimizado:

    FROM node:18-slim
    ## Instalação das dependências do sistema
    RUN apt-get update && apt-get install -y \
        wget \
        gnupg \
        ca-certificates \
        procps \
        libnss3 \
        libxss1 \
        libasound2 \
        libatk-bridge2.0-0 \
        libgtk-3-0 \
        --no-install-recommends \
        && rm -rf /var/lib/apt/lists/*
    ## Instalação manual do Google Chrome Stable
    RUN wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add - \
        && sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list' \
        && apt-get update \
        && apt-get install -y google-chrome-stable --no-install-recommends \
        && rm -rf /var/lib/apt/lists/*
    
    WORKDIR /app
    COPY . .
    RUN npm install
    CMD ["node", "index.js"]
    

    Configuração de Proxies Autenticados no Headless

    O Chrome Headless possui uma limitação nativa: o parâmetro --proxy-server aceita apenas o IP e a porta, mas não as credenciais (usuário e senha). Tentar passar o proxy no formato http://user:pass@ip:port diretamente no terminal não funciona.

    O problema da autenticação básica

    Para utilizar proxies de Rotativa CPA que exigem autenticação, você tem duas saídas principais: usar uma extensão de navegador para injetar as credenciais ou utilizar um middleware como o Playwright ou Puppeteer, que interceptam as requisições de autenticação a nível de protocolo.

    Implementação com Puppeteer

    No Puppeteer, você pode automatizar a autenticação usando o método page.authenticate(). Isso é essencial para rodar scripts em escala sem intervenção manual.

    const puppeteer = require('puppeteer');
    
    (async () => {
      const browser = await puppeteer.launch({
        headless: "new",
        args: [
          '--no-sandbox',
          '--disable-setuid-sandbox',
          '--proxy-server=SEU_IP_RH7:PORTA'
        ]
      });
      
      const page = await browser.newPage();
      
      // Autenticação do proxy
      await page.authenticate({
        username: 'SEU_USUARIO',
        password: 'SUA_SENHA'
      });
    
      await page.goto('https://meuip.com.br');
      // ... lógica de automação
      await browser.close();
    })();
    

    Gerenciamento de Memória e Shared Memory

    Um problema comum ao rodar Chrome em Docker é o erro de crash "Page Crash" ou "Incurred an Error". Isso ocorre porque o Docker limita o tamanho do diretório /dev/shm (shared memory) a 64MB por padrão, o que é insuficiente para o Chrome renderizar páginas complexas.

    Existem duas formas de resolver isso:

    1. Usar a flag --disable-dev-shm-usage nos argumentos do Chrome. Isso força o uso de /tmp em vez de /dev/shm.
    2. Aumentar o tamanho do shared memory ao rodar o container com a flag --shm-size=2gb.

    A segunda opção garante uma performance superior, pois evita acessos constantes ao disco para cache de renderização.

    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.

    Ferramentas de Teste e Depuração

    Antes de colocar seu container em um cluster Kubernetes ou em um servidor de produção, você precisa validar se o proxy está realmente ativo e se não há vazamento de IP original.

    Você pode utilizar a ferramenta interna de proxy tester para validar a conectividade das suas credenciais. Dentro do Docker, uma forma simples de debugar é printar o IP detectado pelo navegador na primeira execução:

    const response = await page.goto('https://api.ipify.org?format=json');
    console.log(await response.json());
    

    Acompanhar o log de saída do container permite identificar se o tempo de resposta está alto devido à latência do proxy ou ao processamento do container. Para raspagens massivas, prefira comprar Rotativa CPA em regiões próximas ao servidor alvo para reduzir o Round Trip Time (RTT).

    Integração com Proxies da RH7 Proxys

    Utilize os endpoints e credenciais informados no painel da RH7. Para fluxos autorizados que exigem continuidade, avalie sessões sticky e confirme sua duração contratada, sem presumir IP permanente. Rotação pode apoiar amostras regionais independentes, mas não elimina rate limiting: respeite os limites, suspenda recusas e programe retomadas apenas quando permitidas.

    A configuração no Dockerfile permanece a mesma, alterando apenas a lógica de rotação de proxies no seu script de automação para consumir os hosts disponibilizados no painel da plataforma.

    Otimização de Recursos no Ambiente Docker

    Para rodar de forma eficiente, limite os recursos do container. O Chrome é agressivo no uso de CPU. Se você não definir limites, uma única instância travada pode derrubar seu host.

    docker run -d \
      --name chrome-bot \
      --shm-size=2gb \
      --cpus="1.0" \
      --memory="2g" \
      meu-chrome-image
    

    Utilizar o sinalizador --no-sandbox é necessário em muitos ambientes Docker (especialmente se rodar como root), mas tenha consciência de que isso remove uma camada de segurança do navegador. Em ambientes de produção controlados, essa é uma prática comum para viabilizar a execução em containers Linux.

    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.