FAQ

Продление добавляет время или перезаписывает?

Добавляет: новый срок наращивается от текущей даты окончания. Счётчик трафика при платном продлении обнуляется.

Можно ли привязать к боту уже существующего клиента панели?

Да, двумя путями: автоматически (если username учётки содержит его TG ID или заполнено поле telegramId — бот свяжет при регистрации) или вручную: Пользователи → карточка → 🔗 Связать с панелью, ввести username/UUID учётки.

Что будет, если юзер с активной подпиской в панели зарегистрируется в боте?

Бот найдёт учётку, привяжет её, покажет срок действия и закроет триал. Дальше юзер продлевает её из бота как обычно.

Бот меняет чужие учётки панели?

Нет. Управлять можно только учётками, созданными ботом (tg_<id> / тег бота) или привязанными админом вручную. Остальные бот не трогает.

Вебхук не дошёл — деньги пропадут?

Нет: каждая оплата создаёт «ожидающий счёт», фоновый реконсилятор раз в 2 минуты перепроверяет статус у провайдера до 24 часов и довыдаёт подписку. Дубли исключены уникальным индексом по ID платежа.

Как переехать с SQLite на PostgreSQL?

Система → Перенастроить → выбрать PostgreSQL. Бот поднимет контейнер БД и перенесёт данные сам.

Где лежат деньги/ключи? Что бэкапить?

Том bot-data: bot.db (если SQLite) и secret.key (ключ шифрования настроек). Для Postgres — pg_dump + тот же secret.key. Без secret.key конфиг не расшифровать.

Ещё вопросы

Чем отличается канал dev от latest?

:latest собирается из ветки main (стабильное), :dev — из ветки dev (новые возможности раньше). Канал переключается в боте без потери данных.

Нужен ли отдельный nginx/Caddy для вебхуков?

Нет — у бота есть встроенный HTTPS (способ A). Либо проксируйте через существующий reverse-proxy панели.

Как включить автосписание и как его отключить?

Админ включает автоплатежи в Продажи → ЮKassa → 🔁 Автоплатежи (в кабинете ЮKassa магазину должны быть включены рекуррентные платежи) и задаёт, за сколько дней до конца подписки списывать. Пользователь подключает автопродление сам: после успешной оплаты картой бот присылает предложение «Включить автопродление?» — до согласия не списывается ничего. Отключается одной кнопкой: «Моя подписка» → «🔁 Автопродление» → «Отключить» (то же самое есть в мини-аппе и веб-кабинете). После отключения списаний нет, подписка доработает оплаченный срок. Если списание не прошло, бот предупредит и повторит через сутки, а после трёх неудач выключит автопродление сам.

Можно ли пускать в бота только по приглашениям?

Да: Пользователи → 🚪 Доступ → ✉️ По приглашениям. Дальше «➕ Новое приглашение»: указываете срок жизни ссылки (0 — бессрочно) и число регистраций (0 — без ограничения), бот отдаёт ссылку t.me/ваш_бот?start=inv_КОД. Перешедший получает постоянный доступ, счётчик активаций проверяется атомарно, ссылку можно отозвать или удалить. Остальные режимы — «публично» и «белый список».

Работает ли веб-кабинет за reverse-proxy?

Да, встроенный HTTPS не нужен: кабинет отдаётся тем же портом, что и вебхуки. Но проксировать надо весь домен (location /), а не только /webhook/, и передавать X-Forwarded-Proto: https. Пример конфига — в разделе «Вебхуки и reverse-proxy».

Можно ли поставить свой дизайн мини-аппа и кабинета?

Да — смонтируйте папку со своими файлами в /custom: они перекроют вшитые (index.html общий, miniapp.html/cabinet.html — раздельные), правки видны без перезапуска. Подробности — в разделе «Свой дизайн мини-аппа и веб-кабинета».

Можно ли переехать с другого бота?

Да, для remnashop есть мастер: Система → Переезд с remnashop. Пришлите боту дамп его базы (кнопка «Бэкап» в remnashop) — перенесутся пользователи, сроки подписок, отметка об использованном триале, рефералы и баллы, промокоды и история платежей. Аккаунты в панели остаются как есть, дублей не будет. Поддерживаются remnashop v0.8.0–v0.8.2 (дамп более старой версии бот отклонит и подскажет сначала обновить remnashop); панель может быть как 2.7.4+, так и 3.x — идентификаторы панели в базе бота не хранятся.

Где взять API-токен панели?

В дашборде Remnawave создайте API-token с ролью API.

Какие версии панели поддерживаются?

2.7.4+ и 3.x. В 3.0.0 панель убрала uuid пользователя и поиск по Telegram ID — бот умеет оба диалекта и переключается сам, так что обновлять панель и бота можно в любом порядке. На панели 3.x у API-токенов есть скоупы: если создаёте токен заново, дайте боту доступ к пользователям, сквадам, HWID-устройствам и системной статистике (при обновлении панели старые токены мигрируют сами).