Resposta rápida
Para usar proxies residenciais SocksNode com o Playwright, passe um objeto de proxy para browserType.launch() com server definido como http://global.socksnode.com:9000 e seu nome de usuário e senha gerados. Adicione tokens -country ao nome de usuário para segmentação geográfica e use a porta 10000 com um token de sessão para manter um único IP em um browser context.
Antes de começar
A SocksNode oferece proxies residenciais em mais de 195 países, via HTTP, HTTPS e SOCKS5, com autenticação por nome de usuário e senha. Gere as credenciais no gerador de proxy do painel; essa etapa é gratuita e apenas o tráfego roteado usa sua largura de banda pré-paga (a partir de 5 GB por US$ 4,50, sem validade nos planos flexíveis).
O Playwright aceita credenciais de proxy diretamente nas opções de inicialização, então não é necessário nenhum manipulador separado de evento de autenticação.
Configure o proxy no Playwright
Defina o proxy na chamada de inicialização:
Você também pode aplicar proxies por context com browser.newContext({ proxy: {...} }), o que permite que um único browser execute vários perfis geográficos lado a lado apenas mudando o token do nome de usuário.
import { chromium } from 'playwright';
const browser = await chromium.launch({
proxy: {
server: 'http://global.socksnode.com:9000',
username: 'USERNAME-country-us',
password: 'PASSWORD',
},
});
const page = await browser.newPage();
await page.goto('https://api.ipify.org');Sessões rotativas vs. persistentes
As sessões rotativas entregam um novo IP residencial por requisição na porta HTTP 9000, ideal para crawling distribuído e de alto volume.
As sessões persistentes fixam um IP de 1 minuto a 24 horas na porta HTTP 10000. Use um token como USERNAME-country-us-session-shop1-lifetime-60 para manter o mesmo IP por uma sessão de 60 minutos. O Playwright oferece suporte a proxies HTTP autenticados, então prefira as portas HTTP quando precisar de autenticação por nome de usuário e senha.
Segmentação geográfica com tokens no nome de usuário
A segmentação fica no nome de usuário: país para mais de 195 países, estado e cidade nos EUA, ou ASN/ISP dentro de um país. Altere apenas o nome de usuário para mover os pontos de saída entre regiões sem tocar nos caminhos do seu código.
Colete dados de forma responsável, respeite os termos de serviço dos sites e cumpra as leis aplicáveis e taxas razoáveis de requisição.
Veja também
Perguntas frequentes
Posso definir um proxy diferente por browser context?
Sim. Passe um objeto de proxy para browser.newContext(), alterando o token do nome de usuário por context para executar vários países ou sessões persistentes em um único browser.
Quais portas funcionam com o Playwright?
Use HTTP 9000 (rotativo) ou 10000 (persistente). O SOCKS5 autenticado não é confiável no Chromium, então as portas HTTP são recomendadas ao usar autenticação por nome de usuário e senha.
Como faço para manter um único IP durante todo um fluxo?
Use a porta 10000 e adicione um token de sessão e validade, por exemplo USERNAME-country-us-session-abc-lifetime-30, para manter o IP por até 24 horas.
Como faço para segmentar um país?
Anexe o token de país ao seu nome de usuário, como USERNAME-country-de para a Alemanha. A SocksNode cobre mais de 195 países, além de segmentação por estado dos EUA, cidade e ASN.
Credenciais não usadas expiram?
As credenciais não expiram e são gratuitas para gerar. Nos planos flexíveis pré-pagos, seu saldo de largura de banda não tem validade; apenas o tráfego o consome.


