Статистика в реальном времени

Откуда берутся данные

Xray-core собирает статистику по каждому inbound'у и outbound'у: сколько байт прошло, сколько соединений активно, какие клиенты потребляют трафик. Панель 3x-ui читает эти данные через API Xray и отображает в интерфейсе.

Обновление в реальном времени реализовано через WebSocket: браузер держит соединение с панелью, и цифры меняются без перезагрузки страницы. Это удобно для мониторинга «здесь и сейчас».

Разрезы статистики

По inbound'ам

Для каждого входящего соединения видно:

• Входящий и исходящий трафик.
• Количество активных соединений.
• Скорость в реальном времени (байт/с).

Это позволяет понять, какой протокол или порт нагружен больше всего.

По клиентам

Для каждого клиента (UUID/email):

• Потреблённый трафик за всё время.
• Остаток квоты (если задана).
• Время последнего подключения.
• Текущее число активных IP.

Удобно для контроля расхода и выявления «тяжёлых» пользователей.

По outbound'ам

Если inbound'ы перенаправляют трафик через outbound'ы (например, цепочки проксирования), видно, сколько трафика ушло через каждый outbound. Это полезно при маршрутизации по правилам.

По нодам (в мульти-нодовом режиме)

Агрегированная статистика по всем серверам: суммарный трафик, распределение по нодам, статус каждой ноды.

Графики и визуализация

Панель строит:

• Линейные графики — трафик за последние часы/дни, с шагом по времени.
• Круговые диаграммы — распределение трафика между inbound'ами или клиентами.
• Таблицы — сортировка по объёму, фильтрация по клиенту или inbound'у.

Исторические данные хранятся в базе панели (SQLite по умолчанию) и не теряются при перезапуске. Глубина хранения зависит от настроек и объёма данных.

API для интеграций

Если встроенных графиков недостаточно, можно забрать данные через API и построить собственный дашборд (Grafana, Zabbix, самописный скрипт):

GET /panel/api/inbounds/onlines
GET /panel/api/inbounds/list
GET /panel/api/server/status
GET /panel/api/inbounds/getClientTraffics/{email}

API возвращает JSON с полями up, down, total, expiryTime и т.д. Авторизация — по токену сессии или API-ключу (в зависимости от настроек панели).

Ограничения и нюансы

• Точность — статистика Xray приблизительна: учитываются байты на уровне прокси, но не накладные расходы TLS/QUIC.
• Задержка — данные WebSocket приходят с небольшой задержкой (секунды), это не «мгновенный» снимок.
• Объём базы — при большом числе клиентов и долгом хранении SQLite может расти. Следите за размером /etc/x-ui/x-ui.db.
• Мульти-нодовость — статистика с нод агрегируется с задержкой, равной интервалу опроса.