Se você já tentou executar o Chrome através do Selenium com um proxy do tipo
--proxy-server=http://user:password@ip:port,
certamente se deparou com o fato de que o navegador ou abre sem proxy algum, ou exibe uma janela de autenticação do sistema,
que bloqueia todo o script. Isso não é um bug no seu código — é uma limitação arquitetônica do Chromium, que o Selenium
não resolve diretamente. Neste artigo, vamos discutir por que isso acontece e fornecer 4 maneiras funcionais de passar o login e a senha
do proxy para o Chrome sem a necessidade de entrada manual.
Por que --proxy-server não aceita user:pass
A flag --proxy-server
no Chromium foi originalmente projetada apenas para especificar o protocolo, endereço IP e porta do servidor proxy.
A sintaxe com credenciais do tipo user:password@host:port
funciona no curl, wget e muitas outras ferramentas, mas o Chromium simplesmente descarta essa parte da URL ao analisar a flag.
Esse comportamento foi confirmado e descrito no rastreador de bugs do Chromium desde as versões 50, e ao longo dos anos os desenvolvedores
não adicionaram suporte para autenticação via linha de comando — por questões de segurança: a senha nos argumentos
do processo é visível através do ps aux
ou do gerenciador de tarefas, o que é considerado uma vazamento.
Como resultado, o Chrome se conecta corretamente ao servidor proxy, mas assim que este responde com o código
407 Proxy Authentication Required,
o navegador exibe uma janela de diálogo nativa com os campos "Nome de usuário" e "Senha". O Selenium não consegue lidar
com diálogos do sistema operacional — ele gerencia apenas a árvore DOM da página, portanto, fechar ou preencher automaticamente
essa janela através da API padrão do WebDriver é impossível. O script simplesmente fica travado aguardando que alguém insira os dados manualmente ou que o tempo limite expire.
É importante entender: o problema é relevante apenas para proxies HTTP/HTTPS e SOCKS5 com autenticação por login e senha.
Se o proxy é protegido por IP-whitelist (sem login), o diálogo de autenticação não aparece de forma alguma, e a flag
--proxy-server funciona normalmente.
Portanto, para scraping e automação através de proxies de datacenters
muitos desenvolvedores inicialmente escolhem um plano atrelado ao IP, em vez de senha — isso elimina o problema pela raiz.
Mas se você tem um pool de proxies residenciais rotacionados,
a atrelagem por IP muitas vezes é inconveniente, e é necessário resolver a questão programaticamente.
Método 1: extensão do Chrome com autenticação de proxy
A maneira mais confiável e duradoura é gerar uma mini-extensão do Chrome (Manifest V2 ou V3), que
intercepta o evento onAuthRequired
e automaticamente insere o login e a senha, contornando o diálogo do sistema. A extensão é criada em tempo real no código Python
e conectada ao Chrome através da opção add_extension.
import zipfile
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
def create_proxy_extension(proxy_host, proxy_port, proxy_user, proxy_pass, plugin_path="proxy_auth.zip"):
manifest_json = """
{
"version": "1.0.0",
"manifest_version": 2,
"name": "Chrome Proxy Auth",
"permissions": [
"proxy", "tabs", "unlimitedStorage", "storage",
"<all_urls>", "webRequest", "webRequestBlocking"
],
"background": {"scripts": ["background.js"]},
"minimum_chrome_version":"22.0.0"
}
"""
background_js = f"""
var config = {{
mode: "fixed_servers",
rules: {{
singleProxy: {{
scheme: "http",
host: "{proxy_host}",
port: parseInt({proxy_port})
}},
bypassList: ["localhost"]
}}
}};
chrome.proxy.settings.set({{value: config, scope: "regular"}}, function() {{}});
chrome.webRequest.onAuthRequired.addListener(
function(details) {{
return {{
authCredentials: {{username: "{proxy_user}", password: "{proxy_pass}"}}
}};
}},
{{urls: ["<all_urls>"]}},
["blocking"]
);
"""
with zipfile.ZipFile(plugin_path, "w") as zp:
zp.writestr("manifest.json", manifest_json)
zp.writestr("background.js", background_js)
return plugin_path
plugin = create_proxy_extension("gate.example.com", 7000, "login123", "pass456")
options = Options()
options.add_extension(plugin)
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Este método elimina completamente o diálogo de autenticação — o Chrome insere as credenciais automaticamente a cada solicitação 407. A desvantagem da abordagem: ela funciona apenas com o navegador visível (o modo headless em versões antigas do Chrome com extensões pode ser instável), e para cada novo proxy é necessário recriar o arquivo zip. Para iniciar em massa 20-50 perfis com proxies diferentes, isso é resolvido gerando um plugin único para cada perfil em um loop.
Método 2: Selenium Wire
Se você não quer se preocupar em gerar extensões, pode usar a biblioteca
selenium-wire —
ela envolve o Selenium comum e adiciona uma camada de proxy própria entre o navegador e o servidor de destino.
O login e a senha são passados diretamente nas opções, sem diálogos e extensões.
from seleniumwire import webdriver
proxy_options = {
'proxy': {
'http': 'http://login123:[email protected]:7000',
'https': 'http://login123:[email protected]:7000',
'no_proxy': 'localhost,127.0.0.1'
}
}
driver = webdriver.Chrome(seleniumwire_options=proxy_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Vantagens: mínimo de código, suporte a SOCKS5, fácil troca de proxies em tempo real entre solicitações — isso é importante se você estiver fazendo rotação de IP em cada N-ésima página ao fazer scraping do Wildberries ou Ozon. Desvantagem: o Selenium Wire adiciona seu próprio proxy MITM local, que pode desacelerar um pouco o carregamento das páginas e às vezes conflitar com sites que usam HSTS rigoroso e pinning de certificado. O projeto também não foi atualizado tão ativamente quanto o Selenium principal, portanto, a compatibilidade com novas versões do Chrome deve ser verificada antes do uso em produção.
Método 3: CDP e Network.setBasicAuth (Selenium 4 BiDi)
A partir do Selenium 4, surgiu a possibilidade de trabalhar diretamente através do Chrome DevTools Protocol (CDP), o que permite
interceptar solicitações de autenticação sem bibliotecas externas. O Chrome suporta o evento
Fetch.authRequired,
que pode ser assinado através da sessão do DevTools e respondido programaticamente com as credenciais.
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--proxy-server=gate.example.com:7000")
driver = webdriver.Chrome(options=options)
# Ativando a interceptação de eventos de rede via CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})
# No Selenium 4.10+ está disponível uma API simplificada de autenticação
driver.execute_cdp_cmd("Fetch.enable", {
"handleAuthRequests": True,
"patterns": [{"urlPattern": "*"}]
})
# Exemplo de manipulador (no código real, é necessário um ouvinte através da sessão websockets do CDP)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})
driver.get("https://httpbin.org/ip")
driver.quit()
Na prática, a implementação completa desse manipulador requer trabalho com uma conexão WebSocket de baixo nível do CDP
(biblioteca pycdp ou
cliente BiDi embutido do Selenium 4.10+), o que já se aproxima mais de uma tarefa de engenharia do que de um script rápido. Este método
deve ser escolhido se você estiver construindo sua própria estrutura de automação e quiser se livrar da dependência
do selenium-wire ou da geração de extensões. Para a maioria das tarefas de automação de SMM e scraping de marketplaces,
é mais fácil usar o método 1 ou 2.
Método 4: proxy sem senha através de IP-whitelist
A saída mais simples é não passar login e senha para o Chrome. Muitos provedores de proxy, incluindo
proxies móveis, suportam
autenticação por endereço IP do servidor ou máquina de onde a solicitação é feita. Você adiciona seu IP externo na whitelist
no painel do provedor, e depois disso a flag
--proxy-server=http://ip:port
funciona sem um único diálogo de autenticação — porque o servidor proxy determina por si mesmo que a solicitação veio de um IP permitido,
e não envia o código 407.
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--proxy-server=http://45.12.34.56:7000") # proxy sem login, IP já na whitelist
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
A abordagem é ideal para cenários de servidor — quando o script roda em uma VPS dedicada com um IP externo constante, e você o registra uma vez na whitelist. A desvantagem surge quando o IP da máquina muda frequentemente (por exemplo, internet residencial com IP dinâmico ou funções em nuvem com endereços efêmeros) — então a whitelist terá que ser atualizada manualmente a cada execução, o que é inconveniente para automação.
Comparação dos métodos
| Método | Dificuldade | Modo Headless | Quando usar |
|---|---|---|---|
| Extensão do Chrome | Média | Limitado | Fazenda de contas, automação visual |
| Selenium Wire | Baixa | Sim | Scraping, rotação rápida de proxies |
| CDP / Fetch.authRequired | Alta | Sim | Framework de automação próprio |
| IP-whitelist sem senha | Mínima | Sim | Servidores com IP fixo |
Checklist para depuração de problemas com autenticação de proxy
- Verifique se o diálogo do sistema aparece ao executar sem o modo headless — isso é 100% um sinal de problema com 407.
- Certifique-se de que a porta do proxy está correta: HTTP e SOCKS5 frequentemente operam em portas diferentes com o mesmo provedor.
- Se estiver usando o Selenium Wire, verifique a versão — versões antigas podem conflitar com o Chrome 115+.
- Para a extensão do Chrome, certifique-se de que o arquivo zip é reconstruído a cada mudança de login/senha do proxy.
- Ao trabalhar com autenticação SOCKS5, tenha em mente: o SOCKS5 nativo no Chrome não suporta login/senha de forma alguma — é necessário um túnel HTTP ou Selenium Wire.
- Verifique os logs do provedor de proxy: às vezes, 407 ocorre não por causa do código, mas devido a um plano expirado ou formato de login incorreto (com sufixos de sessão/geolocalização).
Conclusão
A flag --proxy-server no Chrome
nunca suportou a passagem de login e senha diretamente na string — isso é uma característica da arquitetura do Chromium,
e não um erro do Selenium. Existem quatro maneiras funcionais de contornar isso: uma extensão caseira com interceptação
onAuthRequired,
a biblioteca Selenium Wire, trabalho de baixo nível através do CDP, ou a completa renúncia à senha em favor do IP-whitelist.
Para a maioria das tarefas de scraping e automação de testes, o Selenium Wire é suficiente; para trabalho visual com
perfis anti-detect, a extensão do Chrome é mais conveniente.
Se você está configurando a automação em servidores com IP fixo, considere proxies de datacenters com atrelamento por whitelist — isso elimina completamente o problema de autenticação no Chrome. E para tarefas que exigem troca de login e senha em tempo real com rotação de geolocalização, os proxies residenciais em conjunto com o Selenium Wire são mais adequados — assim você obtém flexibilidade e estabilidade de conexão sem janelas de autenticação.