ipvolt / заметкиБиблиотека для разработчиков

Соединение, которое понятно.

Практические знания о прокси: от первого запроса до деталей, которые действительно важны. Понятные примеры. Полезные различия. Меньше допущений.

Подключите свой стек.
Открыть как Markdown ↗

Интеграция

Подключите свой стек.

Явная конфигурация, ограниченные запросы и понятный способ проверить соединение.

Прокси в curl

Как использовать прокси в curl: флаг -x, переменные http_proxy и https_proxy, SOCKS5 через socks5h, аутентификация на прокси и разбор ошибок CONNECT и 407.

Настройка Python Requests

Настройка прокси в Python Requests: словарь proxies, значения по умолчанию в Session, учётные данные, SOCKS5 через requests[socks], переменные окружения и ProxyError.

Прокси для fetch в Node.js

Направьте встроенный fetch в Node.js через ProxyAgent из Undici с явной аутентификацией, крайним сроком через abort и корректной очисткой ответа.

Настройка прокси в Playwright

Задайте HTTP-прокси с аутентификацией для контекста браузера Playwright, изолируйте состояние теста и диагностируйте навигацию отдельно от подресурсов.

Асинхронные прокси в HTTPX

Настройте асинхронный клиент HTTPX с прокси, корректно закрывайте потоковые ответы и воспроизведите PoolTimeout локально, прежде чем менять настройки прокси.

Уведомления о листингах Amazon

Обработка событий листингов Amazon SP-API через протестированный SQLite-инбокс: дедупликация доставок, восстановление после перезапуска и отклонение устаревших чтений.

Часовые пояса Австралии в Playwright

12 проверок часов браузера для Австралии в Playwright, включая 30-минутный переход Лорд-Хау. Отделите фиксированное UTC, пояс браузера и раннер Node.

Локализация Shopify для Канады

Проверьте локализацию Shopify для Канады по снимку конфигурации и парным визитам. Разделите влияние IP, URL, языка, сохранённого выбора и адреса доставки.

Accept-Encoding по умолчанию у клиентов

curl, Wget 1.x, urllib, node:http, PHP curl, Guzzle и java.net.http.HttpClient по умолчанию не шлют Accept-Encoding или шлют identity. Проверенные решения, замер байтов.

Настройка прокси в Axios

Настройте прокси для Axios в Node.js, отделите явные настройки от маршрутизации через окружение и агенты и воспроизведите проверки аутентификации и TLS.

Прокси в aiohttp 3.14

Настройка прокси в aiohttp 3.14: чем заменить устаревшие BasicAuth и proxy_auth, как включить trust_env и что означают ошибки 407 и Bad status line. Проверено на 3.14.4.

Прокси в Scrapy 2.19

Настройка прокси в Scrapy 2.19: учётные данные в meta["proxy"], ротация по запросам, HTTP_PROXY и разбор TunnelError 407, пропущенного ответа 407 и ошибки socks5.

Прокси в curl_cffi

Настройка прокси в curl_cffi 0.16.3: учётные данные и impersonate, почему 407 на CONNECT даёт ConnectionError, а не ProxyError, правила HTTP_PROXY и socks5h.

Блокировка изображений в Playwright

Как блокировать изображения, шрифты и медиа в Playwright через route() на Python и Node.js: для всего контекста или по хостам, с учётом кеша и сервис-воркеров.

Концепции

Разберитесь в компромиссах.

Выбирайте протокол, модель сессий или тип сети, задавая правильные вопросы.

HTTP и SOCKS5 прокси

Сравниваем HTTP CONNECT и SOCKS5, разбираем, где выполняется DNS и где проходят границы TLS, и выбираем протокол, который реально поддерживают ваш клиент и провайдер.

Ротируемые и sticky-прокси

Выбирайте ротацию под наименьший законченный сценарий, отличайте привязку к выходу от cookie и проверяйте, что происходит, когда sticky-сессия завершается раньше срока.

Мобильные и резидентные прокси

Сравниваем выходы в сетях операторов связи и домашних сетях для QA, отделяем эмуляцию браузера и измеряем возможности, которые реально нужны вашему сценарию.

Диагностика

Найдите причину сбоя.

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

