Настройка прокси браузера: руководство по SOCKS5, HTTP и HTTPS

BotBrowser настраивает прокси браузера, принимает учетные данные в URL прокси и выводит часовой пояс, локаль и язык из публичного IP прокси. Он не управляет маршрутизацией или аутентификацией провайдера, внешним DNS или политикой назначения. Считайте эти области отдельными операционными границами, а затем используйте инструкцию проверки исходящего маршрута прокси Launcher, чтобы записать наблюдения двух контролируемых endpoints.

Кратко

• Выбирайте SOCKS5H, если DNS должен разрешаться через прокси; используйте HTTP или HTTPS согласно поддержке провайдера.
• Используйте protocol://username:password@host:port и кодируйте зарезервированные символы в URL.
• Проверьте наблюдаемые публичный IP, часовой пояс и локаль. Переопределяйте настройки браузера только при документированном ожидаемом значении.
• При сбое прокси остановите рабочий процесс; не переходите незаметно на прямое соединение.

Содержание

• Введение
• Влияние на конфиденциальность
• Техническая основа
• Настройка и использование
• Часто задаваемые вопросы
• Практический итог

Введение

Одного профиля отпечатков недостаточно для согласованной идентичности браузера. Ваш IP-адрес, поведение DNS и географические метаданные должны соответствовать идентичности, которую представляет ваш профиль. Если ваш профиль говорит «пользователь Windows в Берлине», а ваш IP указывает на дата-центр в Вирджинии, несоответствие очевидно.

BotBrowser предоставляет расширенную поддержку прокси, встроенную непосредственно в движок браузера. В отличие от стандартного Chromium, BotBrowser принимает встроенные учетные данные в URL-адресах прокси, автоматически выводит географические настройки из IP вашего прокси и поддерживает протоколы SOCKS5, SOCKS5H, HTTP, HTTPS и QUIC, когда браузер/клиент, авторизованный контекст и провайдер прокси поддерживают их. Поддержка QUIC не гарантирует успешную работу HTTP/3, не предоставляет переход на прямое соединение и не управляет восходящим маршрутом провайдера.

Влияние на конфиденциальность

Без корректно настроенного прокси ваш реальный IP-адрес виден каждому посещаемому сайту. IP-адреса раскрывают вашего провайдера, приблизительное физическое местоположение и могут быть коррелированы между сессиями для построения устойчивого профиля отслеживания.

Даже при использовании прокси ошибки конфигурации могут подорвать вашу конфиденциальность. DNS-запросы могут утекать за пределы прокси-туннеля, раскрывая вашу активность просмотра вашему провайдеру. ICE-кандидаты WebRTC могут раскрыть ваш реальный IP через STUN-запросы, идущие мимо прокси. Несоответствия часового пояса и локали между вашей заявленной идентичностью и геолокацией IP создают несогласованности, которые системы отслеживания могут отметить.

--proxy-server задает запрошенный браузером прокси-маршрут; он не проверяет DNS, WebRTC, политику провайдера или авторизацию назначения. Если определение публичного IP прошло успешно, BotBrowser может вывести из него часовой пояс, локаль и язык. Сравните видимые странице значения с записью маршрута провайдера; они не доказывают физическое местоположение.

Техническая основа

Как работает проксирование браузера

Когда браузер использует прокси, HTTP и HTTPS-трафик пересылается через прокси-сервер вместо прямого подключения к назначению. Назначение видит IP-адрес прокси, а не ваш.

Разные протоколы прокси обрабатывают это по-разному:

SOCKS5 пересылает соединения через прокси. Локальное или прокси-разрешение DNS зависит от клиента и схемы; проверяйте путь резолвера утвержденным тестом провайдера, а не по успешной загрузке страницы.

HTTP-прокси используют метод CONNECT для установления туннеля для HTTPS-трафика. Прокси видит имя хоста назначения, но не зашифрованное содержимое. HTTP-прокси не обрабатывают UDP-трафик.

HTTPS-прокси шифруют соединение между вашим браузером и самим прокси-сервером. Это предотвращает видимость команд прокси для вашего провайдера, добавляя уровень конфиденциальности к прокси-соединению.

Обработка учетных данных в стандартном Chromium vs. BotBrowser

Флаг --proxy-server стандартного Chromium принимает только адрес прокси без учетных данных. Аутентификация требует отдельной обработки через системные запросы или API фреймворков вроде page.authenticate(). Это неудобно и может мешать автоматическому географическому определению BotBrowser.

BotBrowser расширяет --proxy-server для принятия учетных данных, встроенных непосредственно в URL:

protocol://username:password@host:port

Это может избежать отдельного запроса аутентификации, сохраняя адрес прокси и учетные данные в одном значении URL.

