Ноды
Нода — прокси-сервер, на котором работает Xray. Панель хранит её настройки, выдаёт конфигурацию и следит за состоянием. Запуск контейнера описан в разделе Установка ноды.
Добавление ноды
Nodes → Create node. Минимально нужны имя, адрес и профиль конфигурации.
| Поле | Обязательное | Описание |
|---|---|---|
name | да | 3–30 символов |
address | да | IP или домен сервера |
port | нет | порт управления (NODE_PORT, по умолчанию 2222) |
configProfile | да | профиль и активные инбаунды |
proxyUrl | нет | socks5://[user:pass@]host:port для управления через прокси |
countryCode | нет | код страны из двух букв, по умолчанию XX |
tags | нет | до 10 меток |
isTrafficTrackingActive, trafficLimitBytes, trafficResetDay | нет | учёт трафика ноды |
consumptionMultiplier, nodeConsumptionMultiplier | нет | множители списания трафика |
activePluginUuid, integrationUuids, note | нет | плагин, интеграции, заметка |
После сохранения панель один раз показывает SECRET_KEY — он нужен контейнеру
ноды. Ключ одноразовый и для каждой ноды свой.
Статусы
| Индикатор | Значение |
|---|---|
| зелёный, Connected | нода отвечает, Xray работает |
| жёлтый, Connecting | панель устанавливает соединение |
| серый, Disabled | нода выключена администратором |
| красный, Disconnected | нода не отвечает |
Если нода долго остаётся Disconnected, проверьте доступность NODE_PORT
с сервера панели и целостность SECRET_KEY.
Версия Xray и нагрузка
Карточка ноды показывает:
versions.xrayиversions.node— версии ядра и агента;system.stats— свободную и занятую память,loadAvg, uptime и объёмы трафика по сетевому интерфейсу;xrayUptime— время непрерывной работы Xray;usersOnline— число пользователей онлайн.
Нагрузка и история трафика ноды хранятся отдельно (таблица
nodes_usage_history) и чистятся по NODES_USAGE_HISTORY_RETENTION_DAYS.
Перезапуск
Restart node перезапускает Xray на ноде. Панель сравнивает набор
пользователей и перезапускает ядро только при изменениях; флаг forceRestart
заставляет перезапустить ядро принудительно, даже если конфигурация не
менялась. Для всех нод сразу — Restart all nodes.
Перезапуск Xray кратко прерывает активные соединения на этой ноде. Делайте его вне пиковой нагрузки.
Логи
Логи Xray лежат на ноде в /var/log/xray, ограничены 10 МБ и не архивируются.
Из панели они доступны на странице Logs, раздел «Node system logs».
Очистка — кнопка Clear logs: нода выполняет ротацию файла, Xray при этом
не перезапускается и трафик не прерывается. Вручную:
docker exec -it xpanel-node cli --clear-logs
Включение и выключение
Disable node переводит ноду в Disabled: Xray на ней останавливается, и
пользователи на неё не попадают. Enable node возвращает ноду в работу.
Счётчик трафика ноды можно обнулить отдельно — Reset node traffic; на лимиты
пользователей это не влияет.
Массовые действия (включить, выключить, перезапустить, сменить конфигурацию сразу для нескольких нод) собраны на странице Bulk actions.
Профиль и список инбаундов у нескольких нод меняются одной операцией. Это удобно при переезде с одного профиля на другой — см. Профили конфигурации.
Что дальше
- Установка ноды — запуск контейнера и
SECRET_KEY. - Хосты — как ноды становятся доступны клиентам.
- Профили конфигурации — что именно запускает Xray.
- Частые ошибки — если нода не подключается.