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.

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
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:
- Usar a flag
--disable-dev-shm-usagenos argumentos do Chrome. Isso força o uso de/tmpem vez de/dev/shm. - 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

Sobre o autor
Equipe RH7
Equipe da RH7 Proxys: proxies residenciais, mobile e Rotativa CPA com suporte humano 24/7 em português.
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.