Telegram-бот для VLESS-ключів на власному VPS

Telegram-бот для видачі VLESS-ключів на власному VPS автоматизує керування доступом до VPN, дозволяючи роздавати до 100+ конфігів родині чи невеликій команді без ручного налаштування кожного ключа, заощаджуючи до 3-5 годин на тиждень на адмініструванні та значно знижуючи ймовірність помилок.

Володіння власним VPN-сервером на VPS відкриває широкі можливості для забезпечення приватності та обходу блокувань. Однак, коли йдеться про надання доступу не лише собі, а й кільком друзям, родичам або колегам, ручне керування кожним ключем VLESS, лімітами трафіку та термінами дії стає рутиною. Саме тут на допомогу приходить Telegram-бот для видачі VPN-ключів. Він перетворює складний процес на пару кліків, значно спрощуючи адміністрування вашого сервера та роблячи його доступним навіть для тих, хто не має глибоких технічних знань.

Навіщо потрібен Telegram-бот для видачі VPN-ключів на власному VPS?

Основна причина використання бота для керування VPN-ключами — це автоматизація та масштабування. Уявіть, що вам потрібно надати доступ до VPN десяткам користувачів. Ручна генерація VLESS-ключів, встановлення лімітів за трафіком або часом, а потім індивідуальне надсилання кожного конфігу займає колосальну кількість часу. При цьому зростає ризик помилок та невідповідностей. Автоматична видача конфігів через Telegram-бота вирішує ці проблеми, дозволяючи зосередитися на важливіших завданнях, а не на рутинному адмініструванні.

Економія часу та зниження навантаження на адміністратора

Без бота кожен запит на новий ключ, продовження доступу або зміну ліміту вимагає від адміністратора ручного входу на сервер, роботи з панеллю керування (наприклад, Marzban або 3x-ui), генерації ключа та його надсилання користувачеві. В середньому, на один такий цикл йде від 5 до 15 хвилин, залежно від складності завдання та досвіду адміністратора. За наявності 20-30 активних користувачів та періодичних запитів, це може забирати кілька годин на тиждень. Бот же виконує ці операції миттєво, 24/7, без участі людини. Це особливо актуально для тих, хто надає VPN-доступ як сервіс або для великої команди, де потрібне оперативне керування доступом.

Зручність для користувачів та централізоване керування

Для кінцевих користувачів отримання VLESS-ключа через Telegram-бота — це максимально простий та інтуїтивно зрозумілий процес. Достатньо надіслати команду боту, і через кілька секунд вони отримують готовий конфіг або посилання на нього. Немає необхідності зв'язуватися з адміністратором, чекати відповіді або розбиратися у складних інструкціях. Всі ключі, їхні статуси, ліміти та терміни дії зберігаються в єдиній базі даних бота, що забезпечує централізоване керування. Адміністратор може в будь-який момент переглянути список активних користувачів, їхнє споживання трафіку, термін дії підписки, а також виконати продовження, блокування або відкликання ключа.

Для тих, хто тільки починає свій шлях у світі самостійного VPN, рекомендуємо ознайомитися з нашим повним посібником з VPN на власному VPS, який допоможе закласти міцний фундамент.

Як працюють боти для автоматичної видачі VLESS-конфігів?

Принцип роботи Telegram-бота для VPN-ключів базується на взаємодії з API панелі керування VPN-сервером. Більшість сучасних панелей, таких як Marzban або 3x-ui, надають API, через який можна програмно керувати користувачами, генерувати ключі, встановлювати ліміти та отримувати статистику. Бот виступає в ролі посередника: він приймає команди від користувача в Telegram, перетворює їх на запити до API панелі керування VPN, отримує відповідь та форматує її для надсилання назад користувачеві.

Архітектура взаємодії: Telegram API та VPN-панель API

Типова архітектура включає кілька ключових компонентів:

