Appearance
Сервис управления прокси (Proxy Manager)
Микросервис proxy-manager предназначен для централизованного управления SOCKS5, SOCKS4 и HTTP/HTTPS прокси-серверами в составе платформы Unishift.
Основные возможности
- Многопротокольный Dialer:
- Поддержка SOCKS5 (с/без логина и пароля).
- Поддержка SOCKS4 / SOCKS4a.
- Поддержка HTTP/HTTPS с CONNECT-туннелированием и Basic Auth.
- Фоновый мониторинг работоспособности (Health Checker):
- Автоматическая проверка задержки (RTT), статуса ответа и внешнего выходного IP (
exit_ip). - Автоматический Circuit Breaker: перевод прокси в статус
degradedпри задержке > 2000 мс и вdeadпри 3 подряд неудачных проверках.
- Автоматическая проверка задержки (RTT), статуса ответа и внешнего выходного IP (
- Движок ротации (Rotation Engine):
round_robin— циклический перебор активных прокси.least_latency— выборка прокси с наименьшей задержкой ответа.random— случайный выбор.weighted— выбор на основе веса и обратно пропорционально задержке.sticky— привязка сессии поsession_key.
- Прозрачный Forward Proxy (:8115):
- Позволяет сервисам платформы использовать прокси без переписывания исходного кода путем установки стандартных переменных окружения
HTTP_PROXY=http://proxy-manager:8115иHTTPS_PROXY=http://proxy-manager:8115. - Заголовки фильтрации:
X-Proxy-Tag,X-Proxy-Strategy,X-Proxy-Session.
- Позволяет сервисам платформы использовать прокси без переписывания исходного кода путем установки стандартных переменных окружения
- Система пороговых алертов и авто-пополнения:
- Оповещение при падении числа активных прокси ниже порога $N$.
- Публикация NATS событий (
system.proxy.low_stock). - Автоматический триггер пайплайнов
flow-managerчерез вебхук для авто-покупки новых прокси. - Пакетный импорт через
POST /api/v1/proxies/import(URL-списки, Host:Port:User:Pass, JSON, CSV).
- Архив и гео выхода:
archived: trueвыводит прокси из ротации (GET /proxies/next), health-check и счётчиков active/degraded/dead. Список без фильтраarchivedпоказывает и архивные, и живые.- Проверка пишет
countryиregion(город и регион). Если целевой URL проверки уже вернул гео в JSON — берётся оно; иначе для публичногоexit_ipзапрос идёт напрямую наip-api.com(не через сам прокси).
Конфигурация и переменные окружения
| Переменная | По умолчанию | Описание |
|---|---|---|
PORT | 8114 | Порт REST API |
FORWARD_PROXY_ENABLED | true | Включение прозрачного HTTP/CONNECT Forward Proxy |
FORWARD_PROXY_PORT | 8115 | Порт Forward Proxy |
HEALTH_CHECK_INTERVAL | 60s | Интервал фоновой проверки |
HEALTH_CHECK_CONCURRENCY | 10 | Параллелизм проверок |
HEALTH_CHECK_TARGET_URL | https://api.ipify.org?format=json | Эндпоинт верификации выходного IP |
DEGRADED_LATENCY_MS | 2000ms | Порог перевода в degraded |
MAX_CONSECUTIVE_FAILURES | 3 | Порог сбоев для перевода в dead |
API Эндпоинты
GET /api/v1/proxies— список с фильтрацией и пагинацией. Queryarchived=true|falseограничивает выборку; без параметра возвращаются все.POST /api/v1/proxies— добавление одиночного прокси.POST /api/v1/proxies/import— пакетный импорт прокси (plain text, JSON, CSV).POST /api/v1/proxies/archive— архив или возврат:{ "ids": ["…"], "archived": true }. Ответ:updated,archived.GET /api/v1/proxies/next— следующий прокси по стратегии (strategy,tag,protocol). Архивные не участвуют.POST /api/v1/proxies/:id/report— обратная связь о работоспособности прокси от потребителей.POST /api/v1/proxies/test— проверка произвольного прокси без сохранения в БД. В ответеlatency_ms,exit_ip,country,region.GET /api/v1/stats— метрики пула.archived_proxiesсчитается отдельно; active/degraded/dead/disabled — только неархивные.