VPN-бот в Telegram изнутри — архитектура, оплата и автоматическая выдача ключей

· 8 мин чтения · Автор: команда Codrex

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.

На практике бот часто поддерживает несколько протоколов, а пользователь получает единую ссылку-подписку, в которую входят все доступные ему подключения.

Что происходит от оплаты до выдачи ключа

Основной сценарий выглядит так:

  1. Пользователь запускает бота и выбирает тариф — например, на месяц, три месяца или год.
  2. Бот создаёт в базе запись о платеже со статусом «ожидает оплаты» и выставляет счёт через платёжную систему.
  3. Пользователь оплачивает.
  4. Платёжная система отправляет на сервер бота уведомление (webhook) об успешной оплате.
  5. Бэкенд проверяет подлинность уведомления и сумму, меняет статус платежа.
  6. Бот через API панели создаёт пользователя с нужным сроком действия и лимитами.
  7. Панель возвращает ссылку подключения или подписки.
  8. Бот отправляет пользователю ключ, 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-бота, бэкенда с базой данных, платёжного модуля и панели управления серверами. Его ценность — в полной автоматизации: от приёма оплаты до выдачи ключа и контроля подписок. Надёжность такой системы определяется не интерфейсом, а тем, как обработаны сбои платежей и панелей. Если вам нужен такой проект, посмотрите, как мы работаем, и напишите нам — обсудим архитектуру под вашу задачу.

Обсудим ваш проект?

Расскажите о задаче — предложим решение, назовём сроки и стоимость. Консультация бесплатна.

Обсудить проект