1. Telegram Bot API: Бот реєструється в Telegram через BotFather, отримує унікальний токен. Через цей API бот приймає повідомлення від користувачів та надсилає їм відповіді.
2. Сервер, на якому запущено бота: Це ваш VPS, де встановлено інтерпретатор Python (або інша мова програмування), бібліотеки для роботи з Telegram API та VPN-панеллю API, а також сам код бота.
3. Панель керування VPN: Наприклад, Marzban або 3x-ui, яка встановлена на тому ж або іншому VPS. Вона керує Xray-сервером та надає HTTP API для взаємодії.
4. База даних бота: Зазвичай SQLite, PostgreSQL або MongoDB, де зберігається інформація про користувачів Telegram, прив'язані до них VLESS-ключі, їхні статуси, терміни дії, ліміти та інші налаштування. Це дозволяє боту "пам'ятати" стан та керувати підписками.

Коли користувач надсилає команду, наприклад, /get_key, бот обробляє її, звертається до панелі VPN через API (наприклад, POST /api/user для створення нового користувача), отримує VLESS-конфіг, зберігає інформацію про нього у своїй БД та надсилає конфіг користувачеві в Telegram.

Життєвий цикл VLESS-ключа, керованого ботом

• Запит: Користувач надсилає команду боту (наприклад, /start, /get_trial).
• Генерація: Бот, після перевірки прав або оплати, звертається до API VPN-панелі для створення нового користувача із заданими параметрами (протокол VLESS, ліміти, термін дії).
• Видача: Отриманий VLESS-ключ або посилання на підписку бот надсилає користувачеві в Telegram. Інформація про виданий ключ (ID користувача Telegram, ID ключа в панелі, дата видачі, термін дії, трафік) зберігається в базі даних бота.
• Моніторинг: Бот періодично може запитувати у панелі VPN статистику за трафіком для кожного ключа або перевіряти термін дії, що залишився.
• Продовження: Користувач надсилає команду на продовження. Бот оновлює термін дії або ліміти через API VPN-панелі та оновлює свою БД.
• Відкликання/Блокування: Адміністратор або користувач (якщо така функція передбачена) може відкликати або заблокувати ключ. Бот надсилає запит до API VPN-панелі на видалення або деактивацію користувача та оновлює свою базу.

Популярні рішення: боти для Marzban та 3x-ui

На ринку існує кілька готових рішень та фреймворків для створення бота керування VPN-сервером. Серед них виділяються проєкти, орієнтовані на популярні панелі Marzban та 3x-ui, які стали де-факто стандартами для розгортання багатокористувацьких VPN на базі Xray/VLESS. Ці панелі надають зручний веб-інтерфейс та потужний API, що робить їх ідеальною основою для автоматизації.

Бот для Marzban: розширені можливості керування

Marzban — це потужна панель керування Xray, яка пропонує широкий спектр функцій для створення та керування VLESS, VMess, Trojan та Shadowsocks проксі. Вона має добре документований API, що дозволяє легко інтегрувати з нею Telegram-ботів. Існує кілька відкритих проєктів, які пропонують готові рішення або шаблони для створення бота для Marzban. Такі боти зазвичай підтримують:

• Автоматичну генерацію VLESS-ключів із заданими параметрами (швидкість, трафік, термін дії).
• Керування користувачами: створення, зміна, видалення, блокування.
• Видачу пробного доступу з обмеженим терміном або трафіком.
• Продовження підписок та зміну лімітів.
• Отримання статистики за використанням трафіку для кожного користувача.
• Підтримку кількох протоколів та портів.
• Інтеграцію з платіжними системами для автоматичної видачі VPN-підписок.

Приклад запиту до API Marzban для створення користувача:

POST /api/user
Authorization: Bearer YOUR_MARZBAN_API_TOKEN
Content-Type: application/json

{
    "username": "user_telegram_id",
    "data_limit": 10737418240, // 10 GB in bytes
    "expire": 1678886400, // Unix timestamp for expiration
    "inbounds": {
        "vless": {
            "flow": "xtls-rprx-vision"
        }
    }
}

