RuProxy — Инструкция пользователя

Версия документа: 1.2
Актуальная версия ПО: 1.7.1
Официальный сайт: https://ru-proxy.ru
Поддержка: support@ru-proxy.ru · Telegram

Оглавление

1. Описание продукта
2. Системные требования
3. Установка
4. Первоначальная настройка
5. Конфигурация (config.yaml)
   - 5.1 Лицензия
   - 5.2 Сетевые параметры
   - 5.3 Маскировка ОС (OS Fingerprinting)
   - 5.4 IPv6 подсети и ротация
   - 5.5 API и управление пользователями
   - 5.6 DNS-резолвер
   - 5.7 Ограничение скорости (Traffic Shaping)
   - 5.8 Тайм-ауты
   - 5.9 Сервисный аккаунт
   - 5.10 Чёрный список (Blacklist)
   - 5.11 Логирование
6. HTTP API
7. Web-Дашборд
8. Управление службой
9. Логирование и мониторинг
10. Командная строка (CLI)
11. Диагностика и устранение неполадок
12. FAQ
13. История изменений

1. Описание продукта

RuProxy — высокопроизводительный SOCKS5(h) / HTTP CONNECT IPv6 прокси-сервер, написанный на Rust. Предназначен для развёртывания на собственном выделенном или виртуальном сервере (VPS) и выступает в роли шлюза: принимает входящие подключения по IPv4, авторизует их и маршрутизирует трафик через настроенные IPv6 подсети.

Ключевые возможности

Как это работает

   Ваше ПО            RuProxy Server           IPv6 подсети         Интернет
  (SOCKS5h/HTTP)  →   Auth • DNS • Shaping   →  Subnet A (w:100)  →  Target
                                                 Subnet B (w:50)

2. Системные требования

3. Установка

3.1. Автоматическая установка (рекомендуется)

Запустите от имени root:

curl -fsSL https://ru-proxy.ru/downloads/install.sh | bash

Скрипт автоматически:
1. Скачает и установит кастомное ядро Linux с патчем p0f
2. Настроит загрузчик GRUB на приоритетную загрузку нового ядра
3. Скачает и установит пакет RuProxy
4. Создаст системного пользователя ruproxy
5. Настроит systemd-сервис
6. Предложит перезагрузить сервер

3.2. Ручная установка

1. Скачайте .deb-пакет со страницы загрузки
2. Установите пакет:

dpkg -i ruproxy_*.deb
# При ошибках зависимостей:
apt-get install -f -y

3. (Опционально) Установите кастомное ядро для p0f:

dpkg -i linux-image-6.1.162-ruproxy-p0f_amd64.deb
update-grub

3.3. Что создаётся при установке

4. Первоначальная настройка

После установки сервис не запускается автоматически. Необходимо выполнить следующие шаги:

Шаг 1. Отредактируйте конфигурацию

nano /etc/ruproxy/config.yaml

Обязательно заполните:
- license_key — ваш лицензионный ключ (получить в Telegram)
- public_ip — внешний IPv4 адрес вашего сервера
- ipv6_subnets — ваши IPv6 подсети
- master_token — секретный токен для API (замените на свой!)

Шаг 2. Настройте маршрутизацию IPv6

Отредактируйте файл /etc/rc.local и раскомментируйте строку маршрута:

nano /etc/rc.local

Замените шаблон на вашу реальную подсеть:

ip -6 route add local 2a01:xxxx::/32 dev lo

Шаг 3. Проверьте конфигурацию

ruproxy -t /etc/ruproxy/config.yaml

Должно вывести ✅ Syntax OK. с перечислением основных параметров.

Шаг 4. Перезагрузите сервер

reboot

Это необходимо для применения кастомного ядра и правил маршрутизации.

Шаг 5. Запустите сервис

systemctl start ruproxy
systemctl status ruproxy

5. Конфигурация (config.yaml)

Все настройки находятся в файле /etc/ruproxy/config.yaml. Для применения изменений необходимо перезапустить службу.

5.1. Лицензия

license_key: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

license_servers:
  - "L1.license-server.ru:8000"
  - "L2.license-server.ru:8000"

5.2. Сетевые параметры

listen_ip: "0.0.0.0"
public_ip: "123.45.67.89"
# ext_iface: "eth0"  # Опционально

5.3. Маскировка ОС (OS Fingerprinting)

