Если вы хоть раз пытались запустить Chrome через Selenium с прокси вида
--proxy-server=http://user:password@ip:port,
то наверняка столкнулись с тем, что браузер либо открывается без прокси вовсе, либо выдаёт системное окно авторизации,
которое блокирует весь скрипт. Это не баг вашего кода — это архитектурное ограничение Chromium, которое Selenium
напрямую не решает. В этой статье разберём, почему так происходит, и дадим 4 рабочих способа передать логин и пароль
прокси в Chrome без ручного ввода.
Почему --proxy-server не принимает user:pass
Флаг --proxy-server
в Chromium изначально был рассчитан только на указание протокола, IP-адреса и порта прокси-сервера.
Синтаксис с учётными данными вида user:password@host:port
работает в curl, wget и многих других утилитах, но Chromium эту часть URL просто отбрасывает при парсинге флага.
Это подтверждённое поведение, описанное в баг-трекере Chromium ещё с версий 50-х релизов, и за годы разработчики
так и не добавили поддержку авторизации через командную строку — по соображениям безопасности: пароль в аргументах
процесса виден через ps aux
или диспетчер задач, что считается утечкой.
В итоге Chrome честно подключается к прокси-серверу, но как только тот отвечает кодом
407 Proxy Authentication Required,
браузер показывает нативное диалоговое окно с полями «Имя пользователя» и «Пароль». Selenium не умеет работать
с системными диалогами ОС — он управляет только DOM-деревом страницы, поэтому автоматически закрыть или заполнить
это окно через стандартный WebDriver API невозможно. Скрипт просто зависает в ожидании, пока кто-то вручную
не введёт данные или не истечёт таймаут.
Важно понимать: проблема актуальна именно для прокси HTTP/HTTPS и SOCKS5 с авторизацией по логину и паролю.
Если прокси защищён IP-whitelist (без логина), диалог авторизации не появляется вообще, и флаг
--proxy-server работает штатно.
Поэтому для парсинга и автоматизации через прокси дата-центров
многие разработчики изначально выбирают тариф с привязкой по IP, а не по паролю — это снимает проблему на корню.
Но если у вас пул ротируемых резидентных прокси,
привязка по IP часто неудобна, и приходится решать задачу программно.
Способ 1: расширение Chrome с авторизацией прокси
Самый надёжный и долгоиграющий способ — сгенерировать мини-расширение Chrome (Manifest V2 или V3), которое
перехватывает событие onAuthRequired
и автоматически подставляет логин и пароль, минуя системный диалог. Расширение создаётся на лету в коде Python
и подключается к Chrome через опцию 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()
Этот метод полностью снимает диалог авторизации — Chrome подставляет креды автоматически при каждом запросе 407. Минус подхода: он работает только с видимым браузером (headless-режим у старых версий Chrome с расширениями бывает нестабилен), и для каждого нового прокси нужно пересоздавать zip-архив. Для массового запуска 20-50 профилей с разными прокси это решается генерацией уникального плагина под каждый профиль в цикле.
Способ 2: Selenium Wire
Если не хочется возиться с генерацией расширений, можно использовать библиотеку
selenium-wire —
она оборачивает обычный Selenium и добавляет собственный прокси-слой между браузером и целевым сервером.
Логин и пароль передаются напрямую в опциях, без диалогов и расширений.
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()
Плюсы: минимум кода, поддержка SOCKS5, удобно менять прокси на лету между запросами — это важно, если вы делаете ротацию IP на каждой N-й странице при парсинге Wildberries или Ozon. Минус: Selenium Wire добавляет собственный локальный MITM-прокси, который немного замедляет загрузку страниц и иногда конфликтует с сайтами, использующими строгий HSTS и certificate pinning. Проект также не обновлялся так активно, как основной Selenium, поэтому совместимость с новыми версиями Chrome стоит проверять перед продакшен-использованием.
Способ 3: CDP и Network.setBasicAuth (Selenium 4 BiDi)
Начиная с Selenium 4, появилась возможность работать напрямую через Chrome DevTools Protocol (CDP), что позволяет
перехватывать запросы авторизации без сторонних библиотек. Chrome поддерживает событие
Fetch.authRequired,
на которое можно подписаться через DevTools-сессию и программно ответить учётными данными.
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)
# Включаем перехват сетевых событий через CDP
driver.execute_cdp_cmd("Network.enable", {})
driver.execute_cdp_cmd("Network.setExtraHTTPHeaders", {"headers": {}})
# В Selenium 4.10+ доступен упрощённый API аутентификации
driver.execute_cdp_cmd("Fetch.enable", {
"handleAuthRequests": True,
"patterns": [{"urlPattern": "*"}]
})
# Пример обработчика (в реальном коде нужен слушатель через CDP-сессию websockets)
# driver.on_auth_required(lambda: {"username": "login123", "password": "pass456"})
driver.get("https://httpbin.org/ip")
driver.quit()
На практике полноценная реализация этого обработчика требует работы с низкоуровневым WebSocket-соединением CDP
(библиотека pycdp или
встроенный BiDi-клиент Selenium 4.10+), что уже ближе к инженерной задаче, чем к быстрому скрипту. Этот способ
стоит выбирать, если вы строите собственный фреймворк автоматизации и хотите избавиться от зависимости
selenium-wire или генерации расширений. Для большинства задач SMM-автоматизации и парсинга маркетплейсов
проще использовать способ 1 или 2.
Способ 4: прокси без пароля через IP-whitelist
Самый простой выход — вообще не передавать логин и пароль в Chrome. Многие провайдеры прокси, включая
мобильные прокси, поддерживают
авторизацию по IP-адресу сервера или машины, с которой идёт запрос. Вы добавляете свой внешний IP в whitelist
в личном кабинете провайдера, и после этого флаг
--proxy-server=http://ip:port
работает без единого диалога авторизации — потому что сервер прокси сам определяет, что запрос пришёл с разрешённого IP,
и не присылает код 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") # прокси без логина, IP уже в whitelist
driver = webdriver.Chrome(options=options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
Подход идеально подходит для серверных сценариев — когда скрипт работает на выделенной VPS с постоянным внешним IP, и вы один раз прописываете его в whitelist. Минус появляется там, где IP машины меняется часто (например, домашний интернет с динамическим IP или облачные функции с эфемерными адресами) — тогда whitelist придётся обновлять вручную при каждом запуске, что неудобно для автоматизации.
Сравнение способов
| Способ | Сложность | Headless-режим | Когда использовать |
|---|---|---|---|
| Расширение Chrome | Средняя | Ограниченно | Фарм аккаунтов, визуальная автоматизация |
| Selenium Wire | Низкая | Да | Парсинг, быстрая ротация прокси |
| CDP / Fetch.authRequired | Высокая | Да | Собственный фреймворк автоматизации |
| IP-whitelist без пароля | Минимальная | Да | Серверы с постоянным IP |
Чек-лист для отладки проблем с авторизацией прокси
- Проверьте, появляется ли системный диалог при запуске без headless-режима — это 100% признак проблемы с 407.
- Убедитесь, что порт прокси указан верно: HTTP и SOCKS5 часто работают на разных портах у одного провайдера.
- Если используете Selenium Wire, проверьте версию — старые релизы могут конфликтовать с Chrome 115+.
- Для расширения Chrome убедитесь, что zip-архив пересобирается при каждой смене логина/пароля прокси.
- При работе с SOCKS5-авторизацией имейте в виду: нативный SOCKS5 в Chrome не поддерживает логин/пароль вообще — нужен HTTP-туннель или Selenium Wire.
- Проверьте логи прокси-провайдера: иногда 407 возникает не из-за кода, а из-за истёкшего тарифа или неверного формата логина (с суффиксами сессии/гео).
Заключение
Флаг --proxy-server в Chrome
никогда не поддерживал передачу логина и пароля напрямую в строке — это особенность архитектуры Chromium,
а не ошибка Selenium. Рабочих обходов четыре: самодельное расширение с перехватом
onAuthRequired,
библиотека Selenium Wire, низкоуровневая работа через CDP, либо полный отказ от пароля в пользу IP-whitelist.
Для большинства задач парсинга и автоматизации тестов достаточно Selenium Wire; для визуальной работы с
антидетект-профилями удобнее расширение Chrome.
Если вы настраиваете автоматизацию на серверах с постоянным IP, рассмотрите прокси дата-центров с привязкой по whitelist — это полностью снимает проблему авторизации в Chrome. А для задач, где нужна смена логина и пароля на лету с ротацией гео, лучше подходят резидентные прокси в связке с Selenium Wire — так вы получаете и гибкость, и стабильность подключения без диалоговых окон авторизации.