← Volver al blog

Selenium y Chrome: por qué --proxy-server ignora el login:contraseña y cómo solucionarlo

Analizamos la razón por la cual Chrome no acepta la autorización del proxy a través de la bandera --proxy-server y ofrecemos 4 métodos efectivos para sortear la limitación en Selenium.

📅14 de noviembre de 2026

Si alguna vez has intentado iniciar Chrome a través de Selenium con un proxy del tipo --proxy-server=http://user:password@ip:port, seguramente te has encontrado con que el navegador se abre sin proxy en absoluto, o muestra una ventana de autorización del sistema, que bloquea todo el script. Esto no es un error en tu código, es una limitación arquitectónica de Chromium que Selenium no resuelve directamente. En este artículo analizaremos por qué sucede esto y daremos 4 formas efectivas de pasar el login y la contraseña del proxy a Chrome sin entrada manual.

Por qué --proxy-server no acepta user:pass

La bandera --proxy-server en Chromium fue diseñada originalmente solo para especificar el protocolo, la dirección IP y el puerto del servidor proxy. La sintaxis con credenciales del tipo user:password@host:port funciona en curl, wget y muchas otras utilidades, pero Chromium simplemente descarta esta parte de la URL al analizar la bandera. Este comportamiento está documentado en el rastreador de errores de Chromium desde las versiones 50, y a lo largo de los años los desarrolladores no han agregado soporte para la autorización a través de la línea de comandos, por razones de seguridad: la contraseña en los argumentos del proceso es visible a través de ps aux o el administrador de tareas, lo que se considera una fuga.

Como resultado, Chrome se conecta correctamente al servidor proxy, pero tan pronto como este responde con el código 407 Proxy Authentication Required, el navegador muestra una ventana de diálogo nativa con los campos "Nombre de usuario" y "Contraseña". Selenium no puede trabajar con diálogos del sistema operativo, ya que solo gestiona el árbol DOM de la página, por lo que cerrar o completar automáticamente esta ventana a través de la API estándar de WebDriver es imposible. El script simplemente se queda esperando hasta que alguien introduzca los datos manualmente o se agote el tiempo de espera.

Es importante entender: el problema es relevante específicamente para proxies HTTP/HTTPS y SOCKS5 con autorización por nombre de usuario y contraseña. Si el proxy está protegido por IP-whitelist (sin login), el diálogo de autorización no aparece en absoluto, y la bandera --proxy-server funciona como se espera. Por lo tanto, para el scraping y la automatización a través de proxies de centros de datos muchos desarrolladores inicialmente eligen un plan vinculado por IP en lugar de por contraseña, lo que elimina el problema de raíz. Pero si tienes un grupo de proxies residenciales rotativos, la vinculación por IP a menudo es inconveniente, y hay que resolver el problema programáticamente.

Método 1: extensión de Chrome con autorización de proxy

La forma más confiable y duradera es generar una mini-extensión de Chrome (Manifest V2 o V3), que intercepta el evento onAuthRequired y automáticamente inserta el login y la contraseña, evitando el diálogo del sistema. La extensión se crea sobre la marcha en el código Python y se conecta a Chrome a través de la opción 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 el diálogo de autorización: Chrome inserta las credenciales automáticamente en cada solicitud 407. Desventaja del enfoque: solo funciona con el navegador visible (el modo headless en versiones antiguas de Chrome con extensiones puede ser inestable), y para cada nuevo proxy es necesario recrear el archivo zip. Para ejecutar masivamente 20-50 perfiles con diferentes proxies, esto se resuelve generando un plugin único para cada perfil en un ciclo.

Método 2: Selenium Wire

Si no quieres lidiar con la generación de extensiones, puedes usar la biblioteca selenium-wire — envuelve el Selenium normal y añade su propia capa de proxy entre el navegador y el servidor de destino. El login y la contraseña se pasan directamente en las opciones, sin diálogos ni extensiones.

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()

Ventajas: mínimo código, soporte para SOCKS5, fácil de cambiar proxies sobre la marcha entre solicitudes — esto es importante si haces rotación de IP en cada N-ésima página al hacer scraping de Wildberries o Ozon. Desventaja: Selenium Wire añade su propio proxy MITM local, que ralentiza un poco la carga de las páginas y a veces entra en conflicto con sitios que utilizan HSTS estricto y pinning de certificados. El proyecto también no se ha actualizado tan activamente como el Selenium principal, por lo que la compatibilidad con nuevas versiones de Chrome debe ser verificada antes de su uso en producción.

Método 3: CDP y Network.setBasicAuth (Selenium 4 BiDi)

