austnv/remnawave-minishop
1
0
Fork 0
Code Issues 1 Pull Requests Activity
Files
63784bc03670dca93afa0f5f04b311db18d78389
remnawave-minishop/README.md
T

41 KiB
Raw Blame History

Remnawave Minishop

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

🍴 Это глубоко переработанный форк kavore/remnawave-tg-shop. Здесь добавлены полноценный Web App / Mini App, вход по email и многое другое. Возможна миграция.

✨ Ключевые возможности

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

  • Регистрация и выбор языка: Поддержка русского и английского языков.
  • Просмотр подписки: Пользователи могут видеть статус своей подписки, дату окончания и ссылку на конфигурацию.
  • Web App (Mini App): отдельный веб-интерфейс для просмотра ссылки подключения, остатка времени и оплаты подписки.
  • Вход по email: вход и регистрация в Web App по коду из письма, а также привязка email и Telegram к одному аккаунту.
  • Мои устройства: Опциональный раздел для просмотра и отключения подключенных устройств (активируется через переменную MY_DEVICES_SECTION_ENABLED).
  • Пробная подписка: Система пробных подписок для новых пользователей (активируется вручную по кнопке).
  • Промокоды: Возможность применять промокоды для получения скидок или бонусных дней.
  • Реферальная программа: Пользователи могут приглашать друзей и получать за это бонусные дни подписки.
  • Оплата: Поддержка оплаты через YooKassa, FreeKassa (REST API), Platega, SeverPay, CryptoPay и Telegram Stars.

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

  • Защищенная админ-панель: Доступ только для администраторов, указанных в ADMIN_IDS.
  • Статистика: Просмотр статистики использования бота (общее количество пользователей, забаненные, активные подписки), недавние платежи и статус синхронизации с панелью.
  • Управление пользователями: Блокировка/разблокировка пользователей, просмотр списка забаненных и детальной информации о пользователе.
  • Рассылка: Отправка сообщений всем пользователям, пользователям с активной или истекшей подпиской.
  • Управление промокодами: Создание и просмотр промокодов.
  • Синхронизация с панелью: Ручной запуск синхронизации пользователей и подписок с панелью Remnawave.
  • Логи действий: Просмотр логов всех действий пользователей.

🚀 Технологии

  • Python 3.12
  • Aiogram 3.x: Асинхронный фреймворк для Telegram ботов.
  • aiohttp: Для запуска веб-сервера (вебхуки).
  • SQLAlchemy 2.x & asyncpg: Асинхронная работа с базой данных PostgreSQL.
  • YooKassa, FreeKassa API, Platega, SeverPay, aiocryptopay: Интеграции с платежными системами.
  • Pydantic: Для управления настройками из .env файла.
  • Docker & Docker Compose: Для контейнеризации и развертывания.

⚙️ Установка и запуск

Предварительные требования

  • Установленные Docker и Docker Compose.
  • Рабочая панель Remnawave.
  • Токен Telegram-бота.
  • Данные для подключения к платежным системам (YooKassa, CryptoPay и т.д.).

Шаги установки

  1. Клонируйте репозиторий:

    git clone https://github.com/3252a8/remnawave-minishop
cd remnawave-minishop

  2. Создайте и настройте файл .env: Скопируйте .env.example в .env и заполните своими данными.

    cp .env.example .env