Ошибка прокси 407

Разбираем ошибку Proxy Authentication Required по шагам: шлюз, метод аутентификации, кодирование учётных данных, область действия аккаунта и настройки клиента.

Переменные окружения прокси

Разбираем различия в маршрутизации по HTTP_PROXY, HTTPS_PROXY, ALL_PROXY и NO_PROXY в curl, Python Requests и Node.js с помощью изолированной локальной проверки.

Диагностика таймаутов прокси

Разделяем задержки DNS, TCP, CONNECT, TLS и ответа прокси с помощью таймингов curl, затем задаём дедлайны запросов и решаем, безопасен ли повтор.

Исправить ERR_TUNNEL_CONNECTION_FAILED

Разбираем ERR_TUNNEL_CONNECTION_FAILED и ERR_PROXY_CONNECTION_FAILED по проверенной матрице отказов прокси и показываем, как узнать статус CONNECT, скрытый Chromium.

Node.js fetch failed за прокси

Разбираем TypeError: fetch failed в Node.js за прокси: вывод цепочки err.cause, игнорируемый HTTPS_PROXY, несовпадение версий undici и ответы прокси 403, 407 или 502.

Node.js fetch игнорирует HTTPS_PROXY

Встроенный fetch в Node.js молча пропускает HTTP_PROXY и HTTPS_PROXY: запрос падает с UND_ERR_CONNECT_TIMEOUT, а curl работает. Почему и как исправить в любой версии.

SSL WRONG_VERSION_NUMBER через прокси

Ошибка SSL wrong version number через прокси бывает на двух участках: до прокси и до целевого порта. Как отличить их в curl, Requests и HTTPX и что исправить.

Missing dependencies for SOCKS support

Ошибка Missing dependencies for SOCKS support в Python Requests, pip и HTTPX: установите requests[socks] или уберите переменную ALL_PROXY, которая её вызывает.

Scrapy: start_requests() не вызывается

В Scrapy 2.16 удалён Spider.start_requests(): паук пишет Crawled 0 pages и закрывается как finished без предупреждений. Решение: async def start(). Проверено на 2.19.

Страны

Проверьте локацию.

Разберитесь в локальных сетях, проверьте точки выхода и задайте правильные вопросы, прежде чем выбирать провайдера.

Прокси Нидерландов

Как оценивать прокси Нидерландов: контекст голландских сетей, проверка исходящего IP-адреса и города, данные ASN и чек-лист пробного теста перед выбором провайдера.

Прокси США

Как оценивать прокси США по стране, штату и городу. Сравнение данных о сетях, план региональных проверок и измерение поведения сессий перед выбором провайдера.

Прокси Великобритании

Как оценивать прокси Великобритании: актуальный контекст операторов, география UK и GB, ограничения почтовых индексов и план теста для требований по стране или сети.

Прокси Германии

Как оценивать прокси Германии: актуальный контекст операторов и роуминга, пределы точности по городу, контроль языка браузера и практический чек-лист приёмки.

Прокси Франции

Как оценивать прокси Франции: различия операторов и брендов, охват метрополии и заморских территорий, данные об исходящем IP-адресе и матрица тестов локализации.

Прокси Бразилии

Мобильные и резидентные прокси Бразилии: что доказывает метка, контекст Vivo, Claro и TIM, штаты и часовые пояса, CEP и CPF как входные данные и план теста.

Прокси Португалии

Как задать и проверить требования к прокси Португалии: материк и острова, операторы по данным ANACOM, настройки pt-PT, португальские поля заказа и тест из четырёх строк.

Прокси Австралии

Какие доказательства нужны тесту австралийских прокси: страна или город, сетевые метки Telstra, Optus и TPG, уровни провайдеров nbn и требования к сессии.

Прокси Канады

Оценивайте прокси Канады по матрице приёмки для страны, оператора и сессии. Отделяйте бренды Rogers, Bell, TELUS и Quebecor от доказательств, нужных тесту.

Прокси Японии

Оценивайте прокси Японии по отдельным доказательствам геолокации IP, выхода и мобильного доступа. Разберитесь с брендами au/UQ и роумингом Rakuten до приёмки образца.