Зачем оператору бот для Remnawave
Панель Remnawave управляет пользователями Xray/VLESS, но это админский инструмент: создать юзера, выдать ссылку на подписку, продлить срок — руками. На 20–30 клиентах это ещё терпимо, на сотне — работа на полный день, а ночью клиент с истёкшей подпиской просто уходит.
Remnawave telegram bot переносит весь цикл клиента в Telegram и убирает вас из рутины:
- клиент сам жмёт «Пробный период» и мгновенно получает рабочую подписку;
- бот создаёт пользователя в панели через API, назначает internal squad и лимит трафика;
- оплата, продление и напоминания об окончании идут без вашего участия;
- у вас — админка бота: сколько активных, сколько платящих, кто отвалился.
Архитектурно бот для Remnawave — это витрина и касса поверх панели. Панель остаётся «мозгом» (конфиги, ноды, лимиты), бот — точкой контакта с клиентом, связь между ними по API. Схема одинаковая для Remnawave, Marzban и 3x-ui: панель отдельно, продающий бот отдельно.
Что умеет remnawave bot: набор функций
Функции у разных ботов отличаются, но зрелый remnawave bot обычно закрывает такой набор.
Для клиента:
- /start, привязка Telegram ID к пользователю панели;
- триал с лимитом по трафику и сроку;
- покупка и продление, выбор тарифа;
- ссылка на подписку + QR, кнопка «Подключить» с диплинками в клиенты (Happ, v2rayNG, Streisand);
- остаток дней и трафика;
- рефералы и промокоды.
Для оператора:
- приём платежей и автопродление;
- уведомления клиенту за N дней/часов до окончания;
- массовая рассылка по базе;
- статистика по выручке и активным;
- бан/разбан и ручная выдача из админ-меню.
Ключевой нюанс: бот не «раздаёт VPN» — он только оркестрирует панель. Трафик идёт через ваши ноды Xray, и бот наследует все ограничения инфраструктуры: если нода недоступна, красивая касса не спасёт — клиент просто не подключится.
Какие боты есть под Remnawave
Официального бота Remnawave не поставляет — экосистема держится на сторонних проектах. По наблюдениям, они делятся на три категории.
1. Open-source shop-боты. Готовые проекты класса remnawave-tg-shop: магазин подписок с оплатой, триалом, рефералами и админкой. Ставятся в Docker, конфигурируются через .env. Плюс — бесплатно и под контролем; минус — сами обновляете, чините и разбираетесь в чужом коде. Многие — идейные преемники marzban-shop, чьи авторы перенесли логику на Remnawave API.
2. SaaS / боты «под ключ». Кто-то предлагает бота как услугу или платную сборку. Стартовать быстрее, но вы зависите от чужого хостинга и отдаёте свой API-токен наружу — вопрос доверия.
3. Свой бот на API. Нужны нестандартные тарифы, своя биллинг-логика, интеграция с CRM — пишется на aiogram (Python) или grammY (JS) поверх REST API Remnawave. Максимум гибкости, максимум работы.
Честно: список «лучших» ботов быстро устаревает, поэтому не буду выдумывать их фичи. Правильный фильтр при выборе — свежесть репозитория (последние коммиты, открытые issues), заявленная совместимость с вашей версией панели и наличие нужных платёжных провайдеров. Бот под старую версию API — типовая причина того, что «всё сломалось после обновления Remnawave».
Как подключить бота к Remnawave: пошагово
Схема почти одинакова для любого бота для Remnawave.
1. Токен бота. Создаёте бота у @BotFather → BOT_TOKEN.
2. Доступ к API панели. В Remnawave выпускаете API-токен (Bearer). Боту нужны URL панели, токен, ваши admin-ID:
REMNAWAVE_API_URL=https://panel.example.com
REMNAWAVE_API_TOKEN=eyJhbGciOi...
BOT_TOKEN=123456:AA...
ADMIN_IDS=1111111113. Привязка к squad/лимитам. Указываете, в какой internal squad бот сажает новых юзеров и какие дефолты ставит: trafficLimitBytes, стратегию сброса трафика, expireAt. Под капотом создание пользователя — это примерно POST /api/users с телом вроде {username, trafficLimitBytes, expireAt, activeInternalSquads:[...]}, в ответ приходит subscriptionUrl, который бот и отдаёт клиенту.
4. Платёжный провайдер. Прописываете ключи кассы (см. следующий раздел).
5. Деплой. Обычно рядом с панелью или на отдельном хосте:
git clone <repo> && cd <repo>
cp.env.example.env # заполнить
docker compose up -d
docker compose logs -f # проверить, что бот стартанул и видит APIЕсли бот на другом сервере — панель должна быть доступна ему по HTTPS.
6. Webhook или поллинг. Часть ботов слушает события Remnawave (окончание подписки, превышение трафика) через webhook — тогда открываете эндпоинт и прописываете его в панели. Часть просто опрашивает API по расписанию.
Безопасность. API-токен панели — ключ от всей базы. Держите бота и панель в одной приватной сети (docker-network / внутренний интерфейс) или ограничьте доступ к API по IP, не светите токен в публичных сборках, скриншотах и логах. Компрометация токена = слив всех подписок и возможность массово создавать/удалять юзеров.
Продажа подписок: платежи, триал, автопродление
Монетизация — главная причина ставить бота. Типовой сценарий.
Платёжные методы. Под РФ и СНГ обычно подключают несколько сразу, клиент выбирает удобный:
- Telegram Stars — технически проще всего, всё внутри Telegram; вопросы вывода и комиссии — отдельная тема;
- CryptoBot / крипта — популярно у VPN-операторов, меньше рисков с блокировкой платежей;
- ЮKassa / ЮMoney / карты — для «белой» аудитории, но нужна самозанятость/юрлицо, и к VPN-тематике эквайринг не всегда дружелюбен.
Триал. Пробный период — главный инструмент конверсии: бот выдаёт, скажем, 3 дня / 10 ГБ, по окончании предлагает оплатить. Обязательно ставьте лимит трафика И привязку к одному Telegram ID, иначе триалом будут пользоваться бесконечно, пересоздавая аккаунты.
Тарифы и автопродление. Сетка 1/3/6/12 мес., после оплаты бот дергает API и двигает expireAt. Автосписание через сохранённый метод заметно поднимает retention — продлеваться в один тап проще, чем каждый месяц принимать решение заново.
Рефералы и промокоды. Бонусные дни обоим участникам — дешёвый органический рост базы.
Честная оговорка: бот продаёт доступ, но качество доступа определяет инфраструктура. Продать подписку легко — сложно сделать так, чтобы она стабильно работала в зоне блокировок.
Подводные камни: бот не спасёт мёртвую ноду
Частая ошибка новичка: вылизать бота и оплату, а потом получить шквал возвратов, потому что ноды перестали подключаться. Бот — касса и витрина, но не транспорт. Что держать в голове:
- Версии API. Бот жёстко завязан на структуру API Remnawave. После мажорного обновления панели сверяйте совместимость — иначе выдача подписок отваливается, часто молча. Обновляйте бота и панель осознанно, держите бэкап
.envи БД. - Единая точка отказа. Бот на том же сервере, что и панель — падение хоста роняет и продажи, и управление. Разносите или хотя бы держите бэкап конфигов для быстрого переезда.
- Ссылка на подписку. Бот отдаёт subscription URL. Если домен/сервер подписки заблокируют, клиент не обновит конфиг — здесь помогают no-cache заголовки и отдельный устойчивый домен подписки (это отдельная тема, см. разбор про панель за CDN).
- Устойчивость нод — главное. Сервер в дата-центре при работе через белые списки блокируется по IP, и бот с идеальной оплатой становится бесполезен: клиенту нечем подключиться. Живучесть даёт не бот, а фронт — клиент ходит не на голый IP ноды, а на whitelisted-CDN, который проксирует трафик до вашего Xray и прячет IP. Бот при этом просто выдаёт ссылку на CDN-фронт. Детали фронтинга — отдельный разговор; здесь важно одно: бот и устойчивость подключения — две разные инженерные задачи.
Вывод: относитесь к remnawave telegram bot как к слою продаж и автоматизации. Хорошо продающий бот поверх нестабильной инфраструктуры генерирует не выручку, а возвраты и отток.