nano .env

    Ниже перечислены ключевые переменные.

    Основные настройки
    Переменная Описание Пример
    BOT_TOKEN Обязательно. Токен вашего Telegram-бота. 1234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
    ADMIN_IDS Обязательно. ID администраторов в Telegram через запятую. 12345678,98765432
    DEFAULT_LANGUAGE Язык по умолчанию для новых пользователей. ru
    SUPPORT_LINK (Опционально) Ссылка на поддержку. https://t.me/your_support
    PRIVACY_POLICY_URL (Опционально) Ссылка на политику конфиденциальности, показывается внизу Web App. https://example.com/privacy
    USER_AGREEMENT_URL (Опционально) Ссылка на пользовательское соглашение, показывается внизу Web App. https://example.com/agreement
    SUBSCRIPTION_MINI_APP_URL (Опционально) Публичный URL Mini App для показа подписки. Если задан, кнопка «Моя подписка» откроет Web App. https://app.domain.com/
    WEBAPP_ENABLED Включить Web App в том же контейнере, но на отдельном порту. true
    WEBAPP_SERVER_PORT Внутренний порт Web App. 8081
    WEBAPP_TITLE Заголовок Web App. Моя подписка
    WEBAPP_PRIMARY_COLOR Основной цвет Web App. #00fe7a
    WEBAPP_LOGO_URL (Опционально) URL логотипа Web App. Если значение пустое, логотип не показывается вообще; если задано, он отображается в шапке и на экране логина. https://domain.com/logo.png
    TELEGRAM_OAUTH_CLIENT_ID Client ID для нового Telegram OAuth / OpenID Connect Login из BotFather. Если пусто, используется числовой ID из BOT_TOKEN. 1234567890
    TELEGRAM_OAUTH_CLIENT_SECRET Client Secret из BotFather для Telegram OAuth Authorization Code Flow. tg_oauth_secret
    TELEGRAM_OAUTH_REQUEST_ACCESS Дополнительные разрешения Telegram Login через запятую: write, phone. Пустое значение запрашивает только OpenID profile. write
    SMTP_HOST SMTP-сервер для кодов входа по email. Для Brevo: smtp-relay.brevo.com. smtp-relay.brevo.com
    SMTP_PORT SMTP-порт. Для Brevo обычно используется 587 с STARTTLS. 587
    SMTP_FALLBACK_PORTS Дополнительные SMTP-порты через запятую. Пробуются после SMTP_PORT; порт 465 автоматически используется через SSL. Для Brevo удобно оставить 2525,465. 2525,465
    SMTP_TIMEOUT_SECONDS Timeout для каждой SMTP-попытки подключения и отправки. 30
    SMTP_USERNAME / SMTP_PASSWORD Логин и SMTP key/password из Brevo. Если не заданы вместе с SMTP_FROM_EMAIL, вход по email скрывается. user@smtp-brevo.com
    SMTP_FROM_EMAIL / SMTP_FROM_NAME Подтвержденный отправитель и отображаемое имя отправителя для писем с кодом. no-reply@example.com
    EMAIL_CODE_TTL_SECONDS Срок действия кода подтверждения email. 600
    EMAIL_CODE_RESEND_SECONDS Минимальная пауза между отправками кода на один email. 60
    EMAIL_CODE_MAX_ATTEMPTS Максимум попыток на один конкретный код. 5
    BRUTE_FORCE_MAX_FAILURES Максимум неудачных попыток в окне защиты от перебора. 5
    BRUTE_FORCE_WINDOW_SECONDS Длительность окна, в котором считаются неудачные попытки. 900
    BRUTE_FORCE_LOCK_SECONDS Время временной блокировки после превышения лимита. 1800
    MY_DEVICES_SECTION_ENABLED Включить раздел «Мои устройства» в меню подписки (true/false). false
    WEBAPP_SESSION_SECRET (Опционально) HMAC-секрет для подписи сессий Web App. Если пусто — генерируется при старте, но тогда сессии станут невалидными после перезапуска контейнера. Для прода задайте явно. см. раздел «Генерация секретов»
    WEBHOOK_SECRET_TOKEN (Опционально) Secret token для проверки подлинности вебхуков Telegram. Если пусто — генерируется при старте. Для прода задайте явно, чтобы значение пережило рестарт. см. раздел «Генерация секретов»
    REQUIRED_CHANNEL_ID (Опционально) ID канала, на который пользователь должен подписаться перед использованием. Оставьте пустым, если проверка не нужна. -1001234567890
    REQUIRED_CHANNEL_LINK (Опционально) Публичная ссылка или invite на канал для кнопки «Проверить подписку». https://t.me/your_channel
    Настройки платежей и вебхуков
    Переменная Описание
    WEBHOOK_BASE_URL Обязательно. Базовый URL для вебхуков, например https://your.domain.com.
    WEB_SERVER_HOST Хост для веб-сервера (по умолчанию 0.0.0.0).
    WEB_SERVER_PORT Порт для веб-сервера (по умолчанию 8080).
    WEBAPP_SERVER_HOST Хост отдельного веб-сервера Mini App (по умолчанию 0.0.0.0).
    WEBAPP_SERVER_PORT Порт отдельного веб-сервера Mini App (по умолчанию 8081).
    PAYMENT_METHODS_ORDER (Опционально) Порядок отображения кнопок оплаты через запятую. Поддерживаемые ключи: severpay, freekassa, platega, yookassa, stars, cryptopay. Первый будет сверху.
    YOOKASSA_ENABLED Включить/выключить YooKassa (true/false).
    YOOKASSA_SHOP_ID ID вашего магазина в YooKassa.
    YOOKASSA_SECRET_KEY Секретный ключ магазина YooKassa.
    YOOKASSA_AUTOPAYMENTS_ENABLED Включить автопродление (сохранение карт, автосписания, управление способами оплаты).
    YOOKASSA_AUTOPAYMENTS_REQUIRE_CARD_BINDING Требовать обязательную привязку карты при оплате с автосписанием. Установите false, чтобы пользователю показывался чекбокс «Сохранить карту».
    NALOGO_INN ИНН для авторизации в nalog.ru (самозанятый).
    NALOGO_PASSWORD Пароль для авторизации в nalog.ru (самозанятый).
    CRYPTOPAY_ENABLED Включить/выключить CryptoPay (true/false).
    CRYPTOPAY_TOKEN Токен из вашего CryptoPay App.
    FREEKASSA_ENABLED Включить/выключить FreeKassa (true/false).
    FREEKASSA_MERCHANT_ID ID вашего магазина в FreeKassa.
    FREEKASSA_API_KEY API-ключ для запросов к FreeKassa REST API.
    FREEKASSA_SECOND_SECRET Секретное слово №2 — используется для проверки уведомлений от FreeKassa.
    FREEKASSA_PAYMENT_URL (Опционально, legacy SCI) Базовый URL платёжной формы FreeKassa. По умолчанию https://pay.freekassa.ru/.
    FREEKASSA_PAYMENT_IP Внешний IP вашего сервера, который будет передаваться в запрос оплаты.
    FREEKASSA_PAYMENT_METHOD_ID ID метода оплаты через магазин FreeKassa. По умолчанию 44.
    STARS_ENABLED Включить/выключить Telegram Stars (true/false).
    PLATEGA_ENABLED Включить/выключить Platega (true/false).
    PLATEGA_MERCHANT_ID MerchantId из личного кабинета Platega.
    PLATEGA_SECRET API секрет для запросов Platega.
    PLATEGA_PAYMENT_METHOD ID способа оплаты (2 — SBP QR, 10 — РФ карты, 12 — международные карты, 13 — crypto).
    PLATEGA_RETURN_URL (Опционально) URL редиректа после успешной оплаты. По умолчанию ссылка на бота.
    PLATEGA_FAILED_URL (Опционально) URL редиректа при ошибке/отмене. По умолчанию как PLATEGA_RETURN_URL.
    SEVERPAY_ENABLED Включить/выключить SeverPay (true/false).
    SEVERPAY_MID MID магазина в SeverPay.
    SEVERPAY_TOKEN Секрет/токен для подписи запросов SeverPay.
    SEVERPAY_BASE_URL (Опционально) Базовый URL API SeverPay. По умолчанию https://severpay.io/api/merchant.
    SEVERPAY_RETURN_URL (Опционально) URL редиректа после оплаты (по умолчанию ссылка на бота).
    SEVERPAY_LIFETIME_MINUTES (Опционально) Время жизни платежной ссылки в минутах (30–4320).
    Настройки тарифов

    Бот умеет продавать подписку на срок (1/3/6/12 мес.) или пакеты трафика (TRAFFIC_PACKAGES=10:199,50:799). Эти режимы взаимоисключающие — наличие непустой TRAFFIC_PACKAGES (или STARS_TRAFFIC_PACKAGES) автоматически переключает бот в режим продажи трафика.

    Полное описание обоих режимов, переменных, что происходит при покупке, как ведут себя автопродление, реф-бонусы и триал — вынесено в docs/tariffs.md.

    Настройки панели Remnawave
    Переменная Описание
    PANEL_API_URL URL API вашей панели Remnawave.
    PANEL_API_KEY API ключ для доступа к панели.
    PANEL_WEBHOOK_SECRET Секретный ключ для проверки вебхуков от панели.
    USER_SQUAD_UUIDS ID отрядов для новых пользователей.
    USER_EXTERNAL_SQUAD_UUID Опционально. UUID внешнего отряда (External Squad) из документации Remnawave, куда автоматически добавляются новые пользователи.
    USER_TRAFFIC_LIMIT_GB Лимит трафика в ГБ (0 - безлимит).
    USER_HWID_DEVICE_LIMIT Лимит устройств (HWID) для новых пользователей (0 - безлимит).

    Раздел "Мои устройства" становится доступен пользователям только при включении MY_DEVICES_SECTION_ENABLED. Значение лимита устройств при создании записей в панели берётся из USER_HWID_DEVICE_LIMIT.

    Настройки пробного периода
    Переменная Описание
    TRIAL_ENABLED Включить/выключить пробный период (true/false).
    TRIAL_DURATION_DAYS Длительность пробного периода в днях.
    TRIAL_TRAFFIC_LIMIT_GB Лимит трафика для пробного периода в ГБ.

  3. Сгенерируйте секреты (рекомендуется):

    Переменные WEBAPP_SESSION_SECRET и WEBHOOK_SECRET_TOKEN могут быть пустыми — тогда они автоматически сгенерируются при каждом старте контейнера. Однако в проде это означает, что после рестарта все сессии Web App станут невалидными, а Telegram придётся перерегистрировать webhook. Поэтому для боевого окружения задайте оба значения вручную.

    Сгенерировать криптостойкие значения можно одной из команд:

    # вариант 1 — Python (есть в любом окружении с Python 3)
