Se hai mai provato a lanciare Chrome tramite Selenium con un proxy del tipo
--proxy-server=http://user:password@ip:port,
sicuramente ti sei imbattuto nel fatto che il browser si apre senza proxy del tutto, oppure mostra una finestra di autenticazione di sistema,
che blocca l'intero script. Questo non è un bug del tuo codice — è una limitazione architettonica di Chromium, che Selenium
non risolve direttamente. In questo articolo analizzeremo perché ciò accade e forniremo 4 modi funzionanti per passare il login e la password
del proxy a Chrome senza inserimento manuale.
Perché --proxy-server non accetta user:pass
Il flag --proxy-server
in Chromium è stato originariamente progettato solo per specificare il protocollo, l'indirizzo IP e la porta del server proxy.
La sintassi con le credenziali del tipo user:password@host:port
funziona in curl, wget e molte altre utility, ma Chromium scarta semplicemente questa parte dell'URL durante il parsing del flag.
Questo comportamento è confermato e descritto nel bug tracker di Chromium fin dalle versioni 50, e nel corso degli anni gli sviluppatori
non hanno mai aggiunto il supporto per l'autenticazione tramite riga di comando — per motivi di sicurezza: la password negli argomenti
del processo è visibile tramite ps aux
o il task manager, il che è considerato una fuga di dati.
Di conseguenza, Chrome si connette onestamente al server proxy, ma non appena questo risponde con il codice
407 Proxy Authentication Required,
il browser mostra una finestra di dialogo nativa con i campi "Nome utente" e "Password". Selenium non è in grado di gestire
le finestre di dialogo di sistema — gestisce solo il DOM della pagina, quindi chiudere o compilare automaticamente
questa finestra tramite l'API standard di WebDriver è impossibile. Lo script si blocca semplicemente in attesa che qualcuno inserisca manualmente
i dati o che scada il timeout.
È importante capire: il problema è attuale proprio per i proxy HTTP/HTTPS e SOCKS5 con autenticazione tramite login e password.
Se il proxy è protetto da IP-whitelist (senza login), la finestra di dialogo di autenticazione non appare affatto, e il flag
--proxy-server funziona normalmente.
Pertanto, per il parsing e l'automazione tramite proxy di data center
molti sviluppatori scelgono inizialmente il piano con vincolo IP, piuttosto che password — questo elimina il problema alla radice.
Ma se hai un pool di proxy residenziali rotanti,
il vincolo IP è spesso scomodo e bisogna risolvere il problema programmaticamente.
Modo 1: estensione Chrome con autenticazione proxy
Il modo più affidabile e duraturo è generare una mini-estensione Chrome (Manifest V2 o V3), che
intercetta l'evento onAuthRequired
e inserisce automaticamente il login e la password, bypassando la finestra di dialogo di sistema. L'estensione viene creata al volo nel codice Python
e collegata a Chrome tramite l'opzione 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()
Questo metodo elimina completamente la finestra di dialogo di autenticazione — Chrome inserisce automaticamente le credenziali ad ogni richiesta 407. Il difetto di questo approccio: funziona solo con il browser visibile (la modalità headless nelle versioni più vecchie di Chrome con estensioni può essere instabile), e per ogni nuovo proxy è necessario ricreare l'archivio zip. Per l'avvio massivo di 20-50 profili con proxy diversi, questo si risolve generando un plugin unico per ogni profilo in un ciclo.
Modo 2: Selenium Wire
Se non vuoi occuparti della generazione di estensioni, puoi utilizzare la libreria
selenium-wire —
essa avvolge il normale Selenium e aggiunge un proprio strato proxy tra il browser e il server di destinazione.
Il login e la password vengono passati direttamente nelle opzioni, senza finestre di dialogo e estensioni.
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()
Vantaggi: minimo codice, supporto SOCKS5, facile cambiare proxy al volo tra le richieste — questo è importante se stai facendo rotazione IP ad ogni N-esima pagina durante il parsing di Wildberries o Ozon. Difetto: Selenium Wire aggiunge un proprio proxy MITM locale, che rallenta leggermente il caricamento delle pagine e a volte confligge con i siti che utilizzano HSTS rigoroso e certificate pinning. Il progetto non è stato aggiornato così attivamente come il Selenium principale, quindi la compatibilità con le nuove versioni di Chrome deve essere verificata prima dell'uso in produzione.
Modo 3: CDP e Network.setBasicAuth (Selenium 4 BiDi)
A partire da Selenium 4, è possibile lavorare direttamente tramite il Chrome DevTools Protocol (CDP), il che consente
di intercettare le richieste di autenticazione senza librerie di terze parti. Chrome supporta l'evento
Fetch.authRequired,
al quale è possibile iscriversi tramite la sessione DevTools e rispondere programmaticamente con le credenziali.
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)
# Abilitiamo l'intercettazione degli eventi di rete tramite CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})
# In Selenium 4.10+ è disponibile un'API semplificata per l'autenticazione
driver.execute_cdp_cmd("Fetch.enable", {
"handleAuthRequests": True,
"patterns": [{"urlPattern": "*"}]
})
# Esempio di gestore (nel codice reale è necessario un listener tramite sessione websockets CDP)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})
driver.get("https://httpbin.org/ip")
driver.quit()
Nella pratica, l'implementazione completa di questo gestore richiede di lavorare con una connessione WebSocket CDP a basso livello
(libreria pycdp o
client BiDi integrato Selenium 4.10+), il che è più vicino a un compito ingegneristico che a uno script veloce. Questo modo
dovrebbe essere scelto se stai costruendo il tuo framework di automazione e vuoi eliminare la dipendenza
da selenium-wire o dalla generazione di estensioni. Per la maggior parte delle attività di automazione SMM e parsing di marketplace
è più semplice utilizzare il modo 1 o 2.
Modo 4: proxy senza password tramite IP-whitelist
La soluzione più semplice è non passare affatto il login e la password a Chrome. Molti fornitori di proxy, inclusi
proxy mobili, supportano
l'autenticazione tramite indirizzo IP del server o della macchina da cui proviene la richiesta. Aggiungi il tuo IP esterno nella whitelist
nel pannello di controllo del fornitore, e dopo di ciò il flag
--proxy-server=http://ip:port
funziona senza alcuna finestra di dialogo di autenticazione — perché il server proxy stesso determina che la richiesta proviene da un IP autorizzato,
e non invia il codice 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 senza login, IP già nella whitelist
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Questo approccio è ideale per gli scenari server — quando lo script gira su una VPS dedicata con un IP esterno fisso, e lo scrivi una volta nella whitelist. Il difetto si presenta quando l'IP della macchina cambia frequentemente (ad esempio, internet domestico con IP dinamico o funzioni cloud con indirizzi effimeri) — in tal caso la whitelist dovrà essere aggiornata manualmente ad ogni avvio, il che è scomodo per l'automazione.
Confronto dei metodi
| Metodo | Difficoltà | Modalità Headless | Quando utilizzare |
|---|---|---|---|
| Estensione Chrome | Media | Limitata | Farming di account, automazione visiva |
| Selenium Wire | Bassa | Sì | Parsing, rapida rotazione dei proxy |
| CDP / Fetch.authRequired | Alta | Sì | Proprio framework di automazione |
| IP-whitelist senza password | Minima | Sì | Server con IP fissa |
Checklist per il debug dei problemi di autenticazione proxy
- Controlla se appare la finestra di dialogo di sistema all'avvio senza modalità headless — questo è un segno certo di un problema con il 407.
- Assicurati che la porta del proxy sia correttamente specificata: HTTP e SOCKS5 spesso funzionano su porte diverse presso lo stesso fornitore.
- Se utilizzi Selenium Wire, controlla la versione — le vecchie release possono confliggere con Chrome 115+.
- Per l'estensione Chrome assicurati che l'archivio zip venga ricostruito ad ogni cambio di login/password del proxy.
- Quando lavori con l'autenticazione SOCKS5, tieni presente: il SOCKS5 nativo in Chrome non supporta affatto login/password — è necessario un tunnel HTTP o Selenium Wire.
- Controlla i log del fornitore di proxy: a volte il 407 non deriva dal codice, ma da un piano scaduto o da un formato di login errato (con suffissi di sessione/geo).
Conclusione
Il flag --proxy-server in Chrome
non ha mai supportato il passaggio diretto di login e password nella stringa — è una caratteristica dell'architettura di Chromium,
e non un errore di Selenium. Ci sono quattro modi per aggirare il problema: un'estensione fai-da-te con intercettazione
onAuthRequired,
la libreria Selenium Wire, il lavoro a basso livello tramite CDP, oppure il completo rifiuto della password a favore dell'IP-whitelist.
Per la maggior parte delle attività di parsing e automazione dei test, è sufficiente Selenium Wire; per il lavoro visivo con
profili anti-detect, è più comoda l'estensione Chrome.
Se stai configurando l'automazione su server con IP fisso, considera proxy di data center con vincolo sulla whitelist — questo elimina completamente il problema di autenticazione in Chrome. E per compiti in cui è necessaria la rotazione di login e password al volo con rotazione geo, sono più adatti proxy residenziali in combinazione con Selenium Wire — in questo modo ottieni sia flessibilità che stabilità della connessione senza finestre di dialogo di autenticazione.