🤖 Современный Telegram-бот для управления VPN подписками через Remnawave API
Полнофункциональное решение с управлением пользователями, платежами и администрированием
🚀 Быстрый старт • 📖 Функционал • Docker • 💻 Локальная разработка • 💬 Поддержка
💬 Bedolaga Chat - Для общения, вопросов, предложений
Бот Бедолага не добрый и не милый. Он просто делает вашу работу вместо вас, принимает оплату, выдаёт подписки, интегрируется с Remnawave и тихо ненавидит всех, кто ещё не подключил его.
Вы хотите продавать VPN — Бедолага позволит это делать. Вы хотите спать — он позволит и это.
- 🎯 Готовое решение - разверни за 5 минут, начни продавать сегодня
- 💰 Многоканальные платежи - Telegram Stars + Tribute + CryptoBot + Heleket + YooKassa (СБП + карты) + MulenPay + PayPalych (СБП + карты) + Platega (карты + СБП) + WATA
- 🔄 Автоматизация 99% - от регистрации до продления подписок
- 📱 MiniApp лк - личный кабинет с возможностью покупки/продления подписки
- 📊 Детальная аналитика - полная картина вашего бизнеса
- 💬 Уведомления в топики об: Активация триала 💎 Покупка подписки 🔄 Конверсия из триала в платную ⏰ Продление подписки 💰 Пополнение баланса 🚧 Включении тех работ ♻️ Появлении новой версии бота
- 🌐 Умный выбор серверов - автоматический пропуск при одном сервере, мультивыбор
- 📱 Управление устройствами - от 1 до неограниченного количества
- 📊 Режимы продажи трафика - фиксированный лимит или выбор пакетов
- 🎁 Промо-система - коды на деньги, дни подписки, триал-периоды
- 🔧 Гибкие тарифы - от 5GB до безлимита, от 14 дней до года
- 🛒 Умная корзина - сохранение параметров подписки при недостатке баланса
- 🗃️ Современная архитектура - AsyncIO, PostgreSQL, Redis, модульная структура
- 🔒 Безопасность - интеграция с системой защиты панели через куки-аутентификацию
- 📈 Масштабируемость - от стартапа до крупного бизнеса
- 🔧 Мониторинг - автоматическое управление режимом тех. работ
- 🛡️ Защита панели - поддержка remnawave-reverse-proxy
- 🗄️ Бекапы/Восстановление - автобекапы и восстановление бд прямо в боте с уведомлениями в топики
- ✔️ Проверка на подписку - проверяет подписку на канал
- 🔄 Автосинхронизация - фоновая синхронизация подписок и серверов(сквадов) с Remnawave по расписанию
| Метод | Заголовок | Описание |
|---|---|---|
| API Key | X-Api-Key: your_api_key | Стандартный API ключ |
| Bearer Token | Authorization: Bearer token | Классический Bearer token |
| Basic Auth | X-Api-Key: Basic base64(user:pass) | Basic Authentication |
| eGames Cookies | Cookies в формате key:value | Для панелей eGames |
# 1. Скачай репозиторий
git clone https://github.com/Fr1ngg/remnawave-bedolaga-telegram-bot.git
cd remnawave-bedolaga-telegram-bot
# 2. Создай необходимые директории
mkdir -p ./logs ./data ./data/backups ./data/referral_qr
chmod -R 755 ./logs ./data
sudo chown -R 1000:1000 ./logs ./data
# 3.Установи «Docker» командой:
sudo curl -fsSL https://get.docker.com | sh
# 4.Установи «make» следующей командой:
apt install make -y
make up # Поднять контейнеры
make help # Показать все команды
make down # Остановить контейнеры
make reload # Перезапустить
make reload-follow # Перезапустить с логами
make test # Запустить тестыЕсли не хочется пользоваться мастером, можно настроить всё вручную:
# 1. Скачай репозиторий
git clone https://github.com/Fr1ngg/remnawave-bedolaga-telegram-bot.git
cd remnawave-bedolaga-telegram-bot
# 2. Настрой конфиг
cp .env.example .env
nano .env # Заполни токены и настройки
# 3. Создай необходимые директории
mkdir -p ./logs ./data ./data/backups ./data/referral_qr
chmod -R 755 ./logs ./data
sudo chown -R 1000:1000 ./logs ./data
# 4. Запусти всё разом
docker compose up -d
# 5. Проверь статус
docker compose logsВстроенный FastAPI-сервер обслуживает Telegram webhook, платежные webhooks, административное API и статические файлы миниапки на одном порту 8080. Снаружи вы публикуете только HTTPS-прокси, которое проксирует весь трафик на этот порт.
BOT_RUN_MODE |
Что делает | Когда использовать |
|---|---|---|
polling |
Бот опрашивает Telegram через long polling. HTTP-сервер можно не поднимать. | Локальная отладка или отсутствие внешнего HTTPS. |
webhook |
Aiogram получает апдейты только через вебхук. | Продакшн и серверы за HTTPS-прокси. |
both |
Одновременно работают polling и webhook. | Тестирование или повышенная отказоустойчивость. |
Для запуска бота в режиме webhook минимально необходимы следующие параметры в .env:
# Обязательные базовые настройки
BOT_TOKEN=1234567890:AABBCCdd...
ADMIN_IDS=123456789,987654321
# Настройки webhook
BOT_RUN_MODE=webhook
WEBHOOK_URL=https://hooks.domain.com
WEBHOOK_PATH=/webhook
WEBHOOK_SECRET_TOKEN=super-secret-token
# Настройки Web API
WEB_API_ENABLED=true
WEB_API_PORT=8080
WEB_API_ALLOWED_ORIGINS=https://miniapp.example.com
WEB_API_DEFAULT_TOKEN=super-secret-token
# Настройки Remnawave
REMNAWAVE_API_URL=https://your-panel.com
REMNAWAVE_API_KEY=your_api_keyВажно:
WEBHOOK_SECRET_TOKEN- сгенерируйте командойopenssl rand -hex 32WEB_API_DEFAULT_TOKEN- сгенерируйте командойopenssl rand -hex 32WEBHOOK_URLдолжен быть доступен извне по HTTPSWEB_API_ALLOWED_ORIGINS- укажите домен, где будет размещена миниапка
BOT_RUN_MODE=webhook
WEBHOOK_URL=https://api.domain.com
WEBHOOK_PATH=/webhook
WEBHOOK_SECRET_TOKEN=super-secret-token
WEBHOOK_DROP_PENDING_UPDATES=true
WEBHOOK_MAX_QUEUE_SIZE=1024
WEBHOOK_WORKERS=4
WEBHOOK_ENQUEUE_TIMEOUT=0.1
WEBHOOK_WORKER_SHUTDOWN_TIMEOUT=30.0
WEB_API_ENABLED=true
WEB_API_HOST=0.0.0.0
WEB_API_PORT=8080
WEB_API_ALLOWED_ORIGINS=https://bot.example.com
MINIAPP_CUSTOM_URL=https://bot.example.com/miniappWEBHOOK_URL— публичный HTTPS-домен прокси. К нему автоматически добавится путь изWEBHOOK_PATH.WEBHOOK_SECRET_TOKEN— защитный токен Telegram, обязательно задайте своё значение.- Очередь можно тюнить через
WEBHOOK_MAX_QUEUE_SIZE,WEBHOOK_WORKERS,WEBHOOK_ENQUEUE_TIMEOUTиWEBHOOK_WORKER_SHUTDOWN_TIMEOUT. - Если миниапка или админка доступны по другим доменам, перечислите их через запятую в
WEB_API_ALLOWED_ORIGINS.
После изменения .env перезапустите сервис: docker compose up -d remnawave_bot.
Если бот запускается на отдельном сервере (не там, где панель Remnawave), используйте стандартную конфигурацию:
docker-compose.yml бота:
services:
postgres:
image: postgres:15-alpine
container_name: remnawave_bot_db
restart: unless-stopped
environment:
POSTGRES_DB: ${POSTGRES_DB:-remnawave_bot}
POSTGRES_USER: ${POSTGRES_USER:-remnawave_user}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-secure_password_123}
POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=C"
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- bot_network
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-remnawave_user} -d ${POSTGRES_DB:-remnawave_bot}"]
interval: 30s
timeout: 5s
retries: 5
start_period: 30s
redis:
image: redis:7-alpine
container_name: remnawave_bot_redis
restart: unless-stopped
command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
volumes:
- redis_data:/data
networks:
- bot_network
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 30s
timeout: 10s
retries: 3
bot:
build: .
container_name: remnawave_bot
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_healthy
env_file:
- .env
environment:
DOCKER_ENV: "true"
DATABASE_MODE: "auto"
POSTGRES_HOST: "postgres"
POSTGRES_PORT: "5432"
POSTGRES_DB: "${POSTGRES_DB:-remnawave_bot}"
POSTGRES_USER: "${POSTGRES_USER:-remnawave_user}"
POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-secure_password_123}"
REDIS_URL: "redis://redis:6379/0"
TZ: "Europe/Moscow"
LOCALES_PATH: "${LOCALES_PATH:-/app/locales}"
volumes:
- ./logs:/app/logs:rw
- ./data:/app/data:rw
- ./locales:/app/locales:rw
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
- ./vpn_logo.png:/app/vpn_logo.png:ro
ports:
- "${WEB_API_PORT:-8080}:8080"
networks:
- bot_network
healthcheck:
test: ["CMD-SHELL", "python -c 'import requests; requests.get(\"http://localhost:8080/health\", timeout=5)' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 30s
volumes:
postgres_data:
driver: local
redis_data:
driver: local
networks:
bot_network:
name: remnawave_bot_network
driver: bridge
ipam:
config:
- subnet: 172.20.0.0/16
gateway: 172.20.0.1docker-compose.yml для Caddy (отдельный файл):
services:
caddy:
image: caddy:2-alpine
container_name: remnawave_caddy
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
- caddy_data:/data
- caddy_config:/config
networks:
- bot_network
volumes:
caddy_data:
caddy_config:
networks:
bot_network:
name: remnawave_bot_network
external: trueЕсли бот и панель Remnawave запускаются на одном сервере, подключите бота к сети панели:
docker-compose.yml бота:
services:
postgres:
image: postgres:15-alpine
container_name: remnawave_bot_db
restart: unless-stopped
environment:
POSTGRES_DB: ${POSTGRES_DB:-remnawave_bot}
POSTGRES_USER: ${POSTGRES_USER:-remnawave_user}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-secure_password_123}
POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=C"
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- bot_network
- remnawave-network # Подключаем к сети панели
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-remnawave_user} -d ${POSTGRES_DB:-remnawave_bot}"]
interval: 30s
timeout: 5s
retries: 5
start_period: 30s
redis:
image: redis:7-alpine
container_name: remnawave_bot_redis
restart: unless-stopped
command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
volumes:
- redis_data:/data
networks:
- bot_network
- remnawave-network # Подключаем к сети панели
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 30s
timeout: 10s
retries: 3
bot:
build: .
container_name: remnawave_bot
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_healthy
env_file:
- .env
environment:
DOCKER_ENV: "true"
DATABASE_MODE: "auto"
POSTGRES_HOST: "postgres"
POSTGRES_PORT: "5432"
POSTGRES_DB: "${POSTGRES_DB:-remnawave_bot}"
POSTGRES_USER: "${POSTGRES_USER:-remnawave_user}"
POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-secure_password_123}"
REDIS_URL: "redis://redis:6379/0"
TZ: "Europe/Moscow"
LOCALES_PATH: "${LOCALES_PATH:-/app/locales}"
volumes:
- ./logs:/app/logs:rw
- ./data:/app/data:rw
- ./locales:/app/locales:rw
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
- ./vpn_logo.png:/app/vpn_logo.png:ro
ports:
- "${WEB_API_PORT:-8080}:8080"
networks:
- bot_network
- remnawave-network # Подключаем к сети панели
healthcheck:
test: ["CMD-SHELL", "python -c 'import requests; requests.get(\"http://localhost:8080/health\", timeout=5)' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 30s
volumes:
postgres_data:
driver: local
redis_data:
driver: local
networks:
bot_network:
driver: bridge
ipam:
config:
- subnet: 172.20.0.0/16
gateway: 172.20.0.1
remnawave-network:
name: remnawave-network
external: true # Используем существующую сеть панелиВажно:
- Сеть
remnawave-networkдолжна быть создана панелью Remnawave - В
.envукажитеREMNAWAVE_API_URL=http://remnawave:3000(обращение внутри Docker-сети) - Бот сможет напрямую общаться с панелью без внешних запросов
Статические файлы миниапки автоматически монтируются из каталога MINIAPP_STATIC_PATH (по умолчанию miniapp/) и доступны по пути /miniapp/static.
Проверьте, что единый сервер отвечает:
curl -s https://bot.example.com/health/unified | jqПолезные диагностические endpoints:
/health/unified— агрегированный статус (режим бота, очередь Telegram, наличие миниапки и платежей). Когда административное API отключено, тот же статус доступен по/health./health/telegram-webhook— состояние очереди Telegram webhook./health/payment-webhooks— какие платёжные интеграции активированы.
- Включите
WEB_API_DOCS_ENABLED=true, если нужно открыть Swagger UI и OpenAPI. После перезапуска сервиса станут доступны эндпоинты/docs,/doc(редирект для обратной совместимости),/redocи/openapi.json. - Не забудьте проксировать эти пути через внешний HTTPS-прокси вместе с остальными эндпоинтами бота.
- В продакшене держите
WEB_API_DOCS_ENABLED=false, чтобы документация не была публичной. При необходимости включайте временно или защищайте прокси базовой авторизацией/IP-фильтрацией.
Caddyfile:
# API
api.domain.com {
encode gzip zstd
@config path /app-config.json
header @config Access-Control-Allow-Origin "*"
reverse_proxy remnawave_bot:8080 {
header_up Host {host}
header_up X-Real-IP {remote_host}
transport http {
read_buffer 0
}
}
}
# Статика для miniapp
podpiska.domain.com {
encode gzip zstd
# API эндпоинты /miniapp/* в приложение
handle /miniapp/* {
reverse_proxy remnawave_bot:8080 {
header_up Host {host}
header_up X-Real-IP {remote_host}
transport http {
read_buffer 0
}
}
}
# app-config.json с CORS
handle /app-config.json {
header Access-Control-Allow-Origin "*"
reverse_proxy remnawave_bot:8080 {
header_up Host {host}
header_up X-Real-IP {remote_host}
transport http {
read_buffer 0
}
}
}
# Статические файлы (корень и всё остальное)
handle {
root * /var/www/remnawave-miniapp
try_files {path} /index.html
file_server
}
}Примечание: Если прокси запускается на том же сервере, замените remnawave_bot:8080 на localhost:8080
nginx.conf:
events {}
http {
include /etc/nginx/mime.types;
sendfile on;
upstream remnawave_bot_unified {
server remnawave_bot:8080;
}
# API домен
server {
listen 80;
listen 443 ssl http2;
server_name api.domain.com;
ssl_certificate /etc/ssl/private/api.fullchain.pem;
ssl_certificate_key /etc/ssl/private/api.privkey.pem;
client_max_body_size 32m;
# app-config.json с CORS
location = /app-config.json {
add_header Access-Control-Allow-Origin "*";
proxy_pass http://remnawave_bot_unified;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Всё остальное
location / {
proxy_pass http://remnawave_bot_unified;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 120s;
proxy_send_timeout 120s;
proxy_buffering off;
proxy_request_buffering off;
}
}
# Miniapp домен (статика + API)
server {
listen 80;
listen 443 ssl http2;
server_name podpiska.domain.com;
ssl_certificate /etc/ssl/private/podpiska.fullchain.pem;
ssl_certificate_key /etc/ssl/private/podpiska.privkey.pem;
client_max_body_size 32m;
# API эндпоинты /miniapp/*
location /miniapp/ {
proxy_pass http://remnawave_bot_unified;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 120s;
proxy_send_timeout 120s;
proxy_buffering off;
proxy_request_buffering off;
}
# app-config.json с CORS
location = /app-config.json {
add_header Access-Control-Allow-Origin "*";
proxy_pass http://remnawave_bot_unified;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Статические файлы
location / {
root /var/www/remnawave-miniapp;
try_files $uri $uri/ /index.html;
# Кэширование
expires 1h;
add_header Cache-Control "public, immutable";
}
}
}Примечание: Если прокси запускается на том же сервере, замените remnawave_bot:8080 на localhost:8080
Рекомендации:
- Откройте входящие 80/443 в файерволе.
- Если используете Cloudflare/анти-DDoS, разрешите методы
POSTи заголовокX-Telegram-Bot-Api-Secret-Token. - После развёртывания перезапустите бот (
make reload), чтобы он заново зарегистрировал webhook.
| Настройка | Где взять | Пример |
|---|---|---|
| 🤖 BOT_TOKEN | @BotFather | 1234567890:AABBCCdd... |
| 👑 ADMIN_IDS | Твой Telegram ID | 123456789,987654321 |
| BOT_RUN_MODE | определяет способ приёма обновлений: polling, webhook или both, чтобы одновременно использовать оба режима. |
Полный список доступных параметров:
Подробное пошаговое руководство по запуску административного веб-API и подключению внешней панели находится в docs/web-admin-integration.md.
BOT_RUN_MODE— определяет способ приёма обновлений:polling,webhookилиboth, чтобы одновременно использовать оба режима.WEBHOOK_SECRET_TOKEN— секрет для проверки заголовкаX-Telegram-Bot-Api-Secret-Tokenпри работе через вебхуки.WEBHOOK_DROP_PENDING_UPDATES— управляет очисткой очереди сообщений при установке вебхука.WEBHOOK_MAX_QUEUE_SIZE— ограничивает длину очереди входящих обновлений, чтобы защащаться от перегрузок.WEBHOOK_WORKERS— количество фоновых воркеров, параллельно обрабатывающих обновления Telegram.WEBHOOK_ENQUEUE_TIMEOUT— сколько секунд ждать свободного места в очереди перед отказом (0 — немедленный отказ).WEBHOOK_WORKER_SHUTDOWN_TIMEOUT— таймаут корректного завершения воркеров при остановке приложения.
Инструкция по развёртыванию мини-приложения, публикации статической страницы и настройке reverse-proxy доступна в docs/miniapp-setup.md.
Путь к статическим файлам мини-приложения можно переопределить через переменную MINIAPP_STATIC_PATH.
| Переменная | Описание | Пример |
|---|---|---|
SERVER_STATUS_MODE |
Режим работы кнопки: disabled, external_link, external_link_miniapp или xray |
xray |
SERVER_STATUS_EXTERNAL_URL |
Прямаяссылка на внешний мониторинг | https://status.example.com |
SERVER_STATUS_METRICS_URL |
URL страницы метрик XrayChecker | https://sub.example.com/metrics |
Для панелей, защищенных через remnawave-reverse-proxy:
# Для панелей установленных скриптом eGames
REMNAWAVE_SECRET_KEY=XXXXXXX:DDDDDDDD
# Или если ключ и значение одинаковые
REMNAWAVE_SECRET_KEY=secret_key_nameПлатёжный провайдер Platega.io добавляет ещё один способ приёма оплат картой и по СБП. Включите его, если у вас есть кабинет мерчанта и доступ к API.
- В кабинете Platega получите
Merchant IDиSecret(раздел Интеграция → API). - В настройках провайдера укажите URL возврата и ошибки. Их можно задать в
.env(PLATEGA_RETURN_URL,PLATEGA_FAILED_URL). - Активируйте только нужные платёжные методы и пропишите их ID через запятую в
PLATEGA_ACTIVE_METHODS. - Добавьте вебхук
https://your-domain.com/platega-webhookв личном кабинете Platega.
Пример набора переменных окружения:
PLATEGA_ENABLED=true
PLATEGA_MERCHANT_ID=your_merchant_id
PLATEGA_SECRET=your_secret_key
PLATEGA_RETURN_URL=https://your-domain.com/payments/success
PLATEGA_FAILED_URL=https://your-domain.com/payments/failed
PLATEGA_ACTIVE_METHODS=2,10,11
PLATEGA_MIN_AMOUNT_KOPEKS=10000
PLATEGA_MAX_AMOUNT_KOPEKS=5000000
PLATEGA_CURRENCY=RUB
PLATEGA_WEBHOOK_PATH=/platega-webhookОстальные параметры (PLATEGA_BASE_URL, PLATEGA_WEBHOOK_HOST, PLATEGA_WEBHOOK_PORT) оставьте по умолчанию, если работаете через встроенный FastAPI сервер.
TRAFFIC_SELECTION_MODE=selectable
TRAFFIC_PACKAGES_CONFIG="5:2000:false,10:3500:false,25:7000:false,50:11000:true,100:15000:true,250:17000:false,500:19000:false,1000:19500:true,0:20000:true"TRAFFIC_SELECTION_MODE=fixed
FIXED_TRAFFIC_LIMIT_GB=100 # 0 = безлимит
TRAFFIC_PACKAGES_CONFIG="100:15000:true"Цена подписки рассчитывается по формуле: Базовая цена + Стоимость трафика + Доп. устройства + Доп. серверы
Пример расчета для подписки на 180 дней:
- Базовый период: 400₽
- Трафик безлимит: 200₽/мес × 6 мес = 1200₽
- 4 устройства: 50₽/мес × 6 мес = 300₽
- 2 сервера: 100₽/мес × 6 мес = 1200₽
- Итого: 3100₽
# Бесплатные устройства в триал подписке
TRIAL_DEVICE_LIMIT=1
# Требовать оплату за активацию триала
TRIAL_PAYMENT_ENABLED=false
# Стоимость активации триала (в копейках)
TRIAL_ACTIVATION_PRICE=0
# Бесплатные устройства в платной подписке
DEFAULT_DEVICE_LIMIT=3
# Максимум устройств для покупки (0 = без лимита)
MAX_DEVICES_LIMIT=15# Включение/выключение реферальной программы
REFERRAL_PROGRAM_ENABLED=true
# Минимальная сумма пополнения для активации бонусов
REFERRAL_MINIMUM_TOPUP_KOPEKS=10000
# Бонус новому пользователю при первом пополнении
REFERRAL_FIRST_TOPUP_BONUS_KOPEKS=10000
# Бонус пригласившему при первом пополнении реферала
REFERRAL_INVITER_BONUS_KOPEKS=10000
# Процент комиссии с последующих пополнений
REFERRAL_COMMISSION_PERCENT=25# Включение автоматической синхронизации серверов
REMNAWAVE_AUTO_SYNC_ENABLED=true
# Время синхронизации (через запятую, формат HH:MM)
REMNAWAVE_AUTO_SYNC_TIMES=03:00,15:00# Автоматический режим тех. работ
MAINTENANCE_MODE=false
MAINTENANCE_AUTO_ENABLE=true
MAINTENANCE_MONITORING_ENABLED=true
MAINTENANCE_CHECK_INTERVAL=30
MAINTENANCE_RETRY_ATTEMPTS=1
# Интервал проверки состояния панели (секунды)
MONITORING_INTERVAL=60# Redis для сохранения корзины (требуется)
REDIS_URL=redis://redis:6379/0|
🧭 Онбординг и доступ
🛒 Умная покупка подписок
🧪 Тестовая подписка
💰 Платежи и баланс
📱 Управление подписками
🛟 Поддержка и самообслуживание
🧩 Бонусы и промо
💎 Промо-группы и скидки
📱 Mini App и гайды
|
📊 Аналитика и отчётность
💥 Управление пользователями
🎯 Продажи, маркетинг и удержание
🛟 Поддержка и модерация
🔔 Уведомления и коммуникации
🧰 Обслуживание и DevOps
🗄️ Бекапы и восстановление
💳 Биллинг и настройки
🗃️ REST API для интеграций
|
- 🔄 Мониторинг Remnawave - регулярная проверка API, автоматическое включение/выключение техработ
- 🔄 Автосинхронизация серверов - фоновая синхронизация по расписанию
- 🛒 Умная корзина - сохранение параметров подписки в Redis при недостатке баланса
- 🛡️ Антифрод - валидация подписки на канал
- 🚫 Защита от блокировок - автоблокировка подозрительных никнеймов и имитация фишинг аккаунтов
- 🧠 Асинхронная архитектура - aiogram 3, PostgreSQL/SQLite, Redis и очереди задач
- 🌐 Мультиязычность - локализации RU/EN, быстрый выбор языка
- 📦 Интеграция с Remnawave API - автоматическое создание пользователей и синхронизация
- 🔄 Миграция сквадов - массовый перенос пользователей между сквадами
- 🧾 История операций - хранение всех транзакций и действий для аудита
- 💸 Сервис автопрворки транзакций - автоматическая проверка транзакций в статусе "В ожидании оплаты" за последние 24ч
- ⚙️ FastAPI Web API с эндпоинтами для управления всеми аспектами бота
- 🔒 Управление API-ключами - выпуск, отзыв, реактивация токенов
- 🛰️ Mini App - полноценный личный кабинет внутри Telegram
- 💳 Интегрированные платежи в Mini App (Stars, Pal24, YooKassa, WATA)
- 🧭 Единый стандартный app-config.json - централизованная раздача ссылок на клиенты
- 🪙 Платёжные вебхуки - встроенные серверы для всех платёжных систем
- 📡 Мониторинг серверов - REST-эндпоинты для просмотра нод и статистики
| Пользователей | Память | CPU | Диск | Описание |
|---|---|---|---|---|
| 1,000 | 512MB | 1 vCPU | 10GB | ✅ Стартап |
| 10,000 | 2GB | 2 vCPU | 50GB | ✅ Малый бизнес |
| 50,000 | 4GB | 4 vCPU | 100GB | ✅ Средний бизнес |
| 100,000+ | 8GB+ | 8+ vCPU | 200GB+ | 🚀 Enterprise |
- 🐍 Python 3.13+ с AsyncIO - максимальная производительность
- 🗄️ PostgreSQL 15+ - надежное хранение данных
- ⚡ Redis - быстрое кеширование и сессии (для корзины)
- Docker - простое развертывание в любой среде
- 🔗 SQLAlchemy ORM - безопасная работа с БД
- 🚀 aiogram 3 - современная Telegram Bot API
- ⚡ FastAPI - высокопроизводительный REST API
- 📦 Pydantic v2 - валидация данных
После запуска необходимо:
-
📡 Синхронизация серверов (обязательно!)
- Зайди в бот → Админ панель → Подписки → Управление серверами
- Нажми Синхронизация и дождись завершения
- Без этого пользователи не смогут выбирать страны!
-
💥 Синхронизация пользователей (если есть база)
- Админ панель → Remnawave → Синхронизация
- Синхронизировать всех → дождись импорта
-
💳 Настройка платежных систем
- Telegram Stars: Работает автоматически
- Tribute: Настрой webhook на
https://your-domain.com/tribute-webhook - YooKassa: Настрой webhook на
https://your-domain.com/yookassa-webhook - CryptoBot: Настрой webhook на
https://your-domain.com/cryptobot-webhook - Heleket: Настрой webhook на
https://your-domain.com/heleket-webhook - MulenPay: Настрой webhook на
https://your-domain.com/mulenpay-webhook - PayPalych: Укажи Result URL
https://your-domain.com/pal24-webhookв кабинете Pal24 - Platega: Настрой webhook на
https://your-domain.com/platega-webhook - WATA: Настрой webhook на
https://your-domain.com/wata-webhook
-
🔄 Настройка автосинхронизации (опционально)
- В
.envустановиREMNAWAVE_AUTO_SYNC_ENABLED=true - Укажи время синхронизации в
REMNAWAVE_AUTO_SYNC_TIMES=03:00,15:00
- В
Добавьте в файл .env:
# Уведомления администраторов
ADMIN_NOTIFICATIONS_ENABLED=true
ADMIN_NOTIFICATIONS_CHAT_ID=-1001234567890 # ID канала/группы
ADMIN_NOTIFICATIONS_TOPIC_ID=123 # ID топика (опционально)
ADMIN_NOTIFICATIONS_TICKET_TOPIC_ID=126 # ID топика для тикетов- Создайте приватный канал или группу для уведомлений
- Добавьте бота как администратора с правами отправки сообщений
- Получите ID канала:
- Отправьте любое сообщение в канал
- Перешлите его боту @userinfobot
- Скопируйте Chat ID (например:
-1001234567890)
Если используете супергруппу с топиками:
- Включите топики в настройках группы
- Создайте топики для уведомлений (например, "Уведомления", "Тикеты")
- Получите ID топика из URL веб-версии Telegram или используйте бота
- Unified сервер:
http://localhost:8080/health/unified(или/health, если административное API отключено) - Telegram webhook:
http://localhost:8080/health/telegram-webhook - Платёжные webhooks:
http://localhost:8080/health/payment-webhooks
# Просмотр логов в реальном времени
docker compose logs -f bot
# Статус всех контейнеров
docker compose ps
# Перезапуск только бота
docker compose restart bot
# Проверка базы данных
docker compose exec postgres pg_isready -U remnawave_user
# Подключение к базе данных
docker compose exec postgres psql -U remnawave_user -d remnawave_bot
# Проверка Redis
docker compose exec redis redis-cli ping
# Проверка использования ресурсов
docker stats
# Очистка Docker
docker system prune| Проблема | Диагностика | Решение |
|---|---|---|
| Бот не отвечает | docker logs remnawave_bot |
Проверь BOT_TOKEN и интернет |
| Ошибки БД | docker compose ps postgres |
Проверь статус PostgreSQL |
| Webhook не работает | curl http://localhost:8080/health/telegram-webhook |
Проверь WEBHOOK_URL, прокси и секрет |
| API недоступен | Проверь логи бота | Проверь REMNAWAVE_API_URL |
| Корзина не сохраняется | docker compose ps redis |
Проверь статус Redis |
| Платежи не проходят | Проверь webhook'и | Настрой URL в платежных системах |
- 🚀 Старт → Найди бота и нажми
/start - 🌐 Язык → Выбери язык интерфейса (RU/EN)
- 📋 Правила → Прими правила сервиса
- 💰 Баланс → Пополни через любой удобный способ
- 🛒 Подписка → Выбери тариф и параметры
- 📱 Подключение → Получи ссылку или конфиг
- 💥 Партнерка → Поделись ссылкой и получай бонусы
Доступ через "⚙️ Админ панель":
- 📦 Подписки → настройка серверов, цен, синхронизация
- 💥 Пользователи → поиск, редактирование, блокировка
- 💎 Промо-группы → управление скидочными группами и уровнями
- 🎁 Промокоды → создание и статистика
- 🎯 Промо-предложения → персональные акции и скидки
- 📨 Рассылки → уведомления по сегментам
- 📣 Кампании → управление рекламными кампаниями
- 🎫 Тикеты → система поддержки
- 🔄 Контент → политика, оферта, FAQ
- 🖥 Remnawave → мониторинг, синхронизация
- 📊 Статистика → детальная аналитика
Бот поддерживает интеграцию с системой защиты панели:
# Для защищенных панелей
REMNAWAVE_SECRET_KEY=secret_name:secret_value
# Для панелей eGames скрипта
REMNAWAVE_SECRET_KEY=XXXXXXX:DDDDDDDD- Валидация всех входящих данных
- Rate limiting для защиты от спама
- Шифрование чувствительных данных
- Автоматическое управление сессиями
- Мониторинг подозрительной активности
- Защита от запрещенных никнеймов - автоблокировка имитации официальных аккаунтов
- Защита от обфусцированных доменов в отображаемом имени
- 🐛 Сообщай о багах с подробным описанием
- 💡 Предлагай идеи для улучшения
- ⭐ Ставь звезды проекту - это мотивирует разработку!
- 📢 Рассказывай друзьям о проекте
- 👍 Поддержи разработку - помоги проекту расти
- 🔧 Отправляй Pull Requests - внеси свой вклад в код
- 💬 Telegram: @fringg - вопросы по разработке (только по делу!)
- 💬 Telegram Group: Bedolaga Chat - общение, вопросы, предложения
- 🐛 Issues: GitHub Issues - баги и предложения
- 📖 https://docs.remna.st)) - документация панели
- 🤖 Telegram Bot API - API ботов
- 🐳 Docker Guide - обучение Docker
- 🛡️ Reverse Proxy - защита панели
| 🏆 Место | 👤 Спонсор | 💰 Сумма | 💬 Благодарность |
|---|---|---|---|
| 🥇 | @SmartSystemCompany | ₽8,500 | За щедрую поддержку и вклад в развитие |
| 🥈 | @pilot_737800 | ₽7,750 | За веру в проект с самого начала |
| 🥈 | @psych0O | $60 | За щедрую поддержку и вклад в развитие |
| 🥉 | @Vldmrmtn | ₽5,000 | За значительную поддержку проекта |
| 4 | @k0tbtc | ₽3,000 | За поддержку и доверие |
| 5 | @Legacyyy777 | ₽2,900 | За ценные предложения и UX улучшения |
| 6 | @sklvg | ₽3,000 | За международную поддержку |
- @yazhog - легенда проекта! За крутые PR'ы, рефакторинг, автобекапы и навигацию
- @Gy9vin - за модульную архитектуру, быстрое пополнение, админ-функции и тестирование
- @Legacyyy777 - за улучшения рассылки, PayPalych, MulenPay и UX фиксы
- @SantaSpeen - за актуализацию app-config.json и кучу рекомендаций
- @PEDZEO - за SLA поддержки и управление модераторами
- Remnawave Team - за отличную панель и стабильный API
- Сообщество Bedolaga - за активное тестирование и обратную связь
- Всем пользователям - за доверие и использование бота
- 🌎 Веб-панель - полноценная административная панель
- 🔄 API для интеграций - подключение внешних сервисов
- 🎨 Темы оформления - Новая тема интерфейса Mini App by https://t.me/arpicme
Проект распространяется под лицензией MIT
|
|
|
|
|
|
| Метрика | Значение |
|---|---|
| 💳 Платёжных систем | 9 (Stars, YooKassa, Tribute, CryptoBot, Heleket, MulenPay, Pal24, Platega, WATA) |
| 🌍 Языков интерфейса | 2 (RU, EN) с возможностью расширения |
| 📊 Периодов подписки | 6 (от 14 дней до года) |
| 🎁 Типов промо-акций | 5 (коды, группы, предложения, скидки, кампании) |
| 🔌 REST API эндпоинтов | 50+ для полного управления |
| 📱 Режимов работы | 2 (классический бот + MiniApp focus) |
| 🛡️ Методов авторизации | 4 (API Key, Bearer, Basic Auth, eGames) |
| 🗄️ Способов хранения | 2 (PostgreSQL, SQLite) с автовыбором |
✅ Быстрый запуск - от установки до первых продаж за 10 минут
✅ Полная автоматизация - бот работает 24/7 без вашего участия
✅ Прозрачная аналитика - всегда знаете, сколько зарабатываете
✅ Гибкие тарифы - настройте цены под свою аудиторию
✅ Система лояльности - удерживайте клиентов промо-группами и скидками
✅ Масштабируемость - от 10 до 100,000+ пользователей
✅ Современный стек - Python 3.13, AsyncIO, PostgreSQL, Redis
✅ Модульная архитектура - легко расширять и модифицировать
✅ Полное API - интегрируйте с любыми сервисами
✅ Docker-ready - разворачивается за минуты
✅ Подробная документация - все описано и понятно
✅ Активное сообщество - помощь в Telegram чате
✅ Простой интерфейс - интуитивно понятное меню на родном языке
✅ Много способов оплаты - выбирайте удобный вариант
✅ Быстрая поддержка - система тикетов с приоритетами
✅ Прозрачность - всегда видите, за что платите
✅ Бонусы и скидки - реферальная программа и промо-акции
✅ Удобное управление - все в одном месте, в Telegram
- Используйте Redis для корзины и кэширования
- Настройте автосинхронизацию в ночное время
- Включите автобэкапы с отправкой в Telegram
- Оптимизируйте логирование - LOG_LEVEL=INFO для продакшена
- Используйте PostgreSQL вместо SQLite для больших баз
- Включите реферальную программу - пользователи приведут друзей
- Настройте промо-группы - дайте скидки постоянным клиентам
- Используйте персональные акции - реактивируйте неактивных
- Запускайте кампании - привлекайте новых через deeplink
- Добавьте быстрое пополнение - упростите процесс оплаты
- Включите Mini App режим - современный интерфейс
- Настройте корзину - пользователи не потеряют выбор
- Добавьте FAQ - ответьте на частые вопросы заранее
- Настройте быстрые ответы - ускорьте поддержку
- Используйте уведомления - держите пользователей в курсе
- ✅ Шифрование чувствительных данных в БД
- ✅ Безопасное хранение токенов и ключей
- ✅ Валидация всех входящих данных
- ✅ Защита от SQL-инъекций через ORM
- ✅ Rate limiting для предотвращения злоупотреблений
- ✅ Аудит всех административных действий
- ✅ Политика конфиденциальности (настраивается)
- ✅ Публичная оферта (настраивается)
- ✅ Правила использования (настраивается)
- ✅ История транзакций для аудита
- ✅ Соответствие требованиям платёжных систем
- ✅ GDPR-ready (возможность удаления данных)
Как начать работу?
- Скачайте репозиторий
- Запустите
install_bot.sh - Следуйте инструкциям установщика
- Синхронизируйте серверы в админке
- Готово! 🎉
Какие требования к серверу?
Минимальные:
- 1 vCPU
- 512 MB RAM
- 10 GB диск
- Ubuntu 20.04+ или Debian 11+
- Docker и Docker Compose
Рекомендуемые:
- 2+ vCPU
- 2+ GB RAM
- 50+ GB SSD
- Стабильное интернет-соединение
Как настроить платёжную систему?
- Получите ключи API в личном кабинете платёжной системы
- Добавьте их в
.envфайл - Настройте webhook URL в кабинете провайдера
- Протестируйте через админ-панель бота
- Включите метод для пользователей
Подробнее: docs/payment-setup.md
Как обновить бота?
Через install_bot.sh (рекомендуется):
./install_bot.sh
# Выбрать: 4. 🔄 Обновить проект из GitВручную:
git pull
docker compose down
docker compose pull
docker compose up -dСкрипт автоматически создаст бэкап перед обновлением!
Как сделать бэкап?
Автоматически:
- Настройте в
.env:BACKUP_AUTO_ENABLED=true - Бэкапы создаются по расписанию
Вручную через install_bot.sh:
./install_bot.sh
# Выбрать: 5. 💾 Создать резервную копиюЧерез админ-панель:
- Админ панель → Настройки → Бэкапы → Создать
Бот не отвечает, что делать?
- Проверьте статус:
docker compose ps - Посмотрите логи:
docker compose logs -f bot - Проверьте BOT_TOKEN в
.env - Убедитесь, что все контейнеры запущены
- Попробуйте перезапустить:
docker compose restart
Если не помогло - пишите в чат поддержки
- 🐛 Баг? → GitHub Issues
- 💡 Идея? → GitHub Discussions
- 🆘 Вопрос? → Bedolaga Chat
- 📧 Личное? → @fringg
Made with ❤️ by @fringg and amazing contributors