Создание Telegram-бота для управления VPN: полное руководство

Управление VPN-сервером через Telegram — это удобно, современно и безопасно. Представьте: вы открываете мессенджер, пишете боту /start и через секунду получаете готовые конфиги для подключения, статистику трафика или мгновенно переключаете протокол. Никаких сложных панелей, никакого SSH — всё в одном чате.

В этой статье мы пошагово создадим Telegram-бота для управления личным VPN-сервером. Вы узнаете, как интегрировать его с XHTTP + Reality, настроить автоматическую выдачу ключей, мониторинг нагрузки и даже биллинг. А главное — поймёте, почему личный VPS даёт вам неограниченные возможности для такой автоматизации, в отличие от массовых VPN-сервисов.

Зачем бот для управления VPN?

Современный VPN-сервер — это не просто туннель. Это целая экосистема: несколько протоколов, десятки пользователей, ротация ключей, мониторинг трафика, смена локаций. Управлять всем этим через консоль неудобно, а через веб-панель — не всегда безопасно и быстро.

Telegram-бот решает эти проблемы:

• Мгновенный доступ — бот всегда под рукой, не нужно открывать браузер или подключаться по SSH.
• Автоматизация — выдача конфигов, продление подписок, уведомления о превышении трафика — всё автоматически.
• Безопасность — двухфакторная аутентификация через Telegram, шифрование команд, логирование.
• Масштабируемость — один бот может управлять несколькими серверами и сотнями клиентов.

Архитектура решения

Наш бот будет состоять из трёх основных компонентов:

1. Telegram-бот (на Python с библиотекой python-telegram-bot) — обрабатывает команды пользователей.
2. Xray-сервер с протоколом XHTTP + Reality — обеспечивает маскировку трафика под обычный HTTPS.
3. База данных (SQLite или PostgreSQL) — хранит информацию о пользователях, ключах, трафике.

Бот взаимодействует с Xray через его API (или через прямое редактирование конфигов), а все изменения логируются и синхронизируются с БД.

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Telegram   │────▶│   Python    │────▶│    Xray     │
│  Пользователь│     │    Бот      │     │   + Reality │
└─────────────┘     └─────────────┘     └─────────────┘
                           │
                           ▼
                    ┌─────────────┐
                    │   SQLite    │
                    │   (БД)      │
                    └─────────────┘

Подготовка VPS и установка Xray

Прежде чем писать бота, настроим сам VPN-сервер. Мы будем использовать Xray — форк проекта XTLS, который поддерживает передовой протокол XHTTP + Reality.

1. Арендуйте VPS (рекомендуем сервер вне РФ, например, в Нидерландах или Германии).
2. Установите Xray по официальной инструкции или с помощью скрипта bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install.
3. Настройте конфиг /usr/local/etc/xray/config.json с протоколом XHTTP + Reality. Пример базовой конфигурации:

{
  "inbounds": [{
    "port": 443,
    "protocol": "vless",
    "settings": {
      "clients": [],
      "decryption": "none"
    },
    "streamSettings": {
      "network": "xhttp",
      "xhttpSettings": {
        "path": "/"
      },
      "security": "reality",
      "realitySettings": {
        "dest": "www.google.com:443",
        "serverNames": ["www.google.com"],
        "privateKey": "...",
        "shortIds": ["..."]
      }
    }
  }],
  "outbounds": [{"protocol": "freedom", "tag": "direct"}]
}

Пишем бота на Python

Теперь перейдём к самому боту. Используем библиотеку python-telegram-bot (версия 20+). Установите зависимости:

pip install python-telegram-bot sqlite3 requests

Структура бота:

• Команда /start — приветствие и регистрация нового пользователя.
• Команда /getconfig — выдача свежего конфига для подключения.
• Команда /status — статистика трафика и оставшийся срок.
• Команда /renew — продление подписки (можно интегрировать с платёжным шлюзом).
• Админ-команды — /users, /block, /unblock для управления пользователями.

Пример обработчика команды /getconfig:

async def get_config(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_id = update.effective_user.id
    # Проверяем, есть ли пользователь в БД и активна ли подписка
    user = db.get_user(user_id)
    if not user or not user.active:
        await update.message.reply_text("❌ Доступ ограничен. Обратитесь к администратору.")
        return
    # Генерируем уникальный ключ для Xray (или берём готовый)
    config = xray_api.create_client(user_id)
    # Формируем ссылку vless://... или выдаём JSON-конфиг
    await update.message.reply_text(f"🔗 Ваш конфиг:\n`{config}`", parse_mode='MarkdownV2')

Интеграция с XHTTP + Reality

Самый важный момент — бот должен уметь добавлять и удалять пользователей в Xray. Для этого есть два пути:

1. Через REST API Xray (если включён api в конфиге).
2. Прямое редактирование config.json и перезагрузка сервиса.

Мы рекомендуем использовать API — это быстрее и безопаснее. Пример вызова через requests:

import requests
def add_user(user_id, email):
    payload = {
        "name": f"user_{user_id}",
        "email": email,
        "level": 0,
        "alterId": 0
    }
    resp = requests.post("http://127.0.0.1:10085/xray/v1/account/add", json=payload)
    return resp.json()

После добавления пользователя бот генерирует для него ссылку vless:// с параметрами вашего сервера (IP, порт, public key, shortId). Эту ссылку пользователь просто копирует в свой VPN-клиент (например, Nekoray или Hiddify).

Безопасность и защита

Бот управляет вашим VPN — значит, безопасность должна быть на высоте.

• Авторизация — только зарегистрированные Telegram-пользователи могут выполнять команды.
• Шифрование — все соединения между ботом и Xray по localhost (или через TLS).
• Логирование — все действия записываются в БД для аудита.
• Ограничение команд — чувствительные операции (блокировка, смена тарифа) доступны только админам.
• Регулярная смена ключей — автоматическая ротация для повышения безопасности.

Почему личный VPS — идеальная основа для такого бота

Именно на таком личном VPS вы можете развернуть своего Telegram-бота и быть уверенным, что:

• Ваш бот не будет заблокирован вместе с сотнями других пользователей.
• Выдаваемые конфиги будут работать стабильно и быстро.
• Вы всегда сможете обновить протоколы и настройки без оглядки на провайдера.

Заключение

Создание Telegram-бота для управления VPN — это не просто хобби, а инструмент для реального контроля над вашей цифровой инфраструктурой. Вы получаете:

• Удобство — все операции в несколько кликов в мессенджере.
• Безопасность — двухфакторная авторизация, шифрование, логирование.
• Гибкость — можно интегрировать с биллингом, уведомлениями, автоматической ротацией ключей.
• Независимость — вы не привязаны к панелям и API сторонних сервисов.

И главное — всё это работает на вашем личном VPS с технологией XHTTP + Reality, которая делает ваш трафик невидимым для DPI. В отличие от массовых VPN, где ваш IP делят тысячи людей, вы получаете персональный канал, который в 1000 раз сложнее заблокировать.