Guia do Playwright · 1 min de leitura

Guia de configuração de proxy do Playwright

O Playwright torna os proxies de primeira classe: um objeto proxy com servidor, nome de usuário e senha, configurado no nível do navegador ou do contexto. Aqui está a configuração limpa para proxies s4m autenticados em Python e Node.

Um objeto proxy, dois escopos

Ao contrário do Puppeteer, o Playwright aceita credenciais diretamente na opção proxy, portanto não há uma etapa de autenticação separada. O objeto possui três campos: server (o host e a porta, com esquema), além de username e password. O Playwright responde ao desafio 407 do proxy para você.

Você pode definir esse objeto em dois escopos. Passá-lo para browser_type.launch(proxy=...) aplica um proxy a todo o navegador. Passá-lo para browser.new_context(proxy=...) limita o proxy a um único contexto — que é como você executa várias identidades, cada uma com sua própria saída, dentro de um navegador. Para s4m, use server="http://proxy.s4m.online:3128" com seu USER:PASS; o endpoint HTTP é a escolha confiável para navegadores. O Playwright também suporta SOCKS5 via socks5://proxy.s4m.online:1080, embora o SOCKS5 autenticado em um navegador seja melhor evitado. Mais na página do proxy e no guia do Puppeteer.

Playwright com um proxy autenticado

Python e Node, ambos configurando servidor + nome de usuário + senha. O escopo de nível de contexto permite que cada contexto use sua própria saída.

python
# pip install playwright && playwright install chromium
from playwright.sync_api import sync_playwright

PROXY = {
    "server": "http://proxy.s4m.online:3128",  # HTTP endpoint
    "username": "USER",
    "password": "PASS",
}

with sync_playwright() as p:
    # Option A: proxy for the whole browser
    browser = p.chromium.launch(proxy=PROXY, headless=True)

    # Option B: proxy scoped to a single context (per-identity)
    context = browser.new_context(proxy=PROXY)
    page = context.new_page()
    page.goto("https://api.ipify.org?format=json", timeout=30000)
    print("Exit IP:", page.inner_text("body"))
    browser.close()

# ----- Node equivalent -----
# const { chromium } = require("playwright");
# const proxy = {
//   server: "http://proxy.s4m.online:3128",
//   username: "USER", password: "PASS",
// };
# (async () => {
//   const browser = await chromium.launch({ proxy, headless: true });
//   const page = await browser.newPage();
//   await page.goto("https://api.ipify.org?format=json");
//   console.log(await page.innerText("body"));
//   await browser.close();
// })();

Configure isso

Da instalação a uma execução verificada por proxy.

Instalar navegadores

Execute pip install playwright e depois playwright install chromium (ou npm i playwright). O Playwright baixa sua própria versão do navegador, portanto, o Chrome do sistema não é necessário.

Construa o objeto proxy

Defina o servidor para http://proxy.s4m.online:3128 e preencha o nome de usuário e a senha com suas credenciais s4m. Nenhuma chamada de autenticação separada é necessária.

Escolha um escopo

Passe o proxy para launch() para uma saída em todo o navegador, ou para new_context() quando você quiser que cada contexto use seu próprio IP para múltiplas identidades.

Confirme a saída

Navegue até um endpoint de eco de IP e leia o corpo para verificar se o tráfego realmente está saindo pelo proxy antes de construir o restante do fluxo.

Identidades por contexto e limites honestos

Os proxies em nível de contexto são o superpoder do Playwright para automação em grande escala: um processo de navegador, muitos contextos, cada um isolado com seus próprios cookies e seu próprio IP de saída. Isso é mais limpo e leve do que lançar um navegador por identidade. Combine com configurações distintas de User-Agent e viewport por contexto para que cada identidade seja internamente consistente.

A mesma honestidade se aplica como em qualquer outro lugar. Os proxies s4m são datacenter SOCKS5 e HTTP — rápidos e estáveis, ideais para testes e monitoramento, mas não disfarçados como conexões residenciais, então sites fortemente protegidos podem sinalizá-los. Um proxy muda seu IP, não sua impressão digital de navegador ou seu comportamento, então trate-o como uma camada entre várias. Quando um serviço espera um único endereço estável, adicione um IP pessoal dedicado. Verifique saídas e portas com as ferramentas, explore a API e teste de forma econômica primeiro com a lista de proxies gratuitos.

FAQ

Perguntas, respondidas

Preciso de uma etapa de autenticação separada no Playwright?

Não. Ao contrário do Puppeteer, o Playwright recebe nome de usuário e senha diretamente em seu objeto proxy, junto com o servidor. Ele lida automaticamente com o desafio 407 para você.

Posso dar a cada contexto seu próprio proxy?

Sim. Passe um objeto proxy para browser.new_context(proxy=...) e esse contexto usa sua própria saída. Esta é a maneira limpa de executar múltiplas identidades dentro de um navegador.

Devo usar o endpoint HTTP ou SOCKS5?

Para navegadores, use o endpoint HTTP na porta 3128 — é a escolha confiável. O Playwright também suporta SOCKS5, mas SOCKS5 autenticado em um navegador é melhor evitar.

Os proxies s4m são residenciais?

Não. Eles são proxies SOCKS5 e HTTP de datacenter autenticados, pagos conforme o uso. Ótimos para testes e monitoramento, embora sistemas anti-bot agressivos possam sinalizar faixas de datacenter.

Automatize navegadores atrás de um proxy

Coloque proxy.s4m.online diretamente no objeto de proxy do Playwright, escopo por contexto e pague apenas pelo tráfego que você usa. Adicione um IP dedicado para saídas estáveis e por identidade.

As pessoas encontraram esta página pesquisando por

Frases de busca reais que esta página responde — os links abrem a página que as cobre em profundidade.