Como configurar um proxy móvel para Puppeteer
Puppeteer é uma estrutura de automação web, especificamente projetada para navegadores baseados em Chromium, que opera principalmente como uma biblioteca JavaScript/Node.js. Funciona melhor para automação precisa e de baixo nível, sendo fundamental na gestão de múltiplas contas e otimização de negócios web, onde várias ações devem ser executadas regularmente e rapidamente.
O Puppeteer destaca-se no controlo granular do navegador, tornando a integração de proxy do Puppeteer a base para automação confiável em escala.
Escolher um proxy Puppeteer: proxies móveis CyberYozh
Como o Puppeteer funciona melhor para automação web, os proxies móveis são a escolha ideal para o Puppeteer. Eles possuem a pontuação de confiança mais elevada entre todos os tipos de proxy, pelo que as plataformas não restringirão as suas sessões durante atividades de automação.

Para gestão de redes sociais, fluxos de trabalho com múltiplas contase qualquer plataforma que aplique análise comportamental rigorosa, os proxies móveis replicam tráfego genuíno de operadoras que os sistemas reconhecem como utilizadores reais.
Combine proxies móveis com telefones em nuvem ou navegadores antidetecção para alcançar isolamento completo de impressão digital, no qual cada sessão recebe uma assinatura de dispositivo única, identidade de rede e endereço IP, eliminando a ligação entre contas.
Outras opções: Proxies residenciais e de datacenter
Embora os proxies móveis ofereçam a melhor solução para a maioria dos fluxos de trabalho do Puppeteer com risco mínimo de restrição, outros tipos de proxy servem os seus próprios casos de uso como servidor proxy Puppeteer:
Proxies residenciais rotativos oferecem a escolha padrão para a maioria das tarefas de recolha de dados, com um grande conjunto de IPs em mais de 100 países. No Puppeteer, utilize-os para tarefas de scraping em massa que requerem rotação de IP por solicitação. Configure o sufixo -res-any no seu nome de utilizador para permitir que o fornecedor gira automaticamente o proxy do Puppeteer.
Proxies residenciais estáticos atribuem um único IP persistente por sessão, tornando-os confiáveis para fluxos de trabalho vinculados a contas com níveis moderados de automação Puppeteer. Utilize-os quando a plataforma exigir continuidade de sessão, como painéis de controlo com login ou fluxos de checkout.
Proxies de datacenter são muito rápidos, mas as plataformas tendem a sinalizar os seus padrões de tráfego não residencial. No Puppeteer, utilize-os apenas para testes de API, benchmarking de desempenho e QA automatizado em ambientes de staging onde a deteção de bots é mínima.
Compare proxies residenciais e móveis num artigo especializado da CyberYozh. Escolha qual funciona melhor para si.
Preparar o seu trabalho com proxies Puppeteer
O Puppeteer inicia uma entidade de navegador headless com uso mínimo de tráfego de rede e, em seguida, automatiza processos como abrir e fechar páginas, cliques do rato, entrada de teclado e outras tarefas executadas durante atividades web comuns.
Um navegador headless é uma instância Chromium que processa páginas web e executa JavaScript sem renderizar uma GUI visível, reduzindo significativamente a carga de recursos. Por padrão, o Puppeteer utiliza o modo headless (headless: true). Passe headless: false para iniciar uma sessão de navegador visível para depuração. Leia mais na documentação da API do Puppeteer.
Criar uma conta CyberYozh
Cadastre-se no CyberYozh, navegue até Meus Proxiese adquira o tipo de proxy para sua tarefa: proxy móvel para automação e fluxos de trabalho em redes sociais, ou residencial rotativo para scraping.

