VPN-бот — это система автоматизации продаж для VPN-сервиса. Он принимает оплату, создаёт пользователя на сервере, выдаёт ключ подключения, следит за сроком подписки и напоминает о продлении. Владелец сервиса при этом не выдаёт доступы вручную и не сверяет платежи в таблице.
В этой статье мы смотрим на такого бота глазами разработчика: из каких частей он состоит, как они взаимодействуют и какие решения приходится принимать при проектировании.
Сразу оговоримся: мы занимаемся технической стороной — разработкой программного обеспечения. За соблюдение законодательства при эксплуатации сервиса, включая требования к VPN-сервисам, рекламе, обработке персональных данных и приёму платежей, отвечает его владелец. Перед запуском мы рекомендуем проконсультироваться с юристом.
Из каких компонентов состоит система
Типовой VPN-бот — это не одна программа, а несколько связанных частей.
- Telegram-бот. Интерфейс для пользователя: выбор тарифа, оплата, получение ключа, инструкции, поддержка.
- Серверная часть (бэкенд). Бизнес-логика: тарифы, подписки, балансы, рефералы, планировщик задач.
- База данных. Хранит пользователей, платежи, подписки, промокоды. Чаще всего используют PostgreSQL.
- Платёжный модуль. Создаёт счета и принимает уведомления об оплате от платёжных систем.
- Панель управления VPN-серверами. Отдельное ПО, которое управляет учётными записями на серверах. Бот обращается к ней по API.
- VPN-серверы (ноды). Машины, через которые идёт трафик пользователей.
- Админ-панель. Инструмент владельца: статистика, управление пользователями и серверами, рассылки.
Ключевой принцип: бот сам не шифрует трафик и не является VPN-сервером. Он — надстройка, которая управляет доступами через панель.
Панели управления — 3x-ui и Marzban
Чтобы не настраивать каждого пользователя на сервере вручную, используют панели с открытым исходным кодом. Две популярные — 3x-ui и Marzban. Обе работают поверх ядра Xray и предоставляют API, через который бот создаёт, продлевает и отключает пользователей.
| Параметр | 3x-ui | Marzban |
|---|---|---|
| Основа | Xray | Xray |
| Управление | Веб-интерфейс и API | Веб-интерфейс и REST API |
| Модель данных | Входящие подключения (inbounds) и клиенты внутри них | Пользователи с набором доступных протоколов |
| Несколько серверов | Обычно отдельная панель на каждом сервере | Центральная панель и подключаемые ноды |
| Ссылки-подписки | Поддерживаются | Поддерживаются |
| Лимиты | Срок действия, объём трафика, число устройств | Срок действия, объём трафика |
Выбор панели влияет на архитектуру. При работе с 3x-ui бот, как правило, хранит список серверов и обращается к каждой панели отдельно. С Marzban бот общается с одной центральной панелью, а она сама распределяет пользователей по нодам. Возможности панелей меняются от версии к версии, поэтому мы закладываем в код слой абстракции: логика бота не зависит от конкретной панели, и её можно заменить без переписывания всего проекта.
Протоколы — VLESS и WireGuard
Протокол определяет, как клиентское приложение соединяется с сервером. Для разработчика бота важны формат ключа и способ управления пользователями.
VLESS — легковесный протокол из экосистемы Xray. Пользователь идентифицируется по UUID, а параметры подключения упаковываются в строку-ссылку вида vless://…. Её можно отправить текстом, QR-кодом или включить в подписку. Шифрование обеспечивает транспортный слой — как правило, TLS или Reality.
WireGuard — быстрый современный протокол, встроенный в ядро Linux. Работает поверх UDP, использует пары ключей. Пользователю выдаётся конфигурационный файл .conf или QR-код. Управлять им можно через панели с поддержкой WireGuard либо через отдельные инструменты, к которым бот обращается по API.
На практике бот часто поддерживает несколько протоколов, а пользователь получает единую ссылку-подписку, в которую входят все доступные ему подключения.
Что происходит от оплаты до выдачи ключа
Основной сценарий выглядит так:
- Пользователь запускает бота и выбирает тариф — например, на месяц, три месяца или год.
- Бот создаёт в базе запись о платеже со статусом «ожидает оплаты» и выставляет счёт через платёжную систему.
- Пользователь оплачивает.
- Платёжная система отправляет на сервер бота уведомление (webhook) об успешной оплате.
- Бэкенд проверяет подлинность уведомления и сумму, меняет статус платежа.
- Бот через API панели создаёт пользователя с нужным сроком действия и лимитами.
- Панель возвращает ссылку подключения или подписки.
- Бот отправляет пользователю ключ, QR-код и инструкцию по настройке приложения.
Весь процесс занимает несколько секунд и не требует участия человека.
Здесь важны детали надёжности. Уведомление от платёжной системы может прийти дважды — значит, обработка должна быть идемпотентной, чтобы не продлить подписку два раза. Панель может быть недоступна в момент оплаты — значит, нужна очередь с повторными попытками и уведомление администратору. Именно на таких случаях экономят в дешёвых шаблонных решениях, и именно они потом приводят к потерянным платежам.
Способы оплаты
Набор зависит от юридической модели владельца сервиса и правил площадок. В ботах используют Telegram Stars, платёжные агрегаторы с оплатой картой и через СБП, криптовалютные сервисы. У каждого варианта свои требования и ограничения — в частности, у Telegram есть собственные правила для продажи цифровых услуг внутри ботов. Мы подробно сравнили способы в статье про оплату в Telegram-боте.
Подписки и автоматическое продление
Подписка — это запись в базе со сроком действия, связанная с пользователем в панели. За её жизненным циклом следит планировщик:
- за несколько дней до окончания отправляет напоминание с кнопкой продления;
- в день окончания повторяет уведомление;
- после истечения срока отключает пользователя в панели;
- при продлении сдвигает дату окончания и снова активирует доступ — ключ у пользователя остаётся прежним.
Удобный механизм — ссылка-подписка. Это один URL, который пользователь добавляет в клиентское приложение. Приложение периодически запрашивает по нему актуальный список серверов. Если владелец добавил новый сервер или заменил адрес, конфигурация обновится у клиентов автоматически, без повторной рассылки ключей.
Дополнительно обычно реализуют пробный период, внутренний баланс, промокоды и ограничение числа устройств.
Реферальная система
Рефералка строится на механизме глубоких ссылок Telegram. Каждому пользователю бот генерирует ссылку вида t.me/имя_бота?start=ref_12345. Когда новый человек переходит по ней и нажимает «Старт», бот получает параметр и записывает в базу, кто его пригласил.
Дальше — вопрос правил начисления:
- бонусные дни подписки за каждого приглашённого;
- процент от платежей реферала на внутренний баланс;
- многоуровневая схема с разными ставками.
При проектировании важно предусмотреть защиту от накруток: начислять бонус только после первой оплаты приглашённого, запретить приглашать самого себя, вести журнал начислений.
Админ-панель
Без инструментов управления владелец остаётся слепым. В админку обычно входят:
- статистика — новые пользователи, активные подписки, выручка по периодам;
- поиск пользователя, просмотр его платежей и подписок, ручное продление и блокировка;
- управление тарифами и промокодами;
- управление серверами — добавление, отключение, контроль загрузки;
- рассылки по всей базе или сегментам;
- обращения в поддержку.
Админка может быть встроена в бота или вынесена в веб-интерфейс либо Mini App — второй вариант удобнее при большом числе пользователей.
Сколько стоит разработка
VPN-бот под ключ с оплатой и автоматической выдачей ключей стоит у нас от 30 000 ₽. Версия с реферальной системой и админ-панелью — от 60 000 ₽. На итоговую цену влияют число платёжных систем, поддержка нескольких серверов и панелей, сложность реферальной программы. Состав услуги описан на странице разработки VPN-ботов, остальные тарифы — в разделе цен.
Частые вопросы
Нужен ли для бота отдельный сервер?
Да, боту и базе данных нужен собственный сервер или хотя бы отдельное окружение. Размещать их на тех же машинах, что и VPN-ноды, не стоит: при замене ноды вы не должны терять базу пользователей и платежей.
Можно ли подключить бота к уже работающей панели?
Можно. Если у вас настроены 3x-ui или Marzban и есть действующие пользователи, бот подключается к API панели, а существующих клиентов переносим в его базу.
Что будет с пользователями, если поменять сервер?
При использовании ссылок-подписок клиентские приложения получат новую конфигурацию при очередном обновлении. При выдаче статичных ключей их придётся перевыпустить — бот может сделать это массово и разослать уведомления.
Кто отвечает за законность работы сервиса?
Владелец сервиса. Мы разрабатываем программное обеспечение и передаём его заказчику. Соблюдение требований законодательства при эксплуатации — зона ответственности того, кто управляет сервисом.
Вывод
VPN-бот — это связка из Telegram-бота, бэкенда с базой данных, платёжного модуля и панели управления серверами. Его ценность — в полной автоматизации: от приёма оплаты до выдачи ключа и контроля подписок. Надёжность такой системы определяется не интерфейсом, а тем, как обработаны сбои платежей и панелей. Если вам нужен такой проект, посмотрите, как мы работаем, и напишите нам — обсудим архитектуру под вашу задачу.