Guia do Selenium · 2 min de leitura

Configuração de proxy Selenium em Python e Java

O Selenium pode direcionar um navegador através de um proxy em algumas linhas — mas proxies autenticados precisam de uma extensão ou um helper de saída, porque o Chrome não aceitará USER:PASS na linha de comando. Aqui está o padrão confiável.

Comece agora

O problema de autenticação no Selenium

Setting an unauthenticated proxy in Selenium is trivial: add --proxy-server=http://host:3128 to Chrome options, or fill Selenium's Proxy object, and you are done. The moment the proxy needs a username and password, that simple path breaks — Chrome refuses credentials inline, and unlike Puppeteer or Playwright, Selenium has no built-in authenticate() hook to answer the 407 challenge.

A solução robusta e multiplataforma é uma pequena extensão do Chrome gerada em tempo de execução que carrega suas credenciais e responde ao pedido de autenticação do proxy através da API webRequest. Funciona sem cabeça, não precisa de serviços extras e se comporta da mesma forma em Python e Java. Com s4m, você aponta a extensão para proxy.s4m.online:3128 (HTTP) e seu USER:PASS. Veja a página do proxy e o guia de autenticação para mais informações; para uma opção sem autenticação durante os testes, a lista gratuita tem proxies abertos que você pode inserir diretamente na flag da linha de comando.

Proxy autenticado via uma extensão gerada

Este helper Python escreve uma extensão do Chrome descartável contendo suas credenciais e, em seguida, a carrega. Substitua USER:PASS antes de executar.

python
import os, zipfile, tempfile
from selenium import webdriver

HOST, PORT, USER, PASS = "proxy.s4m.online", 3128, "USER", "PASS"

manifest = '{"version":"1.0.0","manifest_version":2,"name":"s4m-proxy",'\
  '"permissions":["proxy","webRequest","webRequestBlocking","<all_urls>"],'\
  '"background":{"scripts":["bg.js"]}}'

bg = ('var c={mode:"fixed_servers",rules:{singleProxy:'
      '{scheme:"http",host:"%s",port:%d}}};'
      'chrome.proxy.settings.set({value:c,scope:"regular"},function(){});'
      'chrome.webRequest.onAuthRequired.addListener('
      'function(d){return {authCredentials:{username:"%s",password:"%s"}};},'
      '{urls:["<all_urls>"]},["blocking"]);') % (HOST, PORT, USER, PASS)

path = os.path.join(tempfile.mkdtemp(), "s4m_proxy.zip")
with zipfile.ZipFile(path, "w") as z:
    z.writestr("manifest.json", manifest)
    z.writestr("bg.js", bg)

opts = webdriver.ChromeOptions()
opts.add_extension(path)
driver = webdriver.Chrome(options=opts)
driver.get("https://api.ipify.org")
print("Exit IP:", driver.find_element("tag name", "body").text)
driver.quit()

# ----- Java (unauthenticated proxy) -----
// Proxy p = new Proxy();
// p.setHttpProxy("proxy.s4m.online:3128");
// ChromeOptions o = new ChromeOptions();
// o.setProxy(p);
// WebDriver driver = new ChromeDriver(o);

Escolhendo sua abordagem

Escolha com base em se o proxy precisa de credenciais.

Sem autenticação? Use a flag

Para um proxy não autenticado, basta adicionar --proxy-server=http://host:3128 às ChromeOptions, ou definir o objeto Proxy do Selenium. Nada mais é necessário.

Auth? Gere uma extensão

Para proxies USER:PASS, envie uma pequena extensão de runtime que responde em onAuthRequired. Funciona sem cabeça e se comporta da mesma forma em diferentes linguagens.

Endpoint HTTP para navegadores

Use proxy.s4m.online:3128 (HTTP). SOCKS5 autenticado dentro de um navegador é pouco confiável, então mantenha SOCKS5 para CLI e clientes de biblioteca.

Mantenha a extensão privada

A extensão gerada incorpora suas credenciais em um arquivo temporário. Escreva-o em um diretório temporário privado e limpe-o após a execução.

Confiabilidade e expectativas honestas

O Selenium controla um navegador real, que é tanto sua força quanto seu custo: é mais pesado do que um cliente HTTP puro, então mantenha as sessões com propósito e feche os drivers rapidamente. Se você só precisa de HTML, um cliente HTTP por trás de um proxy é muito mais barato — veja raspagem com requests. Use o Selenium quando a renderização de JavaScript ou a interação genuína do usuário for necessária.

Como sempre, um proxy muda seu IP, não sua impressão digital. Proxies s4m são de datacenter — ideais para testes funcionais, monitoramento e raspagem moderada, mas detectáveis como datacenter em sites hostis. Quando um login ou lista de permissões espera um endereço estável, adicione um IP pessoal dedicado. Para projetos mais novos, considere Playwright, cuja autenticação de proxy nativa evita completamente a dança da extensão. Verifique as saídas com as ferramentas e leia a documentação da API para automatizar a rotação de credenciais.

FAQ

Perguntas, respondidas

Por que não posso colocar USER:PASS na flag de proxy do Selenium?

O Chrome ignora credenciais na flag --proxy-server e, em vez disso, levanta um prompt de autenticação nativo que um navegador sem cabeça não pode responder. A solução confiável é uma pequena extensão do Chrome em tempo de execução que responde ao onAuthRequired com seu nome de usuário e senha.

Há uma maneira mais simples para proxies não autenticados?

Sim. Sem credenciais, você pode apenas adicionar --proxy-server=http://host:3128 às ChromeOptions, ou preencher o objeto Proxy do Selenium em Java. A extensão é necessária apenas quando o proxy requer USER:PASS.

Devo usar SOCKS5 ou HTTP com Selenium?

Use o ponto de extremidade HTTP na porta 3128 para navegadores. SOCKS5 autenticado em um navegador é pouco confiável; mantenha SOCKS5 para clientes de linha de comando e bibliotecas.

Seria o Playwright mais fácil?

Frequentemente, sim. O Playwright aceita credenciais de proxy nativamente em seu objeto de proxy, então você pula a extensão completamente. O Selenium ainda é a escolha certa quando seu projeto já depende dele.

Continue lendo

Você também pode gostar

Como ocultar seu verdadeiro endereço IP do servidor

Leia →

O que é um proxy SOCKS5?

Leia →

Como configurar o WireGuard VPN, passo a passo

Leia →

Como usar proxies para raspagem da web

Leia →

Dirija navegadores através de um proxy

Proxies de datacenter autenticados em proxy.s4m.online, prontos para Selenium via uma extensão gerada. Pagamento medido conforme o uso, com uma opção de IP dedicado para logins estáveis.

Veja os preços dos proxiesVeja preços

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.