Докладніше про саму панель можна дізнатися у статті Marzban на VPS: встановлення панелі Xray та багатокористувацький доступ.

Бот для 3x-ui: простота та функціональність

3x-ui — це ще одна популярна панель керування Xray, відома своєю простотою встановлення та використання. Вона також надає API, хоча й менш обширний, ніж у Marzban, але достатній для базових операцій з керування ключами VLESS. Боти для 3x-ui зазвичай фокусуються на таких функціях:

• Генерація VLESS-ключів.
• Встановлення та зміна лімітів трафіку.
• Встановлення та зміна термінів дії.
• Отримання списку користувачів та їхніх статусів.
• Видалення користувачів.

Завдяки своїй легкості та простоті, 3x-ui часто вибирають для невеликих проєктів або індивідуального використання, де не потрібна складна білінгова система. Бот для 3x-ui може бути реалізований з мінімальною кількістю коду, що робить його чудовим вибором для тих, хто хоче швидко запустити систему автовидачі. Керування лімітами трафіку та квотами для користувачів у 3x-ui та Marzban — важливий аспект, про який можна прочитати тут: Ліміти та квоти користувачам у 3x-ui та Marzban.

Встановлення та налаштування Telegram-бота для VPN-ключів на власному VPS

Розгортання Telegram-бота для VPN-ключів на власному VPS — це ключовий крок до повної автоматизації керування VPN-доступом. Процес включає кілька етапів: підготовка VPS, встановлення необхідних залежностей, розгортання коду бота та його запуск. Для прикладу розглянемо типове встановлення бота на Python, який взаємодіє з Marzban API.

Підготовка VPS та встановлення залежностей

Перш ніж розгортати бота, переконайтеся, що ваш VPS відповідає мінімальним вимогам (зазвичай 1 vCPU, 512 MB RAM, 10 GB диска для самого бота, не враховуючи VPN-сервера). На VPS повинна бути встановлена операційна система на базі Linux (наприклад, Ubuntu 20.04+ або Debian 11+). Вам знадобиться Python 3.8+ та pip.

# Оновлення системи
sudo apt update && sudo apt upgrade -y

# Встановлення Python3 та pip
sudo apt install python3 python3-pip -y

# Створення віртуального оточення (рекомендується)
mkdir ~/vpn_bot && cd ~/vpn_bot
python3 -m venv venv
source venv/bin/activate

# Встановлення бібліотек для бота (приблизно)
pip install python-telegram-bot requests SQLAlchemy

Також необхідно отримати API-токен вашого Telegram-бота через BotFather та API-токен вашої панелі Marzban/3x-ui (зазвичай генерується в налаштуваннях панелі).

Конфігурація та запуск бота

Після встановлення залежностей, вам потрібно буде налаштувати бота. Це зазвичай робиться через файл конфігурації (наприклад, config.ini або config.py), де вказуються такі параметри:

• TELEGRAM_BOT_TOKEN: Токен, отриманий від BotFather.
• MARZBAN_API_URL або 3XUI_API_URL: Адреса вашої панелі API (наприклад, https://your_marzban_ip:8000/api).
• MARZBAN_API_TOKEN або 3XUI_API_TOKEN: API-токен для авторизації на панелі.
• ADMIN_TELEGRAM_ID: Ваш Telegram ID для отримання сповіщень та адміністрування бота.
• Налаштування бази даних (наприклад, шлях до файлу SQLite).

Приклад файлу config.py:

# config.py
TELEGRAM_BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
MARZBAN_API_URL = "https://your_marzban_domain_or_ip:8000/api"
MARZBAN_API_TOKEN = "YOUR_MARZBAN_JWT_TOKEN"
ADMIN_TELEGRAM_ID = [123456789, 987654321] # Список ID адміністраторів
DATABASE_URL = "sqlite:///bot_database.db"

Після збереження конфігурації, ви можете запустити бота. Для стабільної роботи рекомендується використовувати systemd для автоматичного запуску та перезапуску бота.

# Приклад systemd service файлу: /etc/systemd/system/vpn_bot.service
[Unit]
Description=Telegram VPN Bot
After=network.target

[Service]
User=your_user
WorkingDirectory=/home/your_user/vpn_bot
ExecStart=/home/your_user/vpn_bot/venv/bin/python /home/your_user/vpn_bot/main.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

# Активація та запуск сервісу
sudo systemctl daemon-reload
sudo systemctl enable vpn_bot
sudo systemctl start vpn_bot
sudo systemctl status vpn_bot

Функціонал бота: від пробного доступу до відкликання ключа

Сучасний Telegram-бот для VPN-ключів має багатий функціонал, який дозволяє повністю автоматизувати процес керування доступом до VPN. Це не просто видача ключів, а й цілий спектр можливостей для гнучкого контролю над підписками.

Керування підписками: пробний доступ, продовження, ліміти

Однією з найзатребуваніших функцій є можливість надання пробного доступу. Це дозволяє новим користувачам протестувати VPN-сервіс перед повноцінною підпискою. Бот може автоматично видавати VLESS-ключі з обмеженим терміном дії (наприклад, на 3 дні) або лімітом трафіку (наприклад, 1 GB). Після закінчення пробного періоду бот може повідомити користувача та запропонувати придбати повноцінну підписку.

• Видача пробного доступу: Команда /trial генерує ключ на 1-3 дні з лімітом 1-5 GB.
• Продовження підписки: Користувачі можуть продовжити свій доступ, вибравши тарифний план через бота. Бот оновлює термін дії та ліміти трафіку для відповідного ключа через API панелі.
• Встановлення лімітів трафіку: Для кожного користувача можна встановити індивідуальні ліміти за трафіком (наприклад, 50 GB/місяць) та швидкістю. Бот відстежуватиме споживання та при досягненні ліміту автоматично блокуватиме доступ або знижуватиме швидкість.
• Встановлення лімітів за часом: Крім трафіку, можна задавати термін дії підписки (наприклад, 30 днів). Бот автоматично деактивує ключ після закінчення терміну.

Ця гнучкість дозволяє адміністратору створювати різноманітні тарифні плани та ефективно керувати ресурсами сервера.

Відкликання ключа та керування активними сесіями

Можливість відкликати ключ або заблокувати доступ користувача вкрай важлива для безпеки та контролю. Бот повинен надавати адміністратору зручний інтерфейс для виконання цих операцій:

• Відкликання ключа: Адміністратор може надіслати команду боту (наприклад, /revoke user_id), щоб негайно деактивувати VLESS-ключ користувача. Це корисно, якщо користувач порушує правила використання або підписка була скасована.
• Блокування/розблокування: Тимчасове блокування доступу без повного видалення ключа. Наприклад, якщо користувач перевищив ліміт, його можна тимчасово заблокувати до продовження підписки.
• Перегляд активних сесій: Деякі боти можуть відображати інформацію про активні підключення до VPN-сервера для кожного ключа, дозволяючи адміністратору бачити, хто в даний момент використовує VPN.

Крім цього, бот може бути налаштований на автоматичне сповіщення користувачів про наближення закінчення терміну дії підписки або вичерпання трафіку, що значно покращує користувацький досвід та знижує кількість запитань до адміністратора.

Для глибшого розуміння, як автоматизувати видачу та керування ключами, може бути корисною стаття про власну підписку для VLESS на VPS, яка зачіпає питання автооновлення конфігів.

Оптимальні ресурси для бота керування VPN-сервером

Однією зі значних переваг запуску бота керування VPN-сервером є його низьке споживання ресурсів. У більшості випадків бот може спокійно співіснувати на тому ж VPS, що й сам VPN-сервер, не впливаючи помітно на його продуктивність. Це дозволяє оптимізувати витрати на хостинг, використовуючи один сервер для кількох завдань.

Чому бот спокійно живе на тому ж сервері, що й VPN?

Telegram-боти, особливо ті, що написані на Python, є легковажними додатками. Вони більшу частину часу перебувають у режимі очікування, споживаючи мінімальні ресурси CPU та RAM. Активність бота проявляється лише в момент обробки запитів від користувачів або виконання періодичних завдань (наприклад, перевірка підписок, що закінчуються). Ці операції зазвичай займають частки секунди і не створюють значного навантаження. Сам VPN-сервер (Xray) є набагато більш ресурсомістким компонентом, споживаючи CPU та мережевий трафік залежно від кількості активних користувачів та їхньої активності.

Основні причини низького споживання ресурсів ботом:

• Подієво-орієнтована архітектура: Бот активується лише при отриманні повідомлення або за таймером.
• Мінімальні дискові операції: База даних бота (часто SQLite) невелика і рідко оновлюється.
• Низьке навантаження на CPU: Обробка команд та запитів до API панелей не вимагає інтенсивних обчислень.
• Незначне споживання RAM: Для більшості ботів достатньо 50-100 MB оперативної пам'яті.

Таблиця: Рекомендації щодо VPS для VPN-сервера з ботом

Для 50 одночасних користувачів достатньо 4 vCPU, 8 GB RAM та NVMe-диска на 80 GB.

Як видно з таблиці, навіть для значної кількості користувачів VPN, вимоги до VPS залишаються досить помірними. Бот, що працює на Python, займе лише малу частину цих ресурсів, що робить його спільне розміщення з VPN-сервером економічно вигідним рішенням. Важливо вибирати VPS зі швидким диском (NVMe) та достатнім обсягом оперативної пам'яті для комфортної роботи VPN та панелі керування.

Безпека та зберігання даних: резервне копіювання бази даних бота

Безпека даних та надійність роботи Telegram-бота для видачі VPN-ключів є критично важливими аспектами. Неправильне зберігання конфіденційної інформації або відсутність резервного копіювання може призвести до витоку даних користувачів, втрати інформації про підписки або повної непрацездатності сервісу.

Захист API-токенів та конфіденційних даних

Найбільш чутливими даними є API-токен Telegram-бота та API-токен панелі керування VPN (Marzban/3x-ui). Ці токени дають повний контроль над ботом та VPN-сервером відповідно. Дотримуйтесь цих рекомендацій:

1. Не зберігайте токени у відкритому доступі: Ніколи не коммітьте токени у публічні репозиторії Git. Використовуйте змінні оточення або захищені файли конфігурації (наприклад, .env файл, який ігнорується Git).
2. Обмежте доступ до файлів конфігурації: Переконайтеся, що лише користувач, від імені якого запущено бота, має права на читання файлу конфігурації.
3. Використовуйте HTTPS для API панелі: Якщо панель керування VPN доступна по HTTP, налаштуйте Nginx або інший реверс-проксі для роботи по HTTPS, щоб захистити передачу даних між ботом та панеллю.
4. Налаштуйте брандмауер: Обмежте доступ до портів API панелі керування VPN лише з IP-адреси вашого VPS, де запущено бота.
5. Регулярно оновлюйте залежності: Своєчасне оновлення Python, бібліотек та самого коду бота допоможе закрити відомі вразливості.

Зберігання стану та резервне копіювання бази даних бота

Бот зберігає важливу інформацію про користувачів, їхні підписки, терміни дії та використаний трафік у своїй базі даних. Втрата цієї бази даних означає втрату всіх даних про підписки та необхідність відновлювати все вручну. Тому регулярне резервне копіювання бази даних бота є обов'язковим.

Якщо бот використовує SQLite (найпоширеніший варіант для невеликих проєктів), база даних зберігається в одному файлі (наприклад, bot_database.db). Для резервного копіювання достатньо скопіювати цей файл у безпечне місце.

# Приклад скрипту для резервного копіювання SQLite бази даних
#!/bin/bash
DB_PATH="/home/your_user/vpn_bot/bot_database.db"
BACKUP_DIR="/home/your_user/backups/vpn_bot_db"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_FILE="${BACKUP_DIR}/bot_database_${TIMESTAMP}.db"

mkdir -p $BACKUP_DIR
cp $DB_PATH $BACKUP_FILE

# Видалення старих резервних копій (залишити 7 останніх)
find $BACKUP_DIR -name "bot_database_*.db" -mtime +7 -delete

echo "Backup created: $BACKUP_FILE"

Цей скрипт можна налаштувати для запуску за розкладом через cron (наприклад, щодня о 3 годині ночі).

# Додавання завдання до crontab
crontab -e
# Додати рядок:
0 3 * * * /bin/bash /home/your_user/vpn_bot/backup_script.sh >> /var/log/vpn_bot_backup.log 2>&1

Для більш надійного зберігання рекомендується використовувати віддалені сховища (S3-сумісні сервіси, Google Drive, Dropbox) або інші VPS для зберігання резервних копій. Докладніше про резервне копіювання можна дізнатися у статті Автоматичне резервне копіювання конфігів VPN з VPS.

Часті запитання

Тут ми зібрали відповіді на найчастіші запитання, що стосуються використання Telegram-бота для видачі VLESS-ключів.

Чи можна використовувати одного бота для кількох VPN-серверів?

Так, цілком можливо. Якщо бот розроблений з підтримкою мультисерверної архітектури, він може керувати кількома панелями Marzban або 3x-ui, розташованими на різних VPS. Це зручно для балансування навантаження або надання доступу до VPN-серверів у різних географічних локаціях. Зазвичай це вимагає додаткових налаштувань у конфігурації бота, де вказуються API-токени та адреси всіх керованих панелей. Деякі проєкти дозволяють прив'язувати користувача до конкретного сервера або автоматично вибирати менш завантажений.

Які мови програмування використовуються для створення таких ботів?

Найпопулярнішою мовою для розробки Telegram-ботів є Python, завдяки його простоті та великим бібліотекам, таким як python-telegram-bot і requests. Однак, боти можуть бути написані й іншими мовами, включаючи Node.js (з бібліотеками на кшталт node-telegram-bot-api), Go, PHP або Ruby. Вибір мови часто залежить від уподобань розробника, специфіки використовуваних VPN-панелей та наявності готових SDK для їх API. Python займає близько 70% від усіх ботів.

Чи потрібна виділена IP-адреса для роботи бота?

Для роботи самого Telegram-бота виділена IP-адреса не потрібна. Бот взаємодіє з Telegram API та VPN-панеллю через вихідні HTTPS-з'єднання. Однак, для роботи самого VPN-сервера (Marzban, 3x-ui, Xray) виділена публічна IP-адреса на вашому VPS є обов'язковою умовою. Це гарантує, що користувачі зможуть підключитися до вашого VPN-сервісу з будь-якої точки інтернету, що є критично важливим для його функціонування.

Скільки коштує VPS для запуску VPN та бота?

Вартість VPS для запуску VPN-сервера та бота може варіюватися від $5 до $80+ на місяць. Для 10-15 користувачів достатньо VPS з 1-2 vCPU, 1-2 GB RAM та 20-40 GB NVMe-диска, що обійдеться в $5-10/місяць. Для 50-100 користувачів знадобиться сервер з 4-6 vCPU, 8-16 GB RAM та 80+ GB NVMe-диска, вартістю $40-80/місяць. Бот при цьому споживає мінімальні ресурси, практично не впливаючи на загальну вартість хостингу.

Висновки

Використання Telegram-бота для видачі VLESS-ключів на власному VPS — це не просто зручність, а ефективний інструмент для автоматизації та масштабування керування VPN-доступом. Він значно скорочує час на адміністрування, спрощує процес для кінцевих користувачів та забезпечує централізований контроль над підписками. Рекомендуємо впровадити таке рішення, особливо якщо ви керуєте доступом для більш ніж 5-10 користувачів, щоб оптимізувати ресурси та підвищити загальну ефективність вашого VPN-сервісу.