RuProxy Socks5(h) IPv6 Proxy-Server — Руководство пользователя Версия: 1.0 Дата обновления: 16.12.2025 Официальный сайт: https://ru-proxy.ru Поддержка: support@ru-proxy.ru ======================== 1. ОПИСАНИЕ ПРОДУКТА ======================== RuProxy — это высокопроизводительное серверное решение для организации Socks5(h) IPv6 прокси. Продукт создан для задач, требующих высокой анонимности, стабильного соединения и гибкого управления сетевыми потоками. Сервер поддерживает "умную" ротацию IPv6 адресов, собственный DNS-резолвер для защиты от утечек и систему управления скоростью (Traffic Shaping). Ключевые возможности: Поддержка SOCKS5 и SOCKS5h: Полная поддержка протокола, включая режим удаленного разрешения DNS (Remote DNS Resolution). При правильной настройке клиентского приложения целевой сайт увидит DNS-запросы, отправленные через того же провайдера, на котором работает прокси-сервер. Реализована полная поддержка UDP. Взвешенная ротация IPv6 (Weighted Rotation): Возможность балансировать исходящий трафик между разными подсетями, задавая им приоритет (вес). Технология Lazy Rotation ("Ленивая ротация"): Смена IP-адреса происходит "по таймеру" при новой авторизации. Активные соединения не разрываются принудительно, что обеспечивает стабильную работу долгих сессий. Smart DNS Failover: Встроенная система, которая автоматически переключается на резервные DNS-серверы (например, Google или Cloudflare), если локальные DNS перестают отвечать. Hot-Swap API: Простой HTTP API для мгновенной генерации новых доступов и получения статистики сервера. ======================== 2. АРХИТЕКТУРА РАБОТЫ ======================== RuProxy работает как шлюз между вашим программным обеспечением и интернетом. Схема работы: +-----------------+ | Ваше ПО | +-----------------+ | v +--------------------------+ | RuProxy Server | | [Auth] → [Smart DNS] | +------------+-------------+ | +--------------+--------------+ | | +-----+------+ +------+-----+ | IPv6 сеть A| | IPv6 сеть B| |(Weight 25) | | (Weight 3) | +-----+------+ +------+-----+ | | v v +-----------------------------------------+ | I N T E R N E T | +-----------------------------------------+ Важно: Для максимальной анонимности ваше клиентское ПО должно использовать режим SOCKS5h (иногда называется "Proxy DNS when using SOCKS5"). В этом случае DNS-запросы выполняются самим сервером RuProxy через выходной IPv6, а не вашим компьютером. ======================== 3. КОНФИГУРАЦИЯ (config.yaml) ======================== Все настройки находятся в файле config.yaml, расположенном в /etc/ruproxy/. Для применения изменений необходимо перезапустить службу. --- Основные настройки --- license_key: Ваш лицензионный ключ. Обязательный параметр для запуска. listen_ip: Интерфейс с IPv4 адресом, на котором сервер ожидает подключения (обычно 0.0.0.0 для доступа извне). port: Порт для входящих SOCKS5 подключений (по умолчанию 1080). public_ip: Внешний IPv4 адрес вашего сервера. Критически важен для корректной работы API и формирования ссылок подключения. --- Ротация IPv6 (ipv6_subnets) --- Вы можете подключить одну или несколько IPv6 подсетей произвольного размера. Параметр "weight" (вес) определяет, как часто будет использоваться конкретная подсеть при генерации исходящих адресов. Пример: Если у Подсети-1 вес 100500, а у Подсети-2 вес 2, то Подсеть-1 будет выдавать адреса в 50250 раз чаще. --- Политика ротации (rotation_interval) --- Этот параметр определяет "время жизни" IP адреса в минутах. В рамках одной активной сессии IP не сменится. Но при следующем подключении, если прошло rotation_interval минут, для данной учётной записи будет сгенерирован новый IP адрес. Если значение = 0: Ротация по времени отключена. IP-адрес закрепляется за пользователем (логином) до перезагрузки сервера. Если значение > 0: Интервал в минутах. После истечения этого времени сервер сменит IP-адрес при следующем запросе авторизации. Примечание: RuProxy использует принцип "Sticky Session". Он не обрывает активные соединения посередине работы. Смена IP происходит только при новом подключении (авторизации), если разрешенное время истекло. Отдельно стоит отметить, что при простое сессии более 5 минут она закроется принудительно. Если rotation_interval менее 5 минут, то при возобновлении трафика исходящий IP будет новым. Не рекомендуется устанавливать слишком маленькие значения rotation_interval. --- Настройка DNS (dns) --- От скорости DNS зависит скорость начала загрузки страниц. Рекомендация: В блоке servers укажите локальные DNS вашего хостинг-провайдера первыми (часто их можно найти в файле /etc/resolv.conf на сервере). Как правило, они самые быстрые (пинг 1-2 мс) и для провайдерских сетей нет ограничений количества запросов в определённый промежуток времени. Если клиентское ПО не пытается "разрешить" адрес на определенном DNS-сервере, RuProxy попытается сделать это на одном из серверов с указанным параметром weight, определяющим вероятность выбора именно этого сервера. В случае недоступности приоритетных серверов попытки продолжатся через "Failover" сервера. В этом разделе можно указать публичные DNS (1.1.1.1, 2001:4860:4860::8888). Формат приведён в конфигурационном файле по умолчанию. --- Ограничение скорости (shaping) --- Позволяет ограничить общую пропускную способность сервера. rate: Максимальная скорость в Байтах/сек (0 = безлимит). burst: "Взрывная" скорость (буфер). Позволяет кратковременно превысить лимит для мгновенной загрузки мелких файлов. Ограничение касается как входящего, так и исходящего трафика. То есть ограничение в 100 мегабит/с (в конфиге 12500000) позволит загружать и скачивать одновременно со скоростью 100 мегабит/с. ======================== 4. API И ИНТЕГРАЦИЯ ======================== Сервер предоставляет локальный HTTP API. Адрес API: http://YOUR_PUBLIC.IP:8080 (порт задается в конфиге). Для доступа требуется токен, который задаётся параметром master_token в конфиге. --- 1. Получение нового прокси (Allocate) --- Возвращает строку прокси для подключения. Запрос: GET /allocate?token=ВАШ_ТОКЕН Ответ (текст): socks5://user123:pass456@1.2.3.4:1080 --- 2. Статистика (Stats) --- Возвращает состояние сервера в формате JSON. Запрос: GET /stats?token=ВАШ_ТОКЕН Пример ответа: { "status": "running", "uptime_seconds": 3600, "active_connections": { "tcp": 50, "udp": 0 }, "traffic": { ... } } ======================== 5. БЕЗОПАСНОСТЬ И СЕРВИСНЫЕ ФУНКЦИИ ======================== --- Сервисный аккаунт --- В конфиге в раздел service_account можно задать статического пользователя. Особенность: Этот пользователь имеет доступ ТОЛЬКО к одному разрешенному домену (например, ifconfig.me). Назначение: Использование для мониторинга работоспособности прокси ("чекеров") без расходования лимитов ротации и без смены IP. --- Черный список (Blacklist) --- Файл blacklist.txt, расположенный в /etc/ruproxy/ позволяет блокировать доступ к определенным ресурсам. Поддерживается блокировка по домену (example.com) и по IP. ======================== 6. ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ (FAQ) ======================== В: Мой софт пишет "DNS Resolve Error". О: Убедитесь, что ваш софт настроен на использование SOCKS5h (удаленный DNS). Если софт пытается резолвить домены локально на вашем компьютере, прокси не сможет маршрутизировать трафик через IPv6. В: Почему не открываются некоторые сайты? О: RuProxy поддерживает проксирование только к сайтам с поддержкой IPv6. В: Почему IP не меняется при каждом запросе? О: RuProxy использует архитектуру закрепленных сессий. IP привязан к связке логин/пароль. Чтобы получить новый IP, нужно либо сгенерировать нового пользователя через API (/allocate), либо дождаться истечения rotation_interval и переподключиться.