Секция listeners позволяет создать несколько портов, каждый с собственным профилем маскировки TCP/IP отпечатка. Антифрод-системы, анализирующие трафик утилитами типа p0f, увидят характерные для указанной ОС параметры.

Каждый listener поддерживает поле mode, определяющее протокол:

listeners:
  - port: 1080
    os_preset: "linux"
    # mode: "socks"  # По умолчанию, можно не указывать

  - port: 1081
    os_preset: "android"
    mode: "hybrid"    # Принимает и SOCKS5, и HTTP CONNECT

  - port: 1082
    os_preset: "windows"
    mode: "http"

  - port: 1083
    os_preset: "ios"
    mode: "socks"

  - port: 1084
    os_preset: "macos"
    mode: "http"

Доступные профили:

Тонкая настройка (только для опытных пользователей):

Каждый listener поддерживает ручную настройку сетевых параметров:

  - port: 1081
    os_preset: "android"
    tcp_congestion: "bbr"      # Алгоритм контроля перегрузок
    tcp_window_size: 1048576   # Размер TCP окна (байт)
    latency_base_ms: 60        # Базовая задержка (мс)
    jitter_ms: 30              # Джиттер (разброс задержки, мс)
    tos: 10                    # Traffic Class (QoS-маркер)

5.4. IPv6 подсети и ротация

ipv6_subnets:
  - cidr: "2a01:xxxx::/32"
    weight: 427
  - cidr: "2a02:yyyy:yyyy:yyyy::/64"
    weight: 16

rotation_interval: 10

Как работает ротация:
- IP-адрес привязан к паре логин/пароль (Sticky Session)
- При каждой авторизации проверяется, не истёк ли rotation_interval
- Если истёк — генерируется новый IPv6 из подсети (с учётом весов)
- Активные соединения НЕ разрываются — смена IP происходит только при новом подключении
- При простое сессии более 5 минут (настраиваемо через timeouts.idle) она закрывается

5.5. API и управление пользователями

api_port: 8080
api_port_https: 8443  # Опционально — HTTPS с самоподписным сертификатом

master_token: "my-secret-token"

max_accounts: 100000

accounts_file: "/var/lib/ruproxy/accounts_[port]_[os]_[mode].txt"

# account_seed: 123456789

5.6. DNS-резолвер

dns:
  timeout: 2
  cache_size: 8000
  suppress_aaaa_not_found: true

  servers:
    # Основные (с балансировкой)
    - address: "[2001:4860:4860::8888]:53"
      weight: 53
    - address: "1.1.1.1:53"
      weight: 7

    # Резервные (failover)
    - address: "[2001:4860:4860::8844]:53"
    - address: "9.9.9.9:53"

Логика работы:
1. Запрос отправляется на один из основных серверов с весом (выбирается по weight — чем больше вес, тем чаще сервер используется). Основных серверов может быть несколько.
2. Если основной сервер не ответил (таймаут/ошибка) — запрос идёт в резервный пул. Резервных серверов также может быть несколько (указываются без параметра weight).
3. Если домен существует, но не имеет AAAA-записи — это не ошибка соединения, бэкап не используется

5.7. Ограничение скорости (Traffic Shaping)

shaping:
  rate: 12500000   # 100 Мбит/с
  burst: 25000000  # 200 Мбит/с (burst)

Шпаргалка:

5.8. Тайм-ауты

timeouts:
  shutdown: 10    # Ожидание завершения сессий при остановке (сек)
  idle: 300       # Максимальное бездействие сессии (сек)

5.9. Сервисный аккаунт

service_account:
  enabled: true
  login: "checker"
  password: "strong_password"
  allowed_domain: "ifconfig.me"

Сервисный аккаунт предназначен для мониторинга и проверки работоспособности прокси. Особенности:
- Статический логин/пароль (не генерируется, не ротируется)
- Имеет доступ только к одному домену (allowed_domain)
- Не расходует лимиты ротации
- Не сменяет IP

5.10. Чёрный список (Blacklist)

blocked_file: "/etc/ruproxy/blacklist.txt"

Файл содержит список заблокированных доменов и IP-адресов (по одному на строку). Комментарии начинаются с #.

# Блокировка рекламных доменов
doubleclick.net
ads.google.com

# Блокировка приватных IPv6 сетей
fc00::/7
fe80::/10

5.11. Логирование

log:
  dir: "/var/log/ruproxy"
  level: "info"

Создаются два файла логов:
- ruproxy.log — полный лог (уровень задаётся параметром level)
- error.log — только ошибки (всегда)

6. HTTP API

API доступен по адресу http://YOUR_IP:PORT или https://YOUR_IP:PORT, где PORT задаётся параметрами api_port и api_port_https в конфигурации (8080 и 8443 по умолчанию).

Для аутентификации используется параметр token (значение из master_token).

6.1. Получение нового прокси — GET /allocate

Возвращает строку подключения с новой парой логин/пароль.

curl "http://YOUR_IP:8080/allocate?token=YOUR_TOKEN"

Ответ:

socks5://user_AbCdEfGh:KlMnOpQrSt@YOUR_IP:1080

Параметры запроса:

Примеры:

# SOCKS5 прокси с профилем Android
curl "http://YOUR_IP:8080/allocate?token=YOUR_TOKEN&os=android"
# Ответ: socks5://user_xxx:pass_xxx@YOUR_IP:1081

# HTTP прокси с профилем Android
curl "http://YOUR_IP:8080/allocate?token=YOUR_TOKEN&os=android&mode=http"
# Ответ: http://user_xxx:pass_xxx@YOUR_IP:1081

6.2. Статистика — GET /stats

Возвращает полную статистику сервера в JSON.

curl "http://YOUR_IP:8080/stats?token=YOUR_TOKEN"

Пример ответа:

{
  "version": "1.7.1",
  "uptime_seconds": 9980,
  "active_connections": { "tcp": 56, "udp": 4 },
  "traffic": {
    "ingress_bytes": 264074969,
    "egress_bytes": 35524983
  },
  "dns": { "total_queries": 18905 },
  "events": {
    "total_connections": 18963,
    "connection_errors": 12,
    "access_denied": 0,
    "blocked_domains": 0
  },
  "license": {
    "expires_at_unix": 1770484105,
    "days_left": 29,
    "servers": {
      "L1": "online",
      "L2": "online"
    }
  }
}

7. Web-Дашборд

Встроенный дашборд доступен по адресу:

http://YOUR_IP:8080/dashboard?token=YOUR_TOKEN

7.1. Мониторинг в реальном времени

Дашборд доступен по адресу http://YOUR_IP:PORT/dashboard?token=YOUR_TOKEN, где PORT задаётся параметром api_port в конфигурации. Поддерживается также HTTPS-режим через api_port_https.

Дашборд обновляется каждые 10 секунд и отображает:
- Аппаратные ресурсы — загрузка CPU (с указанием числа ядер) и использование RAM с прогресс-барами
- Сетевой трафик — суммарный Ingress/Egress в удобочитаемом формате (КБ/МБ/ГБ), количество всех и активных TCP/UDP соединений
- Лицензия и статус — оставшиеся дни и статус каждого сервера лицензирования (online/offline) в режиме реального времени
- Версия и аптайм — в шапке дашборда

7.2. Графики трафика

Два графика скорости (Rx/Tx в Мбит/с) с подписями средних значений:
- Почасовой — последние 60 минут с шагом 1 минута
- Суточный — последние 24 часа с шагом 1 час

7.3. Connection Analytics

Круговая диаграмма показывает разбивку всех соединений по категориям:

7.4. Управление IP Whitelist

Панель «IP Whitelist» позволяет управлять списком разрешённых IP-адресов и подсетей прямо из браузера, без перезапуска сервиса:
- Просмотр — отображает все записи с индикатором защищённости (🔒 — системная запись, недоступная для удаления)
- Добавление — поле ввода принимает отдельный IP или подсеть в CIDR-нотации (например, 192.168.1.0/24). Нажмите + Add Entry или Enter
- Удаление — кнопка «×» напротив каждой записи. Удаление 0.0.0.0/0 требует подтверждения во избежание случайной блокировки доступа
- Импорт из файла — кнопка «📁 Import» позволяет загрузить .txt-файл с перечнем IP/CIDR (по одному на строку, поддерживаются комментарии через #)

Список автоматически обновляется каждые 10 секунд — изменения, внесённые с другого устройства или администратором, отразятся без перезагрузки страницы.

7.5. Recent Blocks

Панель «🚨 Recent Blocks» отображает последние заблокированные соединения (до 10 записей) с IP-адресом и временем блокировки. Счётчик Total показывает суммарное число блокировок с момента последнего запуска сервиса.

7.6. AUTO-ROTATION API LINKS

В верхней части дашборда автоматически генерируются кнопки быстрого копирования прокси-ссылок, сгруппированные по профилям ОС (Linux, Android, Windows, iOS, macOS). Кнопки SOCKS5 и HTTP неактивны, если соответствующий протокол не включён для данного профиля.

При нажатии на кнопку в буфер обмена копируется ссылка для получения нового прокси (запрос GET /allocate?os=...&mode=...), а в нижнем правом углу появляется уведомление.

7.7. Темы оформления

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

8. Управление службой

RuProxy устанавливается как systemd-сервис и запускается от пользователя ruproxy.

# Запуск
systemctl start ruproxy

# Остановка (graceful — ждёт завершения активных сессий)
systemctl stop ruproxy

# Перезапуск
systemctl restart ruproxy

# Статус
systemctl status ruproxy

# Включить автозапуск
systemctl enable ruproxy

# Просмотр логов в реальном времени
journalctl -u ruproxy -f

9. Логирование и мониторинг

Файлы логов

Ротация логов

Логи ротируются автоматически через logrotate:
- Ежедневно или при достижении 100 МБ
- Хранится 10 предыдущих версий
- Сжатие gzip

Системная телеметрия

Каждые 10 секунд в лог выводится строка [SYS_STATS]:

[SYS_STATS] System Mem: 524/2048 MB | App Mem: 85 MB | CPU: 12.3% | Conns: 42 / 4096

10. Командная строка (CLI)

ruproxy [OPTIONS]

Опции:
  -c, --config <PATH>      Путь к файлу конфигурации (по умолчанию: config.yaml)
  -t, --test [<PATH>]      Проверить синтаксис конфигурации
  -g, --generate           Сгенерировать пример config.yaml.example
  -b, --blacklist          Сгенерировать пример blacklist.txt.example
  -H, --hwid               Показать HWID сервера
  -p, --ping <HOST:PORT>   Проверить доступность лицензионного сервера
  -V, --version            Показать версию
  -h, --help               Показать справку

Примеры:

# Запуск с конфигом по умолчанию
ruproxy

# Запуск с указанием конкретного конфига
ruproxy -c /etc/ruproxy/config.yaml

# Проверка конфига перед деплоем
ruproxy -t /etc/ruproxy/config.yaml

# Генерация примера конфигурации
ruproxy -g

# Проверка доступности сервера лицензий
ruproxy --ping L1.license-server.ru:8000

# Получение HWID
ruproxy -H

11. Диагностика и устранение неполадок

Сервис не запускается

1. Проверьте конфигурацию:
   ruproxy -t /etc/ruproxy/config.yaml

2. Проверьте логи:
   journalctl -u ruproxy --no-pager -n 50

3. Проверьте лицензионный сервер:
   ruproxy --ping <HOST:PORT>
   Адрес HOST:PORT берётся из параметра license_servers в конфигурации.

Нет подключения через прокси

1. Убедитесь, что клиент использует правильный протокол — SOCKS5, SOCKS5h или HTTP CONNECT (все поддерживаются). Для максимальной анонимности рекомендуется SOCKS5h (DNS-запросы разрешаются на стороне сервера).
2. Проверьте маршрутизацию IPv6 — осмотрите содержимое файла /etc/rc.local и вывод команды:
   ip -6 route show
3. Проверьте, что порт доступен извне:
   ss -tlnp | grep ruproxy
4. Проверьте файрвол (iptables/nftables)

Не открываются некоторые сайты

RuProxy работает только через IPv6. Если целевой сайт не имеет AAAA-записи (IPv6), подключение невозможно.

Проверить наличие AAAA:

dig AAAA example.com

IP не меняется

RuProxy использует Sticky Sessions. IP привязан к паре логин/пароль. Для смены IP:
- Запросите нового пользователя через GET /allocate
- Или дождитесь истечения rotation_interval и переподключитесь

12. FAQ

В: Что такое SOCKS5h и чем отличается от SOCKS5?

О: В режиме SOCKS5h DNS-запросы выполняются на стороне прокси-сервера (Remote DNS). В обычном SOCKS5 DNS разрешается на стороне клиента — это может привести к DNS-утечкам и раскрыть реальный IP. Всегда используйте SOCKS5h.

В: Почему при каждом перезапуске генерируются новые логины/пароли?

О: По умолчанию аккаунты генерируются из случайного энтропийного зерна. Раскомментируйте и задайте account_seed в конфиге — логины/пароли станут постоянными между перезапусками.

В: Можно ли использовать несколько IPv6 подсетей?

О: Да, добавьте их в секцию ipv6_subnets с разными весами. Трафик будет распределяться пропорционально весам.

В: Как узнать HWID моего сервера?

О: Выполните ruproxy -H. HWID нужен для привязки лицензии к серверу.

В: Сколько ресурсов потребляет RuProxy?

О: При 100 000 аккаунтов и ~50 активных соединениях — около 80–120 МБ RAM и ~5% CPU на 1 ядре. Сервер написан на Rust — это обеспечивает высокую производительность и предсказуемое потребление памяти.

В: Безопасен ли API?

О: При включённом api_port_https API работает через HTTPS с самоподписным сертификатом. Для cURL используйте флаг -k. Доступ к API защищён master_token. Статистика (/stats) доступна без токена только с localhost.

В: Что такое HTTP CONNECT режим?

О: HTTP CONNECT — стандартный метод проксирования HTTPS-трафика. Клиент отправляет CONNECT host:443 HTTP/1.1 с заголовком Proxy-Authorization: Basic, после чего устанавливается зашифрованный туннель. Поддерживается всеми браузерами, curl, системными настройками прокси и большинством ПО.

Пример использования через curl:

curl -x http://user_xxx:pass_xxx@YOUR_IP:1081 https://ifconfig.me

В: Чем hybrid отличается от отдельных socks/http портов?

О: В режиме hybrid сервер принимает оба протокола на одном порту. Протокол определяется автоматически по первому байту соединения (0x05 = SOCKS5, иначе HTTP). Это удобнее — не нужно открывать дополнительные порты. Все фишки (p0f, shaping, DNS, лимиты) работают одинаково для обоих протоколов.

В: Что делает переменная [mode] в accounts_file?

О: При экспорте аккаунтов [mode] заменяется на протокол (socks5 или http). Для hybrid-листенеров создаются два файла — один с socks5:// ссылками, другой с http://. Пример: accounts_1081_android_socks5.txt и accounts_1081_android_http.txt.

13. История изменений

v1.7.1 — апрель 2026

• Web-Дашборд — IP Whitelist — полноценное управление белым списком прямо из браузера: добавление, удаление, импорт из файла. Изменения вступают в силу немедленно, без перезапуска сервиса.
• Автообновление дашборда — данные IP Whitelist и Recent Blocks теперь обновляются автоматически каждые 10 секунд вместе с остальной статистикой.
• Connection Analytics — новая круговая диаграмма с разбивкой соединений по категориям (успешные, заблокированные, ошибки, IPv4-only домены).
• Recent Blocks — панель последних заблокированных соединений с отметками времени и суммарным счётчиком.
• Темы оформления — добавлены пять визуальных тем дашборда с сохранением выбора в браузере.
• Поддержка HTTP CONNECT — полноценный HTTP-прокси режим с авторизацией Proxy-Authorization: Basic, корректной обработкой всех вариантов заголовка.
• Улучшена устойчивость сервиса — порт API-дашборда больше не вызывает бесшумное падение при занятом порту; ошибка явно указывается в журнале.
• Исправлен макет дашборда — устранена проблема несовпадения границ колонок между виджетами при различных разрешениях экрана.

v1.7.0 — март 2026

• Hybrid Mode — автоматическое определение протокола (SOCKS5 / HTTP CONNECT) на одном порту по первому байту соединения.
• HTTP прокси — добавлена поддержка режима http в секции listeners.
• Поле [mode] в accounts_file — для hybrid-листенеров экспортируются два файла аккаунтов: с SOCKS5 и HTTP ссылками.

v1.6.0 — январь 2026

• HTTPS API — опциональный порт api_port_https с самоподписным сертификатом.
• Smart DNS Failover — резервный пул DNS-серверов с автопереключением при недоступности основного.
• Сервисный аккаунт — статическая учётная запись с ограничением доступа одним доменом для чекеров и мониторинга.