Remnawave Minishop - Telegram-бот и Web App (Mini App) для продажи и управления подписками Remnawave. Бот обрабатывает регистрацию, оплату, продление, пробный период, промокоды, рефералов и поддержку в чате. Web App показывает ссылку подключения, срок действия, трафик, оплату, устройства и вход по Telegram Mini Apps initData, Telegram OAuth / OpenID Connect и одноразовому email-коду.

Проект является переработанным форком kavore/remnawave-tg-shop. Для переноса данных из прежнего стека используйте инструкцию по миграции.

Возможности

Для пользователей:

регистрация с выбором русского или английского языка;
просмотр статуса подписки, даты окончания, ссылки подключения и трафика;
покупка подписок, пакетов трафика, обычная и premium-докупка трафика, докупка устройств по настроенному каталогу тарифов;
Web App / Mini App с входом через Telegram или email;
пробный период, промокоды и реферальная программа;
оплата через YooKassa, FreeKassa, Platega, SeverPay, CryptoPay и Telegram Stars;
раздел "Мои устройства" при включенном MY_DEVICES_SECTION_ENABLED.

Для администраторов:

админ-панель для пользователей из ADMIN_IDS (только при входе через Telegram, не для аккаунтов только с email);
статистика пользователей, подписок, платежей и синхронизации с Remnawave;
список пользователей с поиском, фильтрами и колонкой premium-трафика;
блокировка пользователей, рассылки, промокоды, логи действий и настройка разрешенных параметров приложения поверх .env;
редактор JSON-каталога тарифов с period/traffic-моделями, Internal Squads, premium-сквадами и HWID-пакетами;
ручная синхронизация пользователей и подписок с панелью.

Документация

Настройка окружения - основные переменные .env, платежи, Remnawave, пробный период, SMTP для email-входа и секреты.
Тарифы - каталог тарифов, period- и traffic-модели, обычные и premium-докупки, premium-сквады, смена тарифа, HWID-лимиты и обработка трафика.
Админ-панель - права доступа, настройки, редактор тарифов, premium-сквады и сохранение JSON-каталога.
Web App / Mini App - отдельный порт, домен, Telegram OAuth, email-вход и реферальные ссылки.
Темы Web App - кастомные темы, настройка внешнего вида, логотипы, CSS/ассеты и пайплайн создания новой темы.
Развертывание - Docker Compose, reverse proxy, Nginx, Caddy, вебхуки, запуск из образа и обновление версии (IMAGE_TAG).
Миграция с remnawave-tg-shop - перенос данных из прежнего стека.

Совместимость

Интеграция с API панели Remnawave (вебхуки, пользователи, подписки, статистика в админке и т.д.) протестирована на панели Remnawave версии > 2.7.0. Более старые версии могут работать частично или не работать из‑за изменений в API.

Стек

Сборка и runtime задаются Dockerfile и docker-compose.yml; точные версии пакетов — в requirements.txt и package.json.

Слой	Технологии
Backend	Python 3.12, aiogram 3.x (Telegram), aiohttp (HTTP и Web App), SQLAlchemy 2 async, asyncpg, Pydantic / pydantic-settings, httpx, платёжные SDK (в т.ч. YooKassa, aiocryptopay), PyJWT
Данные	PostgreSQL 17 (сервис `remnawave-minishop-db` в Compose)
Сборка Web App	Node.js 22, Svelte 5, Vite, Tailwind CSS 4; артефакты попадают в шаблоны `bot/app/web/templates/`

Локальная разработка без Docker возможна при установленных Python 3.12, PostgreSQL и (для пересборки фронта) Node 22; типичный сценарий — всё через Compose.

Быстрый старт

Требования:

Docker и Docker Compose;
рабочая панель Remnawave версии > 2.7.0 (см. раздел «Совместимость»);
токен Telegram-бота;
параметры хотя бы одного платежного провайдера.

git clone https://github.com/3252a8/remnawave-minishop
cd remnawave-minishop
cp .env.example .env
nano .env
docker compose up -d --build
docker compose logs -f remnawave-minishop

Минимально заполните в .env:

BOT_TOKEN - токен Telegram-бота;
ADMIN_IDS - Telegram ID администраторов через запятую;
WEBHOOK_BASE_URL - публичный URL вебхуков;
PANEL_API_URL, PANEL_API_KEY, PANEL_WEBHOOK_SECRET - доступ к Remnawave;
USER_SQUAD_UUIDS - Internal Squads для пользователей;
настройки платежного провайдера;
SUBSCRIPTION_MINI_APP_URL, если используется Web App.

Для каталога тарифов используется TARIFFS_CONFIG_PATH со значением по умолчанию data/tariffs.json. Пример формата лежит в data/tariffs.example.json, подробности - в docs/tariffs.md.

Если в Docker Compose включаете bind mount ./data:/app/data, заранее создайте каталог и отдайте его пользователю контейнера. Это нужно для сохранения data/tariffs.json, каталога тем data/themes, кеша логотипа Web App и animated emoji:

mkdir -p data/themes data/webapp-logo data/webapp-emoji
chown -R 10001:10001 data
chmod -R u+rwX data

Полезные команды

# Локальная сборка и запуск
docker compose up -d --build

# Логи приложения
docker compose logs -f remnawave-minishop

# Запуск с Caddy
docker compose -f docker-compose-caddy.yml up -d --build

# Запуск из готового образа
IMAGE_TAG=3.1.0 docker compose -f docker-compose-remote-server.yml up -d

Поддержка

Crypto: USDT/Other ERC-20 0xeD506D44aae634fEc0E01C8835744fBedb7B2a44 (Ethereum/Polygon/Gnosis)

README.md Unescape Escape

Remnawave Minishop