Skip to main content
Оба способа установки находятся на странице ноды во вкладке Агент.

​
Перед установкой

Ноду настоятельно рекомендуется брать чистой — свежий Linux, где кроме ОС и доступа по SSH ничего нет. Агент управляет службами ноды, её портами и сетевой конфигурацией и разворачивает на ней собственный стек. Прежняя панель на том же сервере (одиночная Remnawave, 3x-ui, Marzban и подобные), своё прокси-ядро на 443 или ручные правила firewall будут спорить с агентом за одни и те же порты и конфиги. Подробнее — Чистый сервер.
Завести новый сервер почти всегда быстрее, чем вычищать старый: снести чужую панель до конца сложнее, чем кажется, и остатки её сервисов всплывают уже под трафиком.

​
Новый сервер через мастер ноды

В Ноды → Добавить ноду мастер последовательно спрашивает имя, расположение, SSH, Remnawave, основной домен, DNS, профили и дополнительные сервисы, установку и мониторинг. Без домена DNS-шаг пропускается. Введённые данные сохраняются при возврате назад и ошибке создания; перед запуском проверьте итоговый план. Для обычного добавления начальный режим трафика — standby, в обучении — active. Привязка существующей Remnawave-ноды сохраняет её runtime. Состояния установки и импорта не подтверждают здоровье до появления свежих наблюдений. Cloudflare можно настроить в мастере; дополнительные домены добавляются позже в Домены и TLS.

​
Установка по SSH

  1. Откройте Ноды и выберите сервер.
  2. Перейдите во вкладку Агент.
  3. Запустите мастер установки по SSH.
  4. Введите секрет для подключения.
  5. Запустите проверку соединения.
  6. После успешной проверки подтвердите установку.
Мастер сам создаёт одноразовый enrollment-токен, подключается к серверу, устанавливает агент, ждёт первый heartbeat и отзывает временный токен. Выпускать enrollment-токен перед запуском SSH-мастера не нужно. Подробный результат сохраняется во вкладке Установка.

​
Ручная установка

  1. Во вкладке Агент найдите блок Ручная установка и нажмите Сгенерировать enrollment token.
  2. Скопируйте сформированную панелью команду.
  3. Выполните её на сервере с правами root.
  4. Вернитесь в панель и дождитесь статуса online.
Enrollment-токен нужен только для ручной установки. Он одноразовый и ограничен по времени.

​
Существующая нода и владение runtime

Для уже подключённой Remnawave-ноды выберите привязку существующей записи вместо создания новой. Панель повторно проверяет её через живой API и использует имеющийся runtime; одного устаревшего снимка недостаточно. При обнаружении чужой или нераспознанной установки агента bootstrap останавливается до её замены. Если мастер предлагает принять установку под управление, изучите цель и подтвердите именно это действие. Штатная процедура сохраняет резервную копию перед заменой. Повторная установка не должна молча удалять чужой контейнер Remnawave или сбрасывать его конфигурацию.

​
Проверка

Вкладка Агент показывает hostname, ОС, capabilities и свежий heartbeat. Вкладка Установка не содержит незавершённых шагов.

​
Повторная установка

Если установка завершилась ошибкой, откройте вкладку Установка, исправьте причину последнего неуспешного шага и запустите мастер повторно.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.
Дополнение по изменениям кода Axottle: 2026-09-08. Новые сценарии сверены с реализацией; установка на реальные ноды в рамках этой сверки не выполнялась.