Поддерживаемые типы прокси и конфигурация

BotBrowser поддерживает пять протоколов прокси через флаг --proxy-server:

Протокол	Формат URL	Вариант использования
SOCKS5	socks5://user:pass@host:port	Общего назначения, TCP-трафик
SOCKS5H	socks5h://user:pass@host:port	DNS-разрешение внутри туннеля
HTTP	http://user:pass@host:port	Широко доступен, HTTP/HTTPS-трафик
HTTPS	https://user:pass@host:port	Зашифрованное прокси-соединение
QUIC	quic://user:pass@host:port	Только если клиент и провайдер поддерживают QUIC

Маршрут quic:// доступен только тогда, когда браузер/клиент и прокси-провайдер поддерживают необходимые операции QUIC. BotBrowser не предоставляет сервис QUIC автоматически, не может заставить источник использовать HTTP/3 и не контролирует восходящий маршрут провайдера.

SOCKS5 vs. SOCKS5H

Разница между socks5:// и socks5h:// важна. С socks5:// DNS-разрешение происходит локально на вашей машине до отправки соединения через прокси. С socks5h:// имя хоста отправляется на прокси-сервер, который разрешает DNS от вашего имени. Для конфиденциальности socks5h:// - лучший выбор, потому что предотвращает утечку DNS-запросов к вашему локальному резолверу.

Структурированные имена пользователей прокси

Некоторые провайдеры прокси кодируют инструкции маршрутизации внутри имени пользователя, используя разделители вроде запятых или вертикальных черт. BotBrowser поддерживает такие структурированные имена пользователей:

--proxy-server=socks5://user_abc,type_mobile,country_GB,session_1234:[email protected]:1080

Это распространено у резидентных провайдеров прокси, которые маршрутизируют трафик на основе параметров, встроенных в учетные данные.

Подход BotBrowser к интеграции прокси

Автоматическое географическое выравнивание

Когда BotBrowser подключается через прокси, он определяет публичный IP прокси и автоматически настраивает:

• Часовой пояс: выведенный из геолокации IP
• Локаль: сопоставленная со страной прокси
• Языки: установленные на основе региона прокси
• Геолокация: координаты, приблизительно определенные по IP

Это означает, что базовый запуск с одним --proxy-server уже производит географически согласованную идентичность:

chrome --bot-profile="path/to/profile.enc" \
       --proxy-server=socks5://user:pass@de-proxy:1080

BotBrowser определит немецкий IP и автоматически настроит часовой пояс на Europe/Berlin, локаль на de-DE и языки на de-DE,de,en.

Ручные географические переопределения

Когда нужны конкретные географические настройки, отличающиеся от того, что предполагает IP, используйте флаги переопределения:

chrome --bot-profile="path/to/profile.enc" \
       --proxy-server=socks5://user:pass@proxy:1080 \
       --bot-timezone=America/New_York \
       --bot-locale=en-US \
       --bot-languages=en-US,en \
       --bot-location=40.7128,-74.0060

Флаги CLI имеют наивысший приоритет конфигурации и переопределяют как настройки профиля, так и автоматически определенные значения.

Пропуск поиска IP с --proxy-ip

Если вы уже знаете публичный IP прокси, можно пропустить автоматическое определение IP при первой навигации с помощью флага --proxy-ip (ENT Tier1):

chrome --bot-profile="path/to/profile.enc" \
       --proxy-server=socks5://user:pass@proxy:1080 \
       --proxy-ip="203.0.113.1"

--proxy-ip принимает IPv4, IPv6 или разделенную запятой пару из одного IPv4 и одного IPv6 адреса. Используйте пару, если у прокси отдельные IPv4 и IPv6 выходные идентичности:

--proxy-ip="203.0.113.1,2001:db8::1009"

Это устраняет запрос определения IP при первой навигации и повышает скорость запуска.

Границы маршрута и отказ с закрытием

Оставляйте предусмотренный трафик браузера на настроенном пути прокси, если только утвержденная сетевая политика не определяет другой маршрут. Конфигурация должна сохранять эту границу контроля. Если прокси недоступен, зафиксируйте сбой и остановите рабочий процесс вместо перехода на прямое соединение.

Настройка и использование

Базовая настройка Playwright

const { chromium } = require('playwright-core');

(async () => {
  const browser = await chromium.launch({
    executablePath: 'path/to/botbrowser/chrome',
    args: ['--bot-profile=path/to/profile.enc', '--proxy-server=socks5://user:pass@proxy-host:1080'],
    headless: true,
  });

  const context = await browser.newContext();
  const page = await context.newPage();
  await page.goto('https://example.com');
  await browser.close();
})();

Настройка Puppeteer с географическими переопределениями

