Playwright

Como usar proxies residenciais SocksNode com Playwright

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.

Node.js 18+ com @playwright/test ou playwright instalado
Browsers instalados via npx playwright install
Uma conta SocksNode com largura de banda pré-paga
Um nome de usuário e senha de /dashboard/generator
O token de país para sua região de destino

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.

Posts relacionados

Todos os posts

Comece.

Crie uma conta, gere uma credencial, conecte. A API é a mesma que o painel usa.