Autenticação de proxy no Playwright: um IP estático por contexto
Pela equipe de engenharia da ProxyV4 · Updated:
O proxy no Playwright é configurado com um objeto proxy contendo server, username e password, e o próprio Playwright responde ao desafio 407 do proxy, sem extensões ou wrappers. Defina-o em launch() para cobrir todo o navegador ou em newContext() para atribuir a cada contexto isolado um IP ProxyV4 diferente no mesmo processo do navegador. As mesmas chaves funcionam para Chromium, Firefox e WebKit, seja em Node.js ou Python.
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
- 1 IPUS$ 2,25
- 3+ IPsUS$ 2,10
- 10+ IPsUS$ 2,00
- 25+ IPsUS$ 1,90
- 50+ IPsUS$ 1,80
- 100+ IPsUS$ 1,70
- 200+ IPsUS$ 1,60
- 500+ IPsUS$ 1,50
O objeto proxy, chave por chave
| Chave | Valor de exemplo | Observações |
|---|---|---|
server | 'http://ip:port' | Apenas endereço e porta; as credenciais não vão nesta string |
username | 'user' | O nome de usuário do seu pedido na ProxyV4 |
password | 'pass' | Enviada automaticamente quando o proxy responde 407 |
bypass | 'localhost,127.0.0.1' | Lista opcional de hosts que não devem usar o proxy |
Em todo o navegador ou por contexto
Passar proxy para chromium.launch() direciona todas as páginas do navegador por um único IP, o que é ideal para uma única tarefa com uma única identidade. Passá-lo para browser.newContext() é o padrão para múltiplas contas: cada contexto tem seus próprios cookies, armazenamento e proxy, permitindo que um único processo do Chromium execute várias sessões, cada uma com um endereço de saída diferente.
Como cada IPv4 privado da ProxyV4 é alugado para um único cliente e mantém o mesmo endereço na renovação, você pode mapear nomes de contexto para IPs na configuração e reutilizar esse mapeamento execução após execução; um site que identificou a conta A em um determinado IP na semana passada verá o mesmo IP hoje.
Detalhes para manter a consistência dos contextos
- Algumas combinações de Playwright e Chromium no Windows e macOS recusam proxies por contexto, a menos que o navegador também tenha sido iniciado com um proxy; inicie com o placeholder
proxy: { server: 'http://per-context' }e substitua-o em cada contexto - Defina
timezoneIdelocaleemnewContext()para corresponder ao país do proxy (por exemplo,America/New_Yorkpara um IP dos EUA,Asia/Ho_Chi_Minhpara o Vietnã), garantindo que o relógio e a saída deIntlcoincidam com o IP - Bloqueie imagens e fontes com
page.route()quando precisar apenas de texto; as páginas carregam mais rápido e a execução termina antes - Feche os contextos que não estiver mais usando; cada um mantém suas próprias conexões abertas
Passo a passo
- 1
Divida a linha do seu proxy
A partir da linha
ip:port:user:passno seu pedido da ProxyV4, useip:portparaservere os dois últimos campos parausernameepassword. - 2
Crie um contexto com o proxy
Chame
const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } }). - 3
Ajuste o fuso horário e o idioma
Adicione
timezoneIdelocalereferentes à localização do proxy nas mesmas opções denewContext(). - 4
Carregue o endpoint de IP
Abra
const page = await context.newPage(), acertehttps://proxyv4.com/api/my-ipe verifique se o endereço exibido é o IP do proxy. Fazer um teste de vazamento WebRTC no mesmo contexto é uma ótima verificação adicional.
Perguntas frequentes
O Playwright exibe 'Proxy is only supported when browser is launched with a proxy'. Como resolver?
No Windows e macOS, o Chromium pode exigir um proxy no nível de inicialização antes de aceitar configurações por contexto. Inicie com chromium.launch({ proxy: { server: 'http://per-context' } }) e, em seguida, defina o endereço e login reais em cada browser.newContext({ proxy }).
A mesma configuração de proxy funciona no Firefox e WebKit?
Sim. O formato proxy: { server, username, password } é compartilhado pelos três motores e pelas APIs em Node.js e Python, mudando apenas o inicializador (firefox, webkit).
Navegadores headless consomem franquia de tráfego?
Não nos planos de IPv4 privado ou ISP estático da ProxyV4; a largura de banda em ambos é ilimitada, portanto páginas pesadas não geram custos adicionais.
As páginas falham com erro de túnel em vez de carregar. O que devo verificar?
Confirme se server utiliza http:// e a porta correta, e se o proxy ainda está ativo no seu painel. O guia de conexão de túnel aborda as demais causas.
Fontes
Um IP privado por contexto do Playwright
Proxies HTTP(S) com usuário e senha em 7 países, tráfego ilimitado e o mesmo endereço na renovação.
Ver preços dos EUA em tempo real