const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: 'path/to/botbrowser/chrome',
    args: [
      '--bot-profile=path/to/profile.enc',
      '--proxy-server=socks5://user:pass@de-proxy:1080',
      '--bot-timezone=Europe/Berlin',
      '--bot-locale=de-DE',
      '--bot-languages=de-DE,de,en',
    ],
    headless: true,
    defaultViewport: null,
  });

  const page = await browser.newPage();
  await page.goto('https://example.com');
  await browser.close();
})();

Распространенные конфигурации по регионам

Регион	Часовой пояс	Локаль	Языки
Восток США	America/New_York	en-US	en-US,en
Запад США	America/Los_Angeles	en-US	en-US,en
Великобритания	Europe/London	en-GB	en-GB,en
Германия	Europe/Berlin	de-DE	de-DE,de,en
Япония	Asia/Tokyo	ja-JP	ja,en
Бразилия	America/Sao_Paulo	pt-BR	pt-BR,pt,en
Южная Корея	Asia/Seoul	ko-KR	ko-KR,ko,en

Пользовательский сервис определения IP

Если вы используете собственную точку определения IP, настройте ее с --bot-ip-service:

chrome --bot-profile="path/to/profile.enc" \
       --proxy-server=socks5://user:pass@proxy:1080 \
       --bot-ip-service="https://ip.example.com"

Вы можете указать несколько конечных точек через запятую. BotBrowser запрашивает их параллельно и использует самый быстрый ответ:

--bot-ip-service="https://ip1.example.com,https://ip2.example.com"

Верификация

После запуска BotBrowser с прокси проверьте конфигурацию:

const page = await context.newPage();

// Проверка публичного IP
await page.goto('https://httpbin.org/ip');
const ipData = await page.textContent('body');
console.log('Public IP:', ipData);

// Проверка часового пояса
const tz = await page.evaluate(() => Intl.DateTimeFormat().resolvedOptions().timeZone);
console.log('Timezone:', tz);

// Проверка языка
const lang = await page.evaluate(() => navigator.language);
console.log('Language:', lang);

// Проверка локали
const locale = await page.evaluate(() => Intl.NumberFormat().resolvedOptions().locale);
console.log('Locale:', locale);

Подтвердите, что:

1. IP соответствует ожидаемому адресу вашего прокси
2. Часовой пояс соответствует географическому региону прокси
3. Язык и локаль согласованы с часовым поясом
4. Утечки DNS не видны; проверьте это утвержденным тестом DNS провайдера.

Выберите следующую диагностику по неудачному наблюдению. Результат, видимый браузеру, сужает вопрос, но каждый сетевой уровень требует отдельной проверки.

Наблюдение	Что оно подтверждает	Следующая проверка
IP выхода отличается от записи маршрута	Наблюдаемый endpoint не совпадает с ожидаемым маршрутом	Сравните настроенный прокси, семейство адресов и метку сессии провайдера
IP совпадает, но часовой пояс или локаль отличаются	Видимые браузеру значения не совпадают с ожидаемым профилем	Проверьте переопределения --bot-timezone и --bot-locale
Страница загружается, но владелец DNS неизвестен	Запрос вернул содержимое; путь резолвера не проверен	Запустите утвержденный провайдером DNS-тест и запишите резолвер
CONNECT успешен, но TLS завершился ошибкой	Прокси-туннель ответил; TLS назначения все еще не прошел	Отдельно проверьте сертификат и политику TLS назначения

Чтение сетевой границы

Прокси меняет путь запроса браузера, но не доказывает политику провайдера или назначения. При socks5:// локальный резолвер может разрешить имя до входа соединения в прокси; при socks5h:// имя отправляется прокси для разрешения. --bot-local-dns выбирает локальную обработку DNS в BotBrowser, но не превращает socks5:// в socks5h:// и не управляет вышестоящим резолвером провайдера. О смежной теме сетевых границ рассказывает материал Защита от сканирования портов браузером на localhost.

WebRTC может собирать ICE-кандидаты через дополнительные сетевые службы. Проверка на уровне страницы показывает только то, что видит эта страница, и не подтверждает поведение каждого хоста, VPN или оборудования провайдера. CORS относится к другому уровню: браузер может скрыть ответ скрипту, даже если прокси достиг сервера. Для HTTPS разделяйте туннель браузер-прокси и соединение прокси-назначение: успешный CONNECT подтверждает доступ и аутентификацию этого запроса, но не сертификат назначения и его политику TLS.

