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.