Права токена панели
На панели Remnawave 3.x у API-токена есть скоупы: токен может только то, что в них перечислено. Если права не хватает, панель отвечает 403 Forbidden, и функция не работает.
На панели 2.x скоупов нет — токен может всё, эта страница не нужна. При обновлении панели до 3.x старые токены переносятся сами.
Готовый список
Заголовок раздела «Готовый список»Всё, что нужно боту со всеми функциями:
system:remnawave-healthsystem:statsusers:listusers:streamusers:by-idusers:by-usernameusers:createusers:updateusers:deleteusers:reset-trafficusers:revoke-subscriptioninternal-squads:listexternal-squads:listhosts:listhwid-user-devices:list-by-userhwid-user-devices:delete-allnode-plugins:listnode-plugins:updatenode-plugins:executorsubscription-page-configs:listsubscriptions:subpage-configОбязательный минимум
Заголовок раздела «Обязательный минимум»Без этих прав бот не работает: не проверит связь, не найдёт пользователя, не выдаст и не продлит подписку.
| Скоуп | Зачем |
|---|---|
system:remnawave-health |
проверка связи с панелью — с неё начинаются мастер и экран «Подключение к панели» |
system:stats |
число пользователей панели в мастере, /status и «Системе» |
users:stream |
поиск аккаунта по Telegram ID |
users:by-username |
поиск аккаунтов без Telegram ID (например, зарегистрированных в кабинете по почте) |
users:by-id |
привязка существующего аккаунта панели к человеку в админке |
users:list |
обход всех аккаунтов: переезд с другого бота, сверки, доп-подписка |
users:create |
новая подписка и триал |
users:update |
продление, лимиты, сквады, блокировка и разблокировка |
users:delete |
удаление аккаунта из админки и снятие доп-подписки |
users:reset-traffic |
обнуление трафика |
users:revoke-subscription |
перевыпуск ссылки подписки |
internal-squads:list |
выбор внутренних сквадов в мастере, тарифах и триале |
external-squads:list |
выбор внешнего сквада |
По функциям
Заголовок раздела «По функциям»Нужны, только если функция включена. Без них остальное работает.
| Функция | Скоупы | Что будет без них |
|---|---|---|
| Страны и число конфигов в карточке тарифа | hosts:list |
строки со странами не будет, продажа не пострадает |
| «Мои устройства»: список и сброс | hwid-user-devices:list-by-user, hwid-user-devices:delete-all |
список пуст, сброс отвечает ошибкой |
| Торрент-блокер: «Снять блокировку IP» и «В исключения» | node-plugins:list, node-plugins:update, node-plugins:executor |
кнопки отвечают 403 |
| Мини-апп «Подключение»: приложения из настроек страницы подписки | subscription-page-configs:list, subscriptions:subpage-config |
бот покажет свой встроенный список приложений |
Короткий вариант
Заголовок раздела «Короткий вариант»Панель принимает и широкие права: * (всё), ресурс:* (например, users:*), ресурс:read или ресурс:write (все чтения или все записи ресурса). Поэтому вместо списка выше подойдёт:
users:*system:readinternal-squads:listexternal-squads:listhosts:listhwid-user-devices:*node-plugins:*subscription-page-configs:listsubscriptions:subpage-configПрав будет больше, чем нужно, но бот заработает.
Если панель отвечает 403
Заголовок раздела «Если панель отвечает 403»- Токен не сохраняется, «панель не на связи». Скорее всего, нет
system:remnawave-health: проверка связи начинается с него, и без него токен выглядит нерабочим целиком. - 403 на кнопках торрент-блокера. Нет
node-plugins:updateилиnode-plugins:executor. - Бот «теряет» подписку и заводит второй аккаунт. Проверьте
users:streamиusers:by-username.
Токен меняется в боте: Система → 🔌 Подключение к панели → 🔑 API-token. Бот проверяет его на панели до сохранения, так что нехватку прав видно сразу.