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

Что делает панель, а что вы

Панель — механизм, а не готовый кабинет. Мы не решаем бизнес-задачи вашего сервиса и не подстраиваемся под них: витрина, личный кабинет клиента, CRM — собираете вы, руками или вместе с ИИ.

Что вы получаете

Консоль
Команда veli на сервере панели: поставить панель, добавить узлы по IP, завести клиентов, выдать токены и вебхуки. Ничего не нужно открывать в браузере.
API
Все те же действия по HTTPS: клиенты, узлы, группы, трафик, события. Схема openapi.json — по ней ИИ или программист строит клиент на любом языке.
Вебхуки
Панель сама сообщает о событиях: клиент добавлен, срок кончается, трафик на исходе, узел замолчал. Ваш сервер получает запрос с подписью и делает своё.
MCP для ИИ
Тот же API как инструменты для Claude и других агентов: «кто истекает на этой неделе», «продли тем, у кого метка vip». Права — по токену.

Что делает панель

Всё, что связано с доступом к VPN, — надёжно и без вашего участия.

  • Хранит клиентов: срок, устройства, скорость, лимит трафика, заметку и ваши метки.
  • Отдаёт каждому одну ссылку на все ваши серверы и простую страницу подписки с кнопками приложений.
  • Раздаёт список клиентов узлам: новый клиент работает на всех узлах за полминуты.
  • Считает трафик и устройства, ведёт журнал действий, хранит удалённых клиентов в корзине 30 дней.
  • Сообщает о событиях вебхуками и лентой и отвечает ИИ-агенту по MCP.

Что делаете вы

Всё, что зависит от вашего бизнеса: оно остаётся у вас, панель в это не вмешивается.

  • Цены и оплата — Ваш прайс, платёжная система, возвраты, налоги. Панель знает только дни, устройства и трафик — цены и оплата у вас.
  • Витрина и кабинет клиента — Сайт или приложение, где человек платит, видит срок и берёт свою ссылку.
  • Ваш порядок работы — Кто и что может менять у вас в команде, какие письма и сообщения уходят клиентам, какие отчёты нужны.
  • Поддержка и учёт — CRM, заявки, история общения. Клиент связан с вашей системой внешним ID: номер заказа или ID пользователя у вас.

Токен

Сделать токен с нужными правами и сроком — для сайта, CRM или ИИ-агента — и держать его так, чтобы утечка ничего не стоила.

  1. Сделайте токен в консоли

    На сервере панели, под root: veli token add <имя> --rights read|clients|all. Токены и вебхуки делает только консоль — не другой токен и не вызов API.

  2. Название, права, срок

    Название — кто им пользуется, например cabinet. Права — read, clients или all (ниже). Срок — по желанию: --days 90, от 1 до 3650 дней; без --days токен бессрочный.

  3. Скопируйте токен

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

Токен на 90 дней — на сервере панели
veli token add cabinet --rights clients --days 90
Список токенов и отзыв по названию
veli token list
veli token revoke cabinet
Только чтение
--rights read. Смотреть клиентов без их ссылок, узлы, трафик, ленту событий. Ничего не меняет
Клиенты
--rights clients. Смотреть всё, ссылки клиентов тоже, и вести клиентов: добавить, продлить, отключить и включить, сменить ссылку, отвязать устройство, менять многих сразу. Удалять — нет
Всё
--rights all. Всё, что может панель: удалять клиентов, вести узлы и группы. Кроме токенов и вебхуков — их делает только консоль
  • Адрес API — адрес вашей панели, секретный путь и /api/. Его печатает veli token add под самим токеном (и установка панели). Путь — как пароль: держите его рядом с токеном, не в открытом репозитории.
  • Токен идёт в заголовке Authorization: Bearer veli_… — с ваших серверов. Скрипту на странице в браузере панель не ответит.
  • Токены и вебхуки по API не создаются, даже токеном «Всё»: утёкший токен не размножит себя. Их делает только консоль.

Пределы

  • 300 запросов в минуту на токен. Каждый ответ несёт RateLimit-Limit, RateLimit-Remaining — сколько осталось в этой минуте — и RateLimit-Reset — через сколько секунд минута начнётся заново.
  • Сверх предела — 429 wait и Retry-After: 60. Подождите столько секунд и повторите тот же запрос; для POST — с тем же ключом повтора.

Первый запрос

Проверьте токен: GET me отвечает его названием, правами и сроком, а заголовки — сколько запросов осталось в этой минуте.

На вашем сервере
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -si "$VELI/me" \
  -H "Authorization: Bearer $VELI_TOKEN"
Ответ
HTTP/1.1 200 OK
content-type: application/json
ratelimit-limit: 300
ratelimit-remaining: 299
ratelimit-reset: 41

{"name": "cabinet", "token": true, "rights": "clients", "until": 0, "api": 1}