python -c "import secrets; print(secrets.token_urlsafe(32))"

# вариант 2 — openssl
openssl rand -base64 32 | tr -d '=+/' | cut -c1-43

# вариант 3 — /dev/urandom (Linux/macOS)
head -c 32 /dev/urandom | base64 | tr -d '=+/' | cut -c1-43

    Запустите команду дважды и подставьте полученные значения в .env:

    WEBAPP_SESSION_SECRET=<первое_значение>
WEBHOOK_SECRET_TOKEN=<второе_значение>

    ⚠️ Не используйте одно и то же значение для обеих переменных и не коммитьте .env в git.

  4. Запустите контейнеры:

    docker compose up -d

    Эта команда соберёт образ из Dockerfile (Python + сборка Web App на Node) и запустит сервис в фоновом режиме. Если нужен запуск из готового образа GHCR — используйте docker-compose-remote-server.yml.

  5. Настройка вебхуков (Обязательно): Вебхуки являются обязательным компонентом для работы бота, так как они используются для получения уведомлений от платежных систем (YooKassa, FreeKassa, CryptoPay, Platega, SeverPay) и панели Remnawave.

    Вам понадобится обратный прокси (например, Nginx) для обработки HTTPS-трафика и перенаправления запросов на контейнер с ботом.

    Пути для перенаправления:

    • https://<ваш_домен>/webhook/yookassa → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/yookassa
    • https://<ваш_домен>/webhook/freekassa → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/freekassa
    • https://<ваш_домен>/webhook/platega → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/platega
    • https://<ваш_домен>/webhook/severpay → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/severpay
    • https://<ваш_домен>/webhook/cryptopay → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/cryptopay
    • https://<ваш_домен>/webhook/panel → http://remnawave-minishop:<WEB_SERVER_PORT>/webhook/panel
    • Для Telegram: Бот автоматически установит вебхук, если в .env указан WEBHOOK_BASE_URL. Путь будет https://<ваш_домен>/<BOT_TOKEN>.

    Где remnawave-minishop — это имя сервиса из docker-compose.yml, а <WEB_SERVER_PORT> — порт, указанный в .env.

    Отдельный порт Web App:

    • https://<домен_web_app>/ → http://remnawave-minishop:<WEBAPP_SERVER_PORT>/

    Web App не должен проксироваться на WEB_SERVER_PORT: этот порт оставьте для Telegram, платежных и Remnawave webhooks.

  6. Просмотр логов:

    docker compose logs -f remnawave-minishop

    💡 Если включена проверка подписки на канал (REQUIRED_CHANNEL_ID), добавьте бота администратором в этот канал. Пользователь увидит кнопку «Проверить подписку», и, после первого успешного подтверждения, дальнейшие действия блокироваться не будут.

