Мульти-нодовость

Зачем это нужно

Один сервер имеет ограничения: пропускную способность, географию, репутацию IP. Когда пользователей становится больше или нужны точки присутствия в разных регионах, один Xray-core перестаёт быть достаточным. Мульти-нодовость позволяет добавить второй, третий, десятый сервер и управлять ими из одной панели, не переключаясь между интерфейсами.

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

Как это устроено

Есть мастер-панель (та, на которой вы работаете) и ноды (удалённые серверы с Xray-core). Мастер хранит конфигурацию и отправляет изменения на ноды по HTTPS с токеном доступа. Ноды выполняют Xray и периодически отчитываются о трафике и статусе.

Добавление ноды

В панели указываются:

• Название — для удобства (например, node-eu-1).
• Адрес — IP или домен удалённого сервера.
• Порт — порт API ноды (обычно тот же, что у панели, или отдельный).
• API Token — секрет для аутентификации.

После добавления нода появляется в списке, и можно проверять её доступность.

Клонирование inbound'ов

Самый частый сценарий: создать inbound на мастере, затем «клонировать» его на выбранные ноды. Панель отправит конфигурацию на ноды, и inbound'ы запустятся там с теми же параметрами (порт, протокол, настройки транспорта). Клиенты, привязанные к этому inbound'у, могут подключаться к любой ноде.

Группы нод

Ноды можно объединять в группы по географии или назначению (например, «EU», «Asia», «резерв»). При клонировании inbound'а выбирается группа, и конфигурация уходит на все ноды в ней.

Статистика и мониторинг

Мастер-панель агрегирует данные со всех нод:

• Суммарный трафик по всем нодам.
• Трафик по каждой ноде отдельно.
• Статус ноды (онлайн/офлайн, нагрузка).
• Количество активных клиентов на каждой ноде.

Если нода перестаёт выходить на связь, панель помечает её как недоступную и (опционально) уведомляет через Telegram.

Пример API-запроса

POST /panel/api/nodes/add
{
  "name": "node-eu-1",
  "address": "203.0.113.10",
  "port": 2053,
  "apiToken": "secret-token",
  "enable": true
}

После добавления: POST /panel/api/nodes/{id}/cloneInbound с ID inbound'а для клонирования.

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

• Ноды должны быть доступны по сети с мастера (обычно по HTTPS).
• Версии Xray на мастере и нодах должны быть совместимы.
• При клонировании inbound'а клиенты не копируются автоматически — нужно явно указать, каких клиентов синхронизировать.
• Статистика с нод собирается с задержкой (интервал опроса настраивается).