Telegram Bot Vpn Definition buy v.1.0.11
README.md - Telegram VPN Bot
📋 Проект
Telegram бот для управления VPN подписками с поддержкой протоколов VLESS и Shadowsocks. Бот предоставляет полный функционал для администрирования, управления пользователями, тарифами, серверами и платежами.
🚀 Основные возможности
Для пользователей:
· 🔑 Регистрация и авторизация в Telegram · 📱 Покупка VPN подписок (VLESS/Shadowsocks) · 🎁 Пробный период · 💳 Оплата через YooKassa и CryptoPay · 👤 Личный кабинет с управлением подписками · 🔄 Смена сервера для активных ключей · 📊 Статистика использования · 🎰 Участие в розыгрышах · 🤝 Реферальная программа · 💰 Внутренний баланс и переводы
Для администраторов:
· 🖥️ Управление серверами (добавление/удаление) · 📦 Управление тарифами · 👥 Управление пользователями (бан/разбан) · 💰 Управление балансами пользователей · 🎁 Управление промокодами · 📨 Рассылка уведомлений · 🎰 Создание и управление розыгрышами · 📊 Статистика и мониторинг
🛠️ Технический стек
Основные технологии:
· Python 3.11+ · Aiogram 3.x - фреймворк для Telegram ботов · aiosqlite - асинхронная работа с SQLite · loguru - логирование · aiohttp - асинхронные HTTP запросы · py3xui - работа с 3x-ui панелью
Интеграции:
· 🤖 Telegram Bot API · 💳 YooKassa API · ₿ CryptoPay API (через @CryptoBot) · 📡 3x-ui панель управления
📁 Структура проекта
project/
├── main.py # Главный файл запуска
├── handlers/ # Обработчики команд
│ ├── admin/ # Административные обработчики
│ │ ├── admin.py
│ │ ├── admin_users.py
│ │ ├── admin_server_add.py
│ │ └── ...
│ └── user/ # Пользовательские обработчики
│ ├── user_lk.py
│ ├── user_pay.py
│ └── ...
├── instance/ # База данных
│ └── main.db
├── handlers/
│ ├── database.py # Работа с БД
│ ├── x_ui.py # Работа с 3x-ui (VLESS)
│ ├── x_ui_ss.py # Работа с 3x-ui (Shadowsocks)
│ ├── crypto_pay.py # CryptoPay интеграция
│ └── key_manager.py # Управление ключами
└── requirements.txt # Зависимости🗄️ База данных
Основные таблицы:
· id, telegram_id, username, balance, referral_code, referred_by
· id, user_id, tariff_id, server_id, end_date, vless, is_active
· id, name, price, days, inbound_id, protocol
· id, name, url, port, username, password, inbound_id, protocol
· id, code, discount, tariff_id, expires_at
· id, name, description, status, end_date
⚙️ Установка и запуск
bashgit clone https://github.com/yourusername/vpn-bot.git cd vpn-bot
bashpip install -r requirements.txt
Создайте файл .env в корне проекта:
envBOT_TOKEN=your_bot_token_here ADMIN_IDS=admin_telegram_id1,admin_telegram_id2 YOOKASSA_SHOP_ID=your_shop_id YOOKASSA_SECRET_KEY=your_secret_key CRYPTOPAY_TOKEN=your_cryptopay_token
bashpython -c "from handlers.database import db; import asyncio; asyncio.run(db.init_db())"
bashpython main.py
🔧 Настройка серверов
Для работы бота необходимо настроить сервера с 3x-ui панелью:
Требования к серверу:
Добавление сервера через бота:
· Название сервера · URL (например: example.com) · Порт (например: 443) · Username и Password от 3x-ui · Secret path (например: /panel) · ID Inbound
💳 Настройка платежей
YooKassa:
CryptoPay:
📝 Команды бота
Пользовательские:
· /start - Главное меню · /profile - Личный кабинет · /tariffs - Список тарифов · /help - Помощь · /support - Техподдержка · /balance - Баланс · /referral - Реферальная программа
Административные:
· /admin - Панель администратора · /stats - Статистика · /notify - Рассылка
🔒 Безопасность
· Все API ключи хранятся в переменных окружения · Используется SSL/TLS для подключения к серверам · Валидация входящих данных · Защита от SQL инъекций через параметризованные запросы · Аутентификация администраторов по Telegram ID
📈 Мониторинг и логи
· Логирование всех действий через loguru · Ошибки записываются с полным стектрейсом · Статистика использования в реальном времени · Отслеживание активности пользователей
🤝 Вклад в проект
📄 Лицензия
Проект распространяется под лицензией MIT. См. файл LICENSE для деталей.
📞 Контакты
· Разработчик: [Ваше имя] · Telegram: [@yourusername] · Email: your.email@example.com
🙏 Благодарности
· Aiogram - за отличный фреймворк · 3x-ui - за панель управления · YooKassa - за платежную систему
⭐ Не забудьте поставить звезду, если проект вам полезен!
0 Comments