Настройка Web App / Mini App

Web App запускается в том же контейнере, что и бот, но слушает отдельный порт WEBAPP_SERVER_PORT (по умолчанию 8081). Внутри Telegram пользователь авторизуется через Telegram Mini Apps initData; если страницу открыть вне Telegram, используется новый Telegram OAuth / OpenID Connect Authorization Code Flow с PKCE, callback /auth/telegram/callback, nonce и серверной проверкой id_token по JWKS Telegram. Старый Login Widget больше не используется в UI. Также доступен вход по email через одноразовый код из письма, если настроен SMTP: после отправки письма код вводится в отдельном модальном окне подтверждения. После успешного входа страница обновляет данные сразу, без сообщений боту.

  1. Укажите в .env публичный URL Web App и порт:

    WEBAPP_ENABLED=True
WEBAPP_SERVER_HOST=0.0.0.0
WEBAPP_SERVER_PORT=8081
SUBSCRIPTION_MINI_APP_URL=https://app.domain.com/
WEBAPP_TITLE="Моя подписка"
WEBAPP_PRIMARY_COLOR="#00fe7a"
WEBAPP_LOGO_URL=
TELEGRAM_OAUTH_CLIENT_ID=<client-id-из-botfather>
TELEGRAM_OAUTH_CLIENT_SECRET=<client-secret-из-botfather>
TELEGRAM_OAUTH_REQUEST_ACCESS=write
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_FALLBACK_PORTS=2525,465
SMTP_USERNAME=<brevo-smtp-login>
SMTP_PASSWORD=<brevo-smtp-key>
SMTP_FROM_EMAIL=no-reply@domain.com

    Если основной порт не отвечает, отправка письма автоматически пробует fallback-порты из SMTP_FALLBACK_PORTS. Для Brevo типичная схема: 587 с STARTTLS, затем 2525, затем 465 через SSL.

  2. Убедитесь, что docker-compose.yml публикует порт Web App:

    ports:
  - 127.0.0.1:8080:8080
  - 127.0.0.1:${WEBAPP_SERVER_PORT:-8081}:${WEBAPP_SERVER_PORT:-8081}

  3. Проксируйте отдельный домен или location на порт Web App:

    upstream remnawave-minishop-webapp {
    server remnawave-minishop:8081;
}

