Документация/Подключение/Своя панель/Узлы и клиенты·2 / 9

Узлы и клиенты

Узел ставится одной командой с сервера панели: она зайдёт на сервер по SSH, поставит Veli и протоколы и подключит узел. Клиент — ссылка со сроком и числом устройств, одна на все узлы.

Добавить узел

Имя узла, адрес его сервера и протоколы рядом с Veli:

На сервере панели
sudo veli nodes add de1 --ssh root@203.0.113.5 --protocols veli,reality,trojan

На экране: Отпечаток SSH сервера и вопрос «Доверять? [y/N]» — сверьте отпечаток с панелью хостера. Потом шаги установки и «Узел на связи». Если что-то не вышло, сервер остаётся как был — запустите команду снова.

Порт протокола — через двоеточие: --protocols veli,trojan:2083. Hysteria2 и TUIC — только на x86-64.

Вход на сервер

-i
Файл закрытого ключа. Без него команда пробует ключи из ~/.ssh, потом спрашивает пароль
--password-stdin
Пароль SSH из ввода — для скриптов
--fingerprint
Отпечаток сервера заранее, SHA256:… — вопроса «Доверять?» не будет
--from, --node-from
Взять собранные veli и узел с диска — для сервера, куда наш сайт не открывается

С другой машины

Те же команды работают с ноутбука или рабочего сервера, где лежит veli. Токен с правами all передаётся переменной, не строкой команды.

На сервере панели: печатает токен и адрес API
sudo veli token add laptop --rights all --days 7
На другой машине: токен — в переменную
export VELI_PANEL_TOKEN=…
Та же команда с адресом API панели
veli nodes add de1 --panel <адрес API> --ssh root@203.0.113.5 --protocols veli,reality,trojan

Пачка и user-data

Серверы из файла по очереди. Строка: имя [пользователь@]адрес[:порт] [протоколы] [key=файл] [fingerprint=SHA256:…]
sudo veli nodes add --file servers.txt
Вместо SSH печатает текст для поля «user-data» у хостера: сервер при создании сам поставит Veli и привяжется к панели
sudo veli nodes add de2 --protocols veli,trojan --cloud-init

В тексте для «user-data» — токен узла: обращайтесь с ним как с паролем и вставляйте только в форму хостера.

Список, протоколы, снятие

Узлы и когда каждый отчитался
sudo veli nodes
Добавить узлу протокол; --remove — снять
sudo veli nodes protocols de1 --ssh root@203.0.113.5 --add hysteria2
Убрать узел и вернуть сервер как был. Без --ssh — только убрать из панели; с --keep Veli остаётся на сервере
sudo veli nodes remove de1 --ssh root@203.0.113.5

Клиенты

Клиент — ссылка со сроком и числом устройств: одна на все узлы панели.

Новый клиент: печатает ссылку и QR-код. С --speed 50 — скорость Veli, Мбит/с
sudo veli users add anna --days 30 --devices 3
Клиенты: устройства, срок, трафик
sudo veli users
Ссылка и QR-код ещё раз
sudo veli users link anna
Продлить
sudo veli users extend anna --days 30
Убрать: узлы отключат клиента за полминуты, а сам он 30 дней лежит в корзине
sudo veli users remove anna

Клиент вставляет ссылку в Veli («Добавить» → вставить) или открывает её в браузере: страница подскажет остальные приложения.

Перенос из другой панели

Клиенты Remnawave, Marzban, 3x-ui, Hiddify и таблицы CSV переезжают со сроками, лимитами и устройствами. Без --yes команда только проверяет и ничего не пишет; вместо токена и пароля «-» — команда спросит сама.

Проверка. Marzban — --user и --password, Hiddify — --key
sudo veli panel import remnawave https://old.example.com --token -
Проверка по файлу базы 3x-ui, скопированному на сервер панели
sudo veli panel import 3x-ui --file x-ui.db
Перенос из таблицы: без истёкших, со старыми ссылками
sudo veli panel import csv --file clients.csv --skip-expired --redirect --yes
Все клиенты в таблицу — её можно загрузить обратно; --links добавит ссылки (файл храните как пароль)
sudo veli panel export --format csv --out clients.csv

Остальные флаги: --rename — занятое имя сделать «имя-2», --skip-disabled — без отключённых, --devices N — мест клиентам без лимита (по умолчанию 3), --redirect — старые ссылки ведут на новые. Столбцы таблицы показывает panel export.