mirror of
https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot.git
synced 2026-04-26 16:05:22 +00:00
313 lines
15 KiB
Markdown
313 lines
15 KiB
Markdown
<div align="center">
|
||
|
||
<img src=".github/assets/logo.png" alt="Bedolaga Bot" width="800" />
|
||
|
||
# Bedolaga Bot
|
||
|
||
**Telegram-бот для автоматизации VPN-бизнеса на базе [Remnawave](https://github.com/remnawave/backend)**
|
||
|
||
Принимает оплату, выдаёт подписки, управляет пользователями — пока вы спите.
|
||
|
||
[](https://python.org)
|
||
[](https://postgresql.org)
|
||
[](https://docs.bedolagam.ru/getting-started/docker-deployment)
|
||
[](LICENSE)
|
||
|
||
[📖 Документация](https://docs.bedolagam.ru) · [🤖 Тестировать бота](https://t.me/zero_ping_vpn_bot?start=Git) · [💬 Чат сообщества](https://t.me/+wTdMtSWq8YdmZmVi)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 🧩 Что такое Bedolaga?
|
||
|
||
Bedolaga — полнофункциональная платформа для продажи VPN-подписок через Telegram. Бот интегрируется с панелью [Remnawave](https://github.com/remnawave/backend) и берёт на себя весь цикл: от регистрации пользователя до автопродления подписки.
|
||
|
||
> 🖥 **[Bedolaga Cabinet](https://github.com/BEDOLAGA-DEV/bedolaga-cabinet)** — веб-кабинет на React + TypeScript, который существенно расширяет возможности бота: личный кабинет, OAuth-авторизация (Google, Yandex, Discord, VK, Telegram OIDC), лендинги, аналитика продаж, RBAC и подарочные подписки.
|
||
|
||
<div align="center">
|
||
|
||
<img src=".github/assets/bot-preview.png" alt="Bedolaga Bot — Telegram" width="700" />
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ✨ Возможности
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
|
||
### 📦 Подписки и тарифы
|
||
|
||
- 🎯 Гибкие тарифные планы (от X дней до X дней)
|
||
- 📊 Трафик: безлимит, фиксированный лимит или пакеты с возможностью докупки
|
||
- 📱 Управление устройствами (1–20 на подписку) или отключение лимитов
|
||
- 🌍 Автовыбор сервера(Тарифы) или ручной выбор(Конфигуратор подписки - с возможностью докупки)
|
||
- 🆓 Пробный период(Возможен платный) с конвертацией в платный
|
||
- 🛒 Умная корзина — сохраняет выбор при недостатке баланса
|
||
- 🔄 Автопродление за 3 дня до окончания
|
||
- 🎁 Подарочные подписки и конфигурируемые лендинги для быстрой продажи в вебе без авторизации
|
||
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
|
||
### 💳 Платежи
|
||
|
||
- 🏦 **18 платёжных провайдеров** одновременно
|
||
- 💰 Единый баланс: пополнение любым способом → покупка с баланса
|
||
- ⚡ Автопокупка подписки после пополнения
|
||
- 💾 Рекуррентные платежи (сохранённые карты)
|
||
- 🧾 Фискализация через НалоGo (для самозанятых)
|
||
- 🔍 Автопроверка статуса платежей
|
||
- 🛍 Гостевые покупки через лендинги
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
|
||
### 📣 Маркетинг и продвижение
|
||
|
||
- 🏷 Промокоды (деньги, дни подписки, триалы)
|
||
- 👥 Реферальная программа с выводом средств
|
||
- 👥 Партнерская система
|
||
- 📨 Рассылки по сегментам пользователей
|
||
- 🌐 Кастомные лендинги с аналитикой
|
||
- 🎮 Конкурсы и ежедневные игры с призами
|
||
- 🎯 Персональные предложения и скидки
|
||
- 📈 Маркетинговые кампании с трекингом
|
||
- 🌐 Обязательная мультиподписка на каналы с возможностью автоотключения подписки - при отписки от канала
|
||
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
|
||
### 🛠 Администрирование
|
||
|
||
- 🤖 Панель управления прямо в Telegram
|
||
- 👤 Управление пользователями, подписками, платежами
|
||
- 📬 Уведомления в топики: покупки, продления, пополнения
|
||
- 💾 Автобэкапы БД с восстановлением из бота
|
||
- 🚧 Режим техработ (авто-детект недоступности панели)
|
||
- 📡 Мониторинг трафика и аномалий
|
||
- 🤝 Партнёрская программа
|
||
- 🔐 RBAC: роли и гранулярные права доступа
|
||
- 📈 Детальная отчетность с возможностью визуализации Реф сети
|
||
- 🔐 Блокировка юзеров из общего черного списка
|
||
И многое др...
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
---
|
||
|
||
## 💳 Платёжные провайдеры
|
||
|
||
<div align="center">
|
||
|
||
| | Провайдер | Методы оплаты | Валюта |
|
||
|:---:|:---|:---|:---:|
|
||
| ⭐ | **Telegram Stars** | Звёзды Telegram | XTR |
|
||
| 🏦 | **YooKassa** | Карты, СБП | RUB |
|
||
| 🏦 | **YooKassa СБП** | Система быстрых платежей | RUB |
|
||
| 🪙 | **CryptoBot** | USDT, TON, BTC, ETH | Crypto |
|
||
| 🪙 | **Heleket** | USDT, мульти-сеть | Crypto |
|
||
| 💳 | **CloudPayments** | Карты, 3D-Secure | RUB |
|
||
| 💳 | **Freekassa** | NSPK СБП, карты | RUB |
|
||
| 💳 | **Kassa AI** | СБП, карты, SberPay | RUB |
|
||
| 💳 | **PayPalych (Pal24)** | Карты, СБП | RUB |
|
||
| 🤝 | **[Platega](https://t.me/ArstanPlatega)** 🔸 | Карты, СБП, крипто | RUB |
|
||
| 🤝 | **[WATA](https://t.me/wyrz_wata)** 🔸 | СБП, Карты | RUB |
|
||
| 💳 | **MulenPay** | Карты | RUB |
|
||
| 💳 | **RioPay** | Карты | RUB |
|
||
| 💳 | **SeverPay** | СБП, карты | RUB |
|
||
| 🤝 | **[PayPear](https://t.me/Paymen1_Manager)** 🔸 | Карты, СБП, SberPay, T-Pay | RUB |
|
||
| 🤝 | **[RollyPay](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)** 🔸 | СБП, карты, крипто | RUB → USDT |
|
||
| 🤝 | **[AuraPay](https://aurapay.tech/)** 🔸 | Карты, СБП | RUB |
|
||
| 🤝 | **[Overpay](https://overpay.pro/)** 🔸 | Карты, СБП | RUB |
|
||
| 📲 | **Tribute** | Telegram-платежи | RUB |
|
||
|
||
</div>
|
||
|
||
> 🔸 — официальный партнёр Bedolaga (особые условия по кодовому слову **`bedolaga`**)
|
||
>
|
||
> Все провайдеры работают параллельно через единый веб-сервер на порту 8080. Подробная настройка — в [документации](https://docs.bedolagam.ru/bot/payments).
|
||
|
||
<div align="center">
|
||
<table>
|
||
<tr>
|
||
<td align="center">
|
||
|
||
<img src=".github/assets/platega-logo.jpg" alt="Platega" width="60" />
|
||
|
||
**🤝 Официальный партнёр Platega**
|
||
|
||
Bedolaga — официальный партнёр платёжной системы **Platega**.<br>
|
||
Пользователи бота получают **особые условия** при подключении по кодовому слову **`bedolaga`**
|
||
|
||
📩 По вопросам: [@ArstanPlatega](https://t.me/ArstanPlatega)
|
||
|
||
</td>
|
||
<td align="center">
|
||
|
||
<img src=".github/assets/wata-logo.jpg" alt="WATA" width="60" />
|
||
|
||
**🤝 Официальный партнёр WATA**
|
||
|
||
Bedolaga — официальный партнёр платёжной системы **WATA**.<br>
|
||
Пользователи бота получают **бесплатное подключение** по кодовому слову **`bedolaga`**
|
||
|
||
📩 По вопросам: [@wyrz_wata](https://t.me/wyrz_wata)
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">
|
||
|
||
**🤝 Официальный партнёр PayPear**
|
||
|
||
Bedolaga — официальный партнёр платёжной системы **[PayPear](https://paypear.ru)**.<br>
|
||
Банковские карты, СБП, SberPay и T-Pay — всё через единый API.<br>
|
||
Подключение по **спец. условиям** через кодовое слово **`БЕДОЛАГА`**
|
||
|
||
📩 Менеджер: [@Paymen1_Manager](https://t.me/Paymen1_Manager)
|
||
|
||
</td>
|
||
<td align="center">
|
||
|
||
**🤝 Официальный партнёр RollyPay**
|
||
|
||
Bedolaga — официальный партнёр платёжного шлюза **[RollyPay](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)**.<br>
|
||
СБП (от 5%), банковские карты РФ, крипто, вывод в USDT.<br>
|
||
Универсальная форма оплаты, высокая проходимость, стабильная работа в каскаде.<br>
|
||
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
||
|
||
📩 Менеджер: [@rollypay_manager](https://t.me/rollypay_manager) | 🌐 [rollypay.io](https://rollypay.io/?utm_source=bedolaga&utm_medium=community&utm_campaign=integration)
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center">
|
||
|
||
**🤝 Официальный партнёр AuraPay**
|
||
|
||
Bedolaga — официальный партнёр платёжной системы **[AuraPay](https://aurapay.tech/)**.<br>
|
||
Банковские карты и СБП через единый API с быстрой интеграцией.<br>
|
||
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
||
|
||
📩 Менеджер: [@kickdownm](https://t.me/kickdownm) | 🌐 [aurapay.tech](https://aurapay.tech/)
|
||
|
||
</td>
|
||
<td align="center">
|
||
|
||
**🤝 Официальный партнёр Overpay**
|
||
|
||
Bedolaga — официальный партнёр платёжного шлюза **[Overpay](https://overpay.pro/)**.<br>
|
||
Банковские карты и СБП, mTLS-авторизация, HPP-интеграция.<br>
|
||
Подключение по кодовому слову **`БЕДОЛАГА`** — **спец. условия**
|
||
|
||
📩 Менеджер: [@A_OverPay](https://t.me/A_OverPay) | 🌐 [overpay.pro](https://overpay.pro/)
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</div>
|
||
|
||
---
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
```bash
|
||
git clone https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot.git
|
||
cd remnawave-bedolaga-telegram-bot
|
||
cp .env.example .env # заполните переменные
|
||
docker compose up -d
|
||
```
|
||
|
||
📖 Подробнее: **[Развёртывание →](https://docs.bedolagam.ru/getting-started/docker-deployment)** · **[Переменные окружения →](https://docs.bedolagam.ru/getting-started/environment)**
|
||
|
||
---
|
||
|
||
## 🏗 Стек
|
||
|
||
| | Компонент | Технология |
|
||
|:---:|:---|:---|
|
||
| 🐍 | Язык | Python 3.13, полностью async |
|
||
| 🤖 | Telegram | aiogram 3.x |
|
||
| 🗄 | База данных | PostgreSQL + SQLAlchemy 2.x + Alembic |
|
||
| 🔴 | Кэш/очереди | Redis |
|
||
| ⚡ | Web-сервер | FastAPI (webhook, платежи, Cabinet API) |
|
||
| 📝 | Логирование | structlog |
|
||
| 🐳 | Контейнеризация | Docker + Docker Compose |
|
||
| 🧹 | Линтер | ruff |
|
||
|
||
---
|
||
|
||
## 🖥 Bedolaga Cabinet
|
||
|
||
<div align="center">
|
||
|
||
[](https://github.com/BEDOLAGA-DEV/bedolaga-cabinet)
|
||
|
||
<br>
|
||
|
||
<img src=".github/assets/cabinet-preview.png" alt="Bedolaga Cabinet" width="700" />
|
||
|
||
</div>
|
||
|
||
Веб-кабинет на **React + TypeScript**, существенно расширяющий возможности бота:
|
||
|
||
| | Возможность | Описание |
|
||
|:---:|:---|:---|
|
||
| 👤 | **Личный кабинет** | Подписки, баланс, устройства, реферальная программа |
|
||
| 🔑 | **OAuth-авторизация** | Google, Yandex, Discord, VK, Telegram OIDC |
|
||
| 🌐 | **Лендинги** | Кастомные страницы для привлечения клиентов |
|
||
| 📊 | **Админ-панель** | Аналитика продаж, RBAC, управление контентом |
|
||
| 🎁 | **Подарки** | Покупка и отправка подписок другим пользователям |
|
||
| 🔍 | **Поиск платежей** | Поиск по инвойсу, клиенту с фильтрами и статистикой |
|
||
|
||
---
|
||
|
||
## 📚 Документация
|
||
|
||
| | Раздел | Описание |
|
||
|:---:|:---|:---|
|
||
| 🚀 | [Быстрый старт](https://docs.bedolagam.ru/getting-started/quickstart) | Развёртывание за 5 минут |
|
||
| 💳 | [Настройка платежей](https://docs.bedolagam.ru/bot/payments) | 18 провайдеров, webhook, фискализация |
|
||
| 📦 | [Подписки и тарифы](https://docs.bedolagam.ru/bot/subscriptions) | Конфигурация планов и трафика |
|
||
| 👥 | [Реферальная программа](https://docs.bedolagam.ru/bot/referral-program) | Партнёрка и вывод средств |
|
||
| 🖥 | [Cabinet](https://docs.bedolagam.ru/cabinet/overview) | Настройка веб-кабинета |
|
||
| 🏷 | [Промо-система](https://docs.bedolagam.ru/bot/promo-system) | Промокоды, предложения, скидки |
|
||
| 🔌 | [API Reference](https://docs.bedolagam.ru/api-reference/overview) | REST API для внешних интеграций |
|
||
|
||
<div align="center">
|
||
|
||
**📖 Полная документация: [docs.bedolagam.ru](https://docs.bedolagam.ru)**
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 💬 Сообщество
|
||
|
||
<div align="center">
|
||
|
||
[](https://t.me/+wTdMtSWq8YdmZmVi)
|
||
[](https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot/issues)
|
||
|
||
</div>
|
||
|
||
- 🐛 **Баги и предложения** — [GitHub Issues](https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot/issues)
|
||
- 💬 **Вопросы и обсуждения** — [Telegram-чат](https://t.me/+wTdMtSWq8YdmZmVi)
|
||
- 🤖 **Тестирование** — [@zero_ping_vpn_bot](https://t.me/zero_ping_vpn_bot?start=Git)
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**[MIT License](LICENSE)** — используйте свободно для личных и коммерческих проектов.
|
||
|
||
</div>
|