server {
    server_name app.domain.com;
    listen 443 ssl;
    http2 on;

    ssl_certificate "/etc/nginx/ssl/app_fullchain.pem";
    ssl_certificate_key "/etc/nginx/ssl/app_privkey.key";

    location / {
        proxy_pass http://remnawave-minishop-webapp;
        proxy_http_version 1.1;
        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;
    }
}

  4. В BotFather настройте бота, Mini App и Telegram OAuth Login:

    • @BotFather → /mybots → выберите бота.
    • Bot Settings → Domain: укажите домен без протокола и пути, например app.domain.com.
    • Bot Settings → Mini Apps: задайте URL Mini App, например https://app.domain.com/.
    • Bot Settings → Web Login: если BotFather показывает кнопку Switch to OpenID Connect Login, нажмите ее.
    • Bot Settings → Web Login: скопируйте Client ID и Client Secret в TELEGRAM_OAUTH_CLIENT_ID и TELEGRAM_OAUTH_CLIENT_SECRET.
    • Web Login → Allowed URLs: добавьте: https://app.domain.com/ https://app.domain.com/auth/telegram/callback
    • TELEGRAM_OAUTH_REQUEST_ACCESS=write разрешает боту написать пользователю после логина. Если дополнительные разрешения не нужны, оставьте переменную пустой.

  5. Перезапустите контейнер:

    docker compose up -d --build

