← Voltar ao blog

Selenium e Chrome: por que --proxy-server ignora login:senha e como corrigir isso

Analisamos a razão pela qual o Chrome não aceita a autenticação de proxy através da flag --proxy-server e apresentamos 4 maneiras eficazes de contornar a limitação no Selenium.

📅14 de novembro de 2026

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.