Abra o cartão do seu proxy, clique em Gerar Credenciais, escolha seu modo de rotação (IP Aleatório, Sessão Curta ou Sessão Longa) e salve o host, porta, nome de usuário e senha.
Configurar o Puppeteer no seu PC
O Puppeteer requer Node.js (v18+) e um gerenciador de pacotes (por exemplo, npm ou yarn). Inicialize seu projeto e instale a biblioteca:
# Initialize Node.js project
npm init -y
# Install Puppeteer (includes bundled Chromium)
npm install puppeteer# Alternatively, with Yarn:
yarn add puppeteerUse o Puppeteer no seu código JavaScript
Existem duas variantes de pacote para fluxos de trabalho de proxy com Puppeteer:
puppeteer — o pacote completo que baixa e agrupa automaticamente um binário do Chromium compatível. Use este para a maioria dos scripts de automação independentes.
puppeteer-core — uma versão leve sem navegador incluído. Use-o quando você controlar o caminho do binário do navegador (por exemplo, uma instalação específica do Chrome ou um ambiente em nuvem). Requer que você especifique executablePath explicitamente.
// puppeteer (full, with bundled Chromium):
const puppeteer = require('puppeteer');
// puppeteer-core (no bundled browser):
const puppeteer = require('puppeteer-core');
// Must also pass: executablePath: '/path/to/chrome' Iniciando fluxos de trabalho de automação com CyberYozh
Agora você pode prosseguir com seu projeto Puppeteer. Comece com a estrutura do seu projeto, adicione as credenciais de proxy do Puppeteer ao ambiente e, em seguida, importe o Puppeteer para seus scripts Node.js.
Use --proxy-server como argumento de inicialização do Chromium, que roteia todo o tráfego de rede no nível do navegador através do endereço e porta do proxy especificados. É passado dentro do array args de puppeteer.launch().
Crie a estrutura do seu projeto
Organize a pasta do seu projeto, separando credenciais, scripts, configuração e saída desde o início:
.env ficheiro para credenciais de proxy (adicione ao .gitignore)
.gitignore para especificar o que não será partilhado via Git, ou seja, credenciais de proxy
index.js para o script principal do Puppeteer
config/browser.js para opções de inicialização do navegador, numa pasta separada
output/ pasta para dados extraídos (JSON/CSV)
Atribua um proxy no ficheiro .env
Adicione as suas credenciais do CyberYozh como variáveis de ambiente. Nunca as codifique diretamente nos ficheiros de código-fonte para evitar a fuga de credenciais para o controlo de versões.
PROXY_HOST=your_proxy_ip
PROXY_PORT=your_proxy_port
PROXY_USER=your_username
PROXY_PASS=your_passwordImporte e configure o Puppeteer
Instale o dotenv para carregar as variáveis do .env:
npm install dotenvEm seguida, configure as opções do servidor proxy do Puppeteer:
// index.js
require('dotenv').config();
const puppeteer = require('puppeteer'); // or puppeteer-core
const PROXY = `${process.env.PROXY_HOST}:${process.env.PROXY_PORT}`; Crie uma sessão de navegação do Puppeteer
Defina a entidade do navegador com o argumento do servidor proxy HTTP do Puppeteer , e depois autentique a página. Por predefinição, a sessão é headless:
(async () => {
const browser = await puppeteer.launch({
headless: true, // false for debugging
args: [`--proxy-server=http://${PROXY}`]
});
const page = await browser.newPage();
// Authenticate with CyberYozh credentials
await page.authenticate({
username: process.env.PROXY_USER,
password: process.env.PROXY_PASS
});
// Access the target site and show its content
await page.goto('https://httpbin.org/ip');
const content = await page.content();
console.log(content);
// Perform the automation or scraping operations using JS commands as needed
// Close the session
await browser.close();
})(); Conforme observado num tópico muito votado no Stack Overflow sobre o uso de proxy no Puppeteer, a flag --proxy-server deve ser passada no lançamento do navegador: não pode ser alterada por página após o lançamento.
Implemente o seu código e monitorize o processo
Execute o seu script de automação a partir da raiz do projeto e verifique se a rotação de IP está a funcionar:
node index.jsPara rotação de proxy do Puppeteer em múltiplas sessões, mantenha um conjunto de proxies e reatribua proxies reiniciando as instâncias do navegador.
Use a chave da API do CyberYozh com o IP Checker para automatizar a rotação e verificar a qualidade de cada IP recebido antes de usar, minimizando o risco de restrições durante operações em massa com múltiplas contas.
📚 Leia mais sobre o CyberYozh
Resumo: Usando proxy do Puppeteer de forma eficiente
A integração de proxy do Puppeteer com proxies móveis CyberYozh fornece a base mais confiável para automação web. Combina controle de navegador Node.js com IPs móveis de alta confiança e rotação orientada por API para sustentar fluxos de trabalho de automação empresarial e multi-contas em escala sem acionar restrições de plataforma.
FAQ sobre proxies do Puppeteer
O que é um proxy do Puppeteer e por que preciso de um?
Um proxy do Puppeteer roteia o tráfego do seu navegador headless através de um endereço IP externo, mascarando sua origem. Previne banimentos de IP, permite segmentação geográfica e faz com que sessões automatizadas pareçam atividade orgânica de usuários.
Como uso um proxy no Puppeteer?
Passe a flag --proxy-server=host:port dentro do array args de puppeteer.launch(), depois chame page.authenticate({ username, password }) para servidores proxy privados. Nenhuma biblioteca adicional é necessária para configurações básicas.
Qual é a diferença entre puppeteer e puppeteer-core?
puppeteer inclui um binário Chromium compatível e está pronto para usar após npm install. puppeteer-core é uma versão leve sem navegador incluído; você deve fornecer o executablePath para uma instalação existente do Chrome ou Chromium.
O Puppeteer suporta proxies SOCKS5?
Sim. Passe --proxy-server=socks5://host:port no array args. Proxies SOCKS5 suportam tunelamento completo em nível TCP, que inclui tráfego não-HTTP que proxies HTTP não conseguem retransmitir.
Como funciona a rotação de proxy do Puppeteer?
Com proxies rotativos CyberYozh, a rotação está integrada na infraestrutura de proxy: cada nova conexão ou sessão usa um IP novo. Para rotação por navegador no Puppeteer, relance uma nova instância do navegador com puppeteer.launch() para cada proxy no seu pool.
Posso definir um proxy diferente por página no Puppeteer?
Não nativamente no nível da página: a flag --proxy-server se aplica globalmente ao processo do navegador. Para proxies por sessão, lance uma instância de navegador separada para cada proxy, ou use o módulo npm puppeteer-page-proxy para interceptação por página.
Qual tipo de proxy CyberYozh devo usar para automação de redes sociais no Puppeteer?
Proxies móveis são a escolha correta: eles replicam tráfego real de operadoras e carregam a maior pontuação de confiança em plataformas como Instagram, TikTok e X. Combine com navegadores antidetect para isolamento completo de impressão digital.
Como previno vazamentos de IP no Puppeteer?
Desative o WebRTC para evitar que ele transmita seu IP real: passe --disable-webrtc ou sobrescreva RTCPeerConnection via page.evaluateOnNewDocument(). Certifique-se também de que as consultas DNS sejam roteadas através do proxy, não resolvidas localmente.
Como verifico se o proxy está funcionando no Puppeteer?
Navegue até https://httpbin.org/ip ou https://app.cyberyozh.com/checkers/ip-address/ dentro da sua sessão Puppeteer. O IP retornado deve corresponder ao endereço do seu proxy. Se ainda mostrar o seu IP de origem, verifique se page.authenticate() foi chamado antes de page.goto().
O que devo fazer se minha automação Puppeteer ainda for bloqueada?
Verifique se os seus IPs têm uma pontuação de fraude baixa usando o CyberYozh IP Checker, reduza os intervalos entre solicitações e randomize as strings de user-agent e os tamanhos de viewport. Para plataformas de alta segurança, combine os proxies móveis do CyberYozh App com um navegador antidetecção.
O Puppeteer funciona com proxies HTTP e HTTPS?
Sim. A flag --proxy-server suporta os esquemas http:// e https:// e o Puppeteer fará o túnel do tráfego HTTPS através de tunelamento CONNECT automaticamente via proxy.