A partir de Selenium 4, existe la posibilidad de trabajar directamente a través del Protocolo de Herramientas de Desarrollo de Chrome (CDP), lo que permite interceptar solicitudes de autorización sin bibliotecas externas. Chrome soporta el evento Fetch.authRequired, al que se puede suscribir a través de una sesión de DevTools y responder programáticamente con las credenciales.

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)

# Habilitamos la interceptación de eventos de red a través de CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})

# En Selenium 4.10+ se dispone de una API simplificada para autenticación
driver.execute_cdp_cmd("Fetch.enable", {
    "handleAuthRequests": True,
    "patterns": [{"urlPattern": "*"}]
})

# Ejemplo de controlador (en código real se necesita un listener a través de la sesión de websockets de CDP)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})

driver.get("https://httpbin.org/ip")
driver.quit()

En la práctica, la implementación completa de este controlador requiere trabajar con una conexión WebSocket de bajo nivel de CDP (la biblioteca pycdp o el cliente BiDi integrado de Selenium 4.10+), lo que se asemeja más a una tarea de ingeniería que a un script rápido. Este método debe ser elegido si estás construyendo tu propio marco de automatización y deseas deshacerte de la dependencia de selenium-wire o de la generación de extensiones. Para la mayoría de las tareas de automatización SMM y scraping de marketplaces, es más fácil usar el método 1 o 2.

Método 4: proxy sin contraseña a través de IP-whitelist

La forma más sencilla es no pasar el login y la contraseña a Chrome en absoluto. Muchos proveedores de proxy, incluidos proxies móviles, soportan la autorización por la dirección IP del servidor o máquina desde la que se realiza la solicitud. Agregas tu IP externa a la whitelist en el panel de control del proveedor, y después de eso la bandera --proxy-server=http://ip:port funciona sin ningún diálogo de autorización — porque el servidor proxy determina que la solicitud proviene de una IP permitida, y no envía el 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 sin login, IP ya en whitelist

driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Este enfoque es ideal para escenarios en servidores — cuando el script se ejecuta en un VPS dedicado con una IP externa constante, y solo necesitas configurarla una vez en la whitelist. La desventaja aparece cuando la IP de la máquina cambia con frecuencia (por ejemplo, internet doméstico con IP dinámica o funciones en la nube con direcciones efímeras) — entonces la whitelist tendrá que actualizarse manualmente en cada ejecución, lo que es incómodo para la automatización.

Comparación de métodos

Método Dificultad Modo Headless Cuándo usar
Extensión de Chrome Media Limitado Farming de cuentas, automatización visual
Selenium Wire Baja Sí Scraping, rápida rotación de proxies
CDP / Fetch.authRequired Alta Sí Marco de automatización propio
IP-whitelist sin contraseña Mínima Sí Servidores con IP constante

Lista de verificación para depuración de problemas de autorización de proxy

  • Verifica si aparece el diálogo del sistema al iniciar sin modo headless — esto es un 100% indicativo de un problema con 407.
  • Asegúrate de que el puerto del proxy está especificado correctamente: HTTP y SOCKS5 a menudo funcionan en diferentes puertos con el mismo proveedor.
  • Si usas Selenium Wire, verifica la versión — las versiones antiguas pueden entrar en conflicto con Chrome 115+.
  • Para la extensión de Chrome, asegúrate de que el archivo zip se reconstruya al cambiar el login/contraseña del proxy.
  • Al trabajar con autorización SOCKS5, ten en cuenta: el SOCKS5 nativo en Chrome no soporta login/contraseña en absoluto — se necesita un túnel HTTP o Selenium Wire.
  • Revisa los registros del proveedor de proxy: a veces el 407 no surge por el código, sino por un plan agotado o un formato de login incorrecto (con sufijos de sesión/geolocalización).

Conclusión

La bandera --proxy-server en Chrome nunca ha soportado la transmisión de login y contraseña directamente en la cadena — esta es una característica de la arquitectura de Chromium, no un error de Selenium. Hay cuatro formas efectivas de eludir esto: una extensión personalizada con interceptación onAuthRequired, la biblioteca Selenium Wire, el trabajo a bajo nivel a través de CDP, o la completa renuncia a la contraseña a favor de IP-whitelist. Para la mayoría de las tareas de scraping y automatización de pruebas, Selenium Wire es suficiente; para el trabajo visual con perfiles anti-detección, la extensión de Chrome es más conveniente.

Si estás configurando la automatización en servidores con IP constante, considera proxies de centros de datos con vinculación por whitelist — esto elimina completamente el problema de autorización en Chrome. Y para tareas donde se necesita cambiar el login y la contraseña sobre la marcha con rotación geográfica, los proxies residenciales en combinación con Selenium Wire son la mejor opción — así obtienes tanto flexibilidad como estabilidad de conexión sin ventanas de autorización.