Встроенные в URL учетные данные - лишь удобство настройки. Маскируйте пароли в журналах и меняйте их по процедуре провайдера. Проверка описывает только наблюдение: IP выхода не доказывает права учетной записи, часовой пояс не доказывает физическое присутствие, а успешная загрузка не подтверждает одинаковый маршрут для всех запросов. Сохраняйте браузер, протокол, IP, резолвер, часовой пояс, локаль, время и видимый результат с учетом провайдера и метода теста.

Лучшие практики

1. Используйте SOCKS5H для конфиденциальности DNS. Протокол socks5h:// разрешает DNS через прокси, предотвращая попадание DNS-запросов к вашему локальному провайдеру.

2. Позвольте BotBrowser автоматически определять географию. Если вам не нужны конкретные переопределения, автоматическое определение на основе IP дает согласованные результаты с меньшей конфигурацией.

3. URL-кодируйте специальные символы в паролях. Символы вроде @, # и % должны быть закодированы. Например, p@ss становится p%40ss.

4. Явно указывайте владельца DNS. Используйте socks5h://, если имя должен разрешать прокси; применяйте --bot-local-dns только при требовании локального разрешения. Ни один флаг не управляет вышестоящим резолвером провайдера.

5. Сначала протестируйте с curl. Перед настройкой BotBrowser проверьте связь с прокси: curl --proxy socks5://user:pass@host:port https://httpbin.org/ip.

6. Используйте --proxy-ip, когда IP известен. Это исключает поиск при первой навигации и ускоряет запуск.

Часто задаваемые вопросы

Какой протокол прокси использовать?

SOCKS5H рекомендуется для большинства случаев. Он поддерживает TCP-трафик, обрабатывает DNS-разрешение через прокси и работает с самым широким спектром провайдеров.

Можно ли использовать прокси, требующий белого списка IP?

Да. Убедитесь, что IP вашей машины добавлен в белый список у провайдера прокси, затем используйте URL прокси без учетных данных, если провайдер аутентифицирует по IP.

Поддерживает ли BotBrowser цепочки прокси?

BotBrowser подключается к прокси, указанному в --proxy-server. Если нужны цепочки прокси, настройте их на стороне инфраструктуры прокси.

Почему мой часовой пояс не соответствует местоположению прокси? Если вы установили --bot-timezone вручную, это переопределяет автоматическое определение. Уберите ручное переопределение, чтобы позволить BotBrowser вывести часовой пояс из IP прокси.

Можно ли использовать разные прокси для разных вкладок? Да. Используйте browser.newContext({ proxy: ... }) в Playwright для назначения разных прокси каждому контексту. См. руководство по динамической смене прокси для деталей.

Что происходит, если прокси-соединение не удается? BotBrowser не будет переключаться на прямое соединение. Если прокси недоступен, загрузка страниц будет неудачной, что является более безопасным поведением для конфиденциальности.

Как обрабатывать ротацию прокси? Создайте новый контекст браузера для каждой ротации прокси. Закрытие старого контекста и открытие нового с другим прокси-сервером - самый чистый подход; зафиксируйте смену маршрута.

Что предоставляет BotBrowser

BotBrowser встраивает учетные данные прокси-сервера непосредственно в флаг --proxy-server и автоматически настраивает часовой пояс, локаль и языковые параметры из публичного IP-адреса вашего прокси-сервера, избегая необходимости в отдельных API аутентификации и ручной географической конфигурации. Однако BotBrowser не может управлять тем, как провайдер прокси-сервера маршрутизирует трафик, проверить точность базы данных IP-в-местоположение провайдера, аутентифицировать учетные данные в инфраструктуре провайдера, или управлять поведением DNS и WebRTC вне туннеля браузер-прокси-сервер. Автоматическое определение географии полностью зависит от точности базы данных IP провайдера; если определение не удается или не совпадает с вашей предполагаемой идентичностью, требуются ручные географические переопределения с использованием флагов --bot-timezone, --bot-locale и --bot-languages.

Публичные источники

• W3C: WebRTC
• MDN: прокси-серверы и туннелирование
• MDN: заголовок Proxy-Authorization

Практический итог

Настройка прокси - одна из частей согласованной идентичности браузера. BotBrowser упрощает учетные данные, предоставляет сигналы географического соответствия и поддерживает SOCKS5, SOCKS5H, HTTP, HTTPS и QUIC, когда браузер/клиент, авторизованный контекст и провайдер прокси поддерживают их. Поддержка QUIC не гарантирует успешную работу HTTP/3, не предоставляет переход на прямое соединение и не управляет восходящим маршрутом провайдера. Вместе с документированным профилем и проверками провайдера она помогает сопоставлять IP, часовой пояс, локаль и язык; результат зависит от провайдера и проведенных тестов.

Для рабочих процессов с несколькими прокси см. Dynamic Proxy Switching. Политики DNS и WebRTC применяйте отдельно по документированным процедурам.