Como configurar seu Proxy Móvel em ferramentas de automação de navegador

Depois de ativar seu Proxy Móvel dedicado, você tem em mãos quatro informações: host, porta, protocolo (SOCKS5 ou HTTP) e credenciais (usuário e senha). Este guia mostra como usar cada uma nas ferramentas de automação de navegador mais comuns em times de QA e desenvolvimento.

Antes de começar, tenha em mãos os dados do seu proxy — disponíveis na seção "Meus Proxies" do seu painel, com um botão de copiar ao lado de cada campo.

Puppeteer

O Puppeteer recebe o proxy como argumento de inicialização do navegador, e a autenticação é feita separadamente via `page.authenticate()`:

• Inicie o navegador passando `--proxy-server=protocolo://host:porta` em `args` (ex: `--proxy-server=socks5://seu-host:sua-porta`).
• Abra uma nova página e chame `page.authenticate({ username: 'seu-usuario', password: 'sua-senha' })` antes de navegar.
• Confirme a conexão navegando pra uma página de verificação de IP e conferindo se o endereço bate com o do seu painel.

Playwright

O Playwright tem suporte nativo a proxy autenticado direto nas opções de lançamento do navegador:

• Ao chamar `chromium.launch()` (ou `firefox`/`webkit`), passe o objeto `proxy: { server: 'protocolo://host:porta', username: 'seu-usuario', password: 'sua-senha' }`.
• O mesmo objeto `proxy` também pode ser passado em `browser.newContext()`, se você quiser proxies diferentes por contexto dentro do mesmo processo.
• Use `page.goto()` pra uma página de verificação de IP como primeiro passo do seu teste, confirmando a conexão antes do restante do fluxo.

Selenium

O Selenium não tem suporte nativo a autenticação de proxy por usuário/senha na maioria dos drivers — a forma mais confiável é rodar via Selenium Grid com um nó dedicado por trás do seu Proxy Móvel (o nó todo sai por aquele IP, sem precisar de autenticação por sessão), ou usar uma extensão de autenticação de proxy no navegador controlado. Se seu fluxo já usa Grid, basta apontar o nó/container pra usar o host e a porta do seu proxy como saída de rede padrão.

Dicas que valem para as três

• Sempre valide a conexão logo no início do fluxo, com uma checagem simples de IP — evita perder tempo depurando um teste que na verdade é só uma porta ou credencial errada.
• Não reutilize as credenciais do seu proxy em execuções paralelas que exigem IPs diferentes — isso anula o propósito da exclusividade.
• Anote a data de vencimento do seu plano; o proxy é automaticamente encerrado nessa data, e uma renovação a tempo evita falha de conexão em pipelines automatizados.

Se algo não conectar

Confira, nessa ordem: se o host/porta foram copiados sem espaços extras, se o protocolo configurado na ferramenta bate com o do seu proxy, e se o plano ainda está dentro da validade no seu painel. Se tudo estiver correto e a conexão continuar falhando, abra um chamado pelo WhatsApp ou Telegram — nossa equipe confirma a disponibilidade da infraestrutura do seu lado.