После этого кнопка «Личный кабинет» в меню бота откроет Web App. Рядом доступна кнопка «Бот-меню» для открытия расширенного интерфейса в чате без команды /tg, но основной сценарий управления подпиской удобнее проходить в личном кабинете. Web App показывает текущую ссылку подключения, остаток времени, трафик, оплату и блок аккаунта. Пользователь может привязать email к Telegram-аккаунту через код из письма или привязать Telegram к email-аккаунту через Telegram OAuth Login. После привязки вход работает обоими способами.

Реферальные ссылки доступны в двух форматах: Telegram deep-link https://t.me/<bot>?start=ref_u<code> и Web App ссылка с query-параметром ref=u<code>. Web App учитывает ref, start, start_param и Telegram Mini Apps start_param, сохраняет найденный параметр до авторизации и передаёт его в Telegram OAuth и email-вход, чтобы регистрация корректно привязалась к пригласившему.

Для email-регистраций пользователь в панели Remnawave создается с анонимным username вида em_<referral_code>; email добавляется в описание пользователя панели и, если API панели принимает поле email, передается отдельным полем. Для Telegram-регистраций сохраняется существующая схема tg_<telegram_id>.

Подробная инструкция для развертывания на сервере с панелью Remnawave

1. Клонирование репозитория

git clone https://github.com/3252a8/remnawave-minishop && cd remnawave-minishop

2. Настройка переменных окружения

cp .env.example .env && nano .env

Обязательные поля для заполнения:

  • BOT_TOKEN - токен телеграмм бота, например, 234567890:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
  • ADMIN_IDS - TG ID администраторов, например, 12345678,98765432 и т.д. (через запятую без пробелов)
  • WEBHOOK_BASE_URL - Обязательно. Базовый URL для вебхуков, например https://webhook.domain.com
  • PANEL_API_URL - URL API вашей панели Remnawave (например, http://remnawave:3000/api или https://panel.domain.com/api)
  • PANEL_API_KEY - API ключ для доступа к панели (генерируется из UI-интерфейса панели)
  • PANEL_WEBHOOK_SECRET - Секретный ключ для проверки вебхуков от панели (берётся из .env самой панели)
  • USER_SQUAD_UUIDS - ID отрядов для новых пользователей

3. Настройка Reverse Proxy (Nginx)

Перейдите в директорию конфигурации Nginx панели Remnawave:

cd /opt/remnawave/nginx && nano nginx.conf

Добавьте в nginx.conf следующую конфигурацию:

upstream remnawave-minishop {
    server remnawave-minishop:8080;
}

map $http_upgrade $connection_upgrade {
    default upgrade;
    "" close;
}

server {
    server_name webhook.domain.com; # Домен для отправки Webhook'ов
    listen 443 ssl;
    http2 on;

    ssl_certificate "/etc/nginx/ssl/webhook_fullchain.pem";
    ssl_certificate_key "/etc/nginx/ssl/webhook_privkey.key";
    ssl_trusted_certificate "/etc/nginx/ssl/webhook_fullchain.pem";

    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    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_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Port $server_port;
    proxy_send_timeout 60s;
    proxy_read_timeout 60s;
    proxy_intercept_errors on;
    error_page 400 404 500 502 @redirect;

    location / {
        proxy_pass http://remnawave-minishop$request_uri;
    }

    location @redirect {
        return 404;
    }
}

4. Выпуск SSL-сертификата для домена webhook

Убедитесь, что установлены необходимые компоненты, а также откройте 80 порт:

sudo apt-get install cron socat
curl https://get.acme.sh | sh -s email=EMAIL && source ~/.bashrc
ufw allow 80/tcp && ufw reload

Выпустите сертификат:

acme.sh --set-default-ca --server letsencrypt
acme.sh --issue --standalone -d 'webhook.domain.com' \
  --key-file /opt/remnawave/nginx/webhook_privkey.key \
  --fullchain-file /opt/remnawave/nginx/webhook_fullchain.pem

5. Добавление сертификатов в Docker Compose Nginx

Отредактируйте docker-compose.yml панели Nginx:

cd /opt/remnawave/nginx && nano docker-compose.yml

Добавьте две строки в секцию volumes:

services:
    remnawave-nginx:
        image: nginx:1.26
        container_name: remnawave-nginx
        hostname: remnawave-nginx
        volumes:
            - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
            - ./fullchain.pem:/etc/nginx/ssl/fullchain.pem:ro
            - ./privkey.key:/etc/nginx/ssl/privkey.key:ro
            - ./subdomain_fullchain.pem:/etc/nginx/ssl/subdomain_fullchain.pem:ro
            - ./subdomain_privkey.key:/etc/nginx/ssl/subdomain_privkey.key:ro
            - ./webhook_fullchain.pem:/etc/nginx/ssl/webhook_fullchain.pem:ro     # Добавьте эту строку
            - ./webhook_privkey.key:/etc/nginx/ssl/webhook_privkey.key:ro         # Добавьте эту строку
        restart: always
        ports:
            - '0.0.0.0:443:443'
        networks:
            - remnawave-network

networks:
    remnawave-network:
        name: remnawave-network
        driver: bridge
        external: true

6. Запуск бота и перезапуск Nginx

Запустите бота:

cd /root/remnawave-minishop && docker compose up -d && docker compose logs -f -t

Перезапустите Nginx:

cd /opt/remnawave/nginx && docker compose down && docker compose up -d && docker compose logs -f -t

🐳 Docker

Файлы Dockerfile и docker-compose.yml уже настроены для локальной сборки и запуска проекта.

Если нужен запуск из готового образа, используйте docker-compose-remote-server.yml как шаблон и укажите свой image: вместо локальной сборки. По умолчанию он тянет ghcr.io/3252a8/remnawave-minishop:latest, а для закрепления версии можно задать IMAGE_TAG=3.1.0.

В GHCR доступны теги 3.1.0 и latest.

Чтобы использовать сохранённый образ, можно запустить:

IMAGE_TAG=3.1.0 docker compose -f docker-compose-remote-server.yml up -d

Вариант с Caddy

Если нужен reverse proxy на Caddy, используйте docker-compose-caddy.yml вместе с Caddyfile. Это удобный вариант, когда хочется, чтобы Caddy сам выпускал TLS-сертификаты и проксировал и webhook'и, и Mini App без ручной настройки Nginx.

В этой схеме:

  • Caddy публикует наружу 80 и 443.
  • Бот остается доступным только внутри docker-сети.
  • WEBHOOK_BASE_URL должен указывать на домен вебхуков, а SUBSCRIPTION_MINI_APP_URL - на домен Mini App.

Пример Caddyfile:

webhook.domain.com {
    encode zstd gzip
    reverse_proxy remnawave-minishop:{$WEB_SERVER_PORT:8080}
}

app.domain.com {
    encode zstd gzip
    reverse_proxy remnawave-minishop:{$WEBAPP_SERVER_PORT:8081}
}

Что нужно поменять под себя:

  • заменить webhook.domain.com и app.domain.com на свои домены;
  • убедиться, что в .env заданы WEBHOOK_BASE_URL=https://webhook.domain.com и SUBSCRIPTION_MINI_APP_URL=https://app.domain.com/;
  • при необходимости скорректировать WEB_SERVER_PORT и WEBAPP_SERVER_PORT, если они отличаются от стандартных 8080 и 8081.
  • в BotFather укажите домен Mini App через /setdomain, чтобы он совпадал с SUBSCRIPTION_MINI_APP_URL.

Запуск:

docker compose -f docker-compose-caddy.yml up -d --build

После этого Caddy сам выпустит сертификаты и будет проксировать webhook'и на порт 8080, а Mini App - на 8081.

🔄 Миграция с remnawave-tg-shop на remnawave-minishop

Короткая инструкция, автоматический запуск helper'а из raw и ручной вариант переноса вынесены в отдельный документ: docs/migration-to-minishop.md.

📁 Структура проекта

.
├── bot/
│   ├── app/                          # Сборка приложения (фабрики, контроллеры, Web App)
│   │   ├── controllers/              # Запуск Aiogram dispatcher
│   │   ├── factories/                # Фабрики сервисов (платежи, панель и т.д.)
│   │   └── web/                      # Web App / Mini App (сервер, аутентификация, шаблоны)
│   ├── filters/                      # Пользовательские фильтры Aiogram
│   ├── handlers/                     # Обработчики сообщений и колбэков (admin/, user/)
│   ├── keyboards/                    # Клавиатуры
│   ├── middlewares/                  # Промежуточные слои (i18n, проверка бана и т.д.)
│   ├── services/                     # Бизнес-логика (платёжные шлюзы, API панели, email и т.д.)
│   ├── states/                       # Состояния FSM (admin/user)
│   ├── utils/                        # Вспомогательные утилиты
│   ├── routers.py                    # Регистрация всех роутеров Aiogram
│   └── main_bot.py                   # Основная логика бота
├── config/
│   └── settings.py                   # Настройки Pydantic
├── db/
│   ├── dal/                          # Слой доступа к данным (DAL)
│   ├── database_setup.py             # Настройка БД и подключения
│   ├── migrator.py                   # Миграции схемы при старте
│   └── models.py                     # Модели SQLAlchemy
├── locales/                          # Файлы локализации (ru.json, en.json)
├── scripts/                          # Сборка JS Web App, обновление копий Telegram JS и миграционный helper
├── tests/                            # Pytest-тесты
├── .env.example                      # Пример файла с переменными окружения
├── Caddyfile                         # Пример конфигурации Caddy
├── Dockerfile                        # Multi-stage сборка (Python + Node для Web App)
├── docker-compose.yml                # Локальная сборка и запуск
├── docker-compose-caddy.yml          # Запуск с Caddy в качестве reverse proxy
├── docker-compose-remote-server.yml  # Запуск из готового образа GHCR
├── package.json                      # Frontend-зависимости (Tailwind, esbuild) и сборка Web App
├── requirements.txt                  # Зависимости Python
└── main.py                           # Точка входа в приложение

❤️ Поддержка

  • Crypto: USDT/Other ERC-20 0xeD506D44aae634fEc0E01C8835744fBedb7B2a44 (Ethereum/Polygon/Gnosis)
Reference in New Issue View Git Blame Copy Permalink