Мониторинг трафика

Обзор

Система мониторинга трафика v2 выявляет пользователей с аномально высоким потреблением и уведомляет администраторов. Работает в режиме только уведомлений — автоматической блокировки нет. Два типа проверок:

Быстрая проверка — дельта трафика между интервалами
Ежедневная проверка — абсолютный объём за 24 часа

Включение мониторинга

# Глобальный переключатель
TRAFFIC_MONITORING_ENABLED=true

# Быстрая проверка (дельта)
TRAFFIC_FAST_CHECK_ENABLED=true
TRAFFIC_FAST_CHECK_INTERVAL_MINUTES=10
TRAFFIC_FAST_CHECK_THRESHOLD_GB=5.0

# Ежедневная проверка (абсолютный объём за 24ч)
TRAFFIC_DAILY_CHECK_ENABLED=true
TRAFFIC_DAILY_CHECK_TIME=00:00
TRAFFIC_DAILY_THRESHOLD_GB=50.0

Все настройки можно менять без перезапуска через админ-панель (Мониторинг → Настройки трафика).

Быстрая проверка (Fast Check)

Проверяет дельту — сколько трафика потрачено между двумя снимками.

Как работает

При старте бота создаётся начальный снимок (snapshot) трафика всех пользователей
Каждые N минут загружаются текущие данные из Remnawave API
Для каждого пользователя вычисляется дельта: текущий_трафик - предыдущий_трафик
Если дельта превышает порог — отправляется уведомление администратору

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

Параметры

Переменная	Тип	По умолчанию	Описание
`TRAFFIC_FAST_CHECK_ENABLED`	`bool`	`false`	Включить быструю проверку
`TRAFFIC_FAST_CHECK_INTERVAL_MINUTES`	`int`	`10`	Интервал между проверками (мин)
`TRAFFIC_FAST_CHECK_THRESHOLD_GB`	`float`	`5.0`	Порог дельты трафика (ГБ)

Ежедневная проверка (Daily Check)

Проверяет абсолютный объём трафика за последние 24 часа через Remnawave Bandwidth Stats API.

Как работает

В указанное время запрашивает статистику трафика каждого пользователя за последние 24 часа
Если суммарный трафик превышает порог — отправляется уведомление
Запросы выполняются параллельно с ограничением конкурентности

Параметры

Переменная	Тип	По умолчанию	Описание
`TRAFFIC_DAILY_CHECK_ENABLED`	`bool`	`false`	Включить ежедневную проверку
`TRAFFIC_DAILY_CHECK_TIME`	`str`	`00:00`	Время проверки в формате `HH:MM` (UTC)
`TRAFFIC_DAILY_THRESHOLD_GB`	`float`	`50.0`	Порог трафика за 24 часа (ГБ)

Фильтрация

По нодам

Можно указать белый список (мониторить только эти ноды) или чёрный список (мониторить все, кроме этих).

# Белый список — мониторить ТОЛЬКО эти ноды (приоритетнее чёрного)
TRAFFIC_MONITORED_NODES=uuid-node-1,uuid-node-2

# Чёрный список — мониторить все, КРОМЕ этих
TRAFFIC_IGNORED_NODES=uuid-test-node

Если указан TRAFFIC_MONITORED_NODES, то TRAFFIC_IGNORED_NODES игнорируется. Можно добавлять комментарии после #.

По пользователям

Исключение сервисных/туннельных аккаунтов с высоким трафиком:

# UUID пользователей для исключения из проверок
TRAFFIC_EXCLUDED_USER_UUIDS=uuid-tunnel-account,uuid-service-account

Сравнение UUID регистронезависимое.

Уведомления

Куда отправляются

Уведомления отправляются в топик SUSPICIOUS_NOTIFICATIONS_TOPIC_ID (с фоллбэком на ADMIN_NOTIFICATIONS_TOPIC_ID).

SUSPICIOUS_NOTIFICATIONS_TOPIC_ID=123

Защита от спама

Механизм	Описание
Кулдаун на пользователя	Повторное уведомление по тому же пользователю не чаще `TRAFFIC_NOTIFICATION_COOLDOWN_MINUTES` (по умолчанию 60 мин)
Лимит за проверку	Максимум 10 уведомлений за одну проверку
Задержка между отправками	0.5 сек между уведомлениями для защиты от rate limit Telegram

TRAFFIC_NOTIFICATION_COOLDOWN_MINUTES=60

Формат уведомления

⚠️ Превышение трафика

👤 Имя Фамилия
🆔 ID: 123456789
📱 Username: @username

🔑 UUID: user-uuid-here

⚡ Быстрая проверка
📊 За интервал: 7.50 ГБ
📊 Порог: 5.00 ГБ
🚨 Превышение: 2.50 ГБ

🖥 Сервер: DE-Frankfurt-1
   node-uuid-here

🕐 24.02.2026 15:30:00 UTC

Для ежедневной проверки заголовок меняется на «Суточная проверка», трафик показывается как «За 24 часа».

Производительность

Переменная	Тип	По умолчанию	Описание
`TRAFFIC_CHECK_BATCH_SIZE`	`int`	`1000`	Размер пакета при загрузке пользователей из Remnawave API
`TRAFFIC_CHECK_CONCURRENCY`	`int`	`10`	Параллельные запросы при ежедневной проверке

Хранение данных

Снимки трафика хранятся в Redis с автоматическим фоллбэком на оперативную память.

Переменная	Тип	По умолчанию	Описание
`TRAFFIC_SNAPSHOT_TTL_HOURS`	`int`	`24`	Время жизни снимка в Redis (часы)

Redis-ключи:

Ключ	Содержимое
`traffic:snapshot`	JSON-словарь `{uuid: bytes}`
`traffic:snapshot:time`	Время последнего снимка (ISO)
`traffic:notifications:{uuid}`	Время последнего уведомления (TTL 24ч)

При перезапуске бота снимок из Redis переиспользуется — не нужно ждать повторного накопления данных.

Админ-панель

В разделе Мониторинг доступны:

Проверка трафика — ручной запуск быстрой проверки с отображением результатов (топ-10 нарушителей)
Настройки трафика — изменение всех параметров без перезапуска:
- Вкл/выкл быстрой и ежедневной проверок
- Интервал, пороги, время ежедневной проверки
- Кулдаун уведомлений
- Информация о фильтрах нод и пользователей (только чтение)

Устаревшие параметры

Для обратной совместимости с v1 поддерживаются:

Переменная	Описание
`TRAFFIC_THRESHOLD_GB_PER_DAY`	Порог в ГБ/день (используется как порог быстрой проверки если `TRAFFIC_FAST_CHECK_ENABLED=false`)
`TRAFFIC_MONITORING_INTERVAL_HOURS`	Интервал в часах (конвертируется в секунды)

Рекомендуется использовать новые переменные TRAFFIC_FAST_CHECK_* и TRAFFIC_DAILY_* вместо устаревших.

Полный пример конфигурации

# Глобальный переключатель
TRAFFIC_MONITORING_ENABLED=true

# Быстрая проверка: каждые 5 минут, порог 3 ГБ
TRAFFIC_FAST_CHECK_ENABLED=true
TRAFFIC_FAST_CHECK_INTERVAL_MINUTES=5
TRAFFIC_FAST_CHECK_THRESHOLD_GB=3.0

# Ежедневная проверка: в полночь, порог 30 ГБ
TRAFFIC_DAILY_CHECK_ENABLED=true
TRAFFIC_DAILY_CHECK_TIME=00:00
TRAFFIC_DAILY_THRESHOLD_GB=30.0

# Мониторить только определённые ноды
TRAFFIC_MONITORED_NODES=uuid-prod-node-1,uuid-prod-node-2

# Исключить сервисные аккаунты
TRAFFIC_EXCLUDED_USER_UUIDS=uuid-tunnel-account

# Уведомления: кулдаун 30 минут, в отдельный топик
TRAFFIC_NOTIFICATION_COOLDOWN_MINUTES=30
SUSPICIOUS_NOTIFICATIONS_TOPIC_ID=123

# Производительность
TRAFFIC_CHECK_BATCH_SIZE=500
TRAFFIC_CHECK_CONCURRENCY=5
TRAFFIC_SNAPSHOT_TTL_HOURS=48

​Обзор

​Включение мониторинга

​Быстрая проверка (Fast Check)

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

​Параметры

​Ежедневная проверка (Daily Check)

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

​Параметры

​Фильтрация

​По нодам

​По пользователям

​Уведомления

​Куда отправляются

​Защита от спама

​Формат уведомления

​Производительность

​Хранение данных

​Админ-панель

​Устаревшие параметры

​Полный пример конфигурации

Обзор

Включение мониторинга

Быстрая проверка (Fast Check)

Как работает

Параметры

Ежедневная проверка (Daily Check)

Как работает

Параметры

Фильтрация

По нодам

По пользователям

Уведомления

Куда отправляются

Защита от спама

Формат уведомления

Производительность

Хранение данных

Админ-панель

Устаревшие параметры

Полный пример конфигурации