Версия 3.4.5+

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

Руководство по развертыванию, настройке и масштабированию проекта на базе 3X-UI, Remnawave.

Скриншот веб-админки 3XUIStore

Веб-панель администратора

О проекте

3XUIStore — модульная асинхронная платформа (Python / Aiogram) для создания и продажи подписок. Система позволяет управлять определенным количеством серверов 3X-UI и Remnawave через единый интерфейс.

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

  • Мультисерверность: подключение серверов через API с мониторингом CPU, RAM, сети в реальном времени.
  • Два провайдера: работа с 3X-UI, Remnawave или их совместном режиме.
  • Биллинг: интеграция платежных систем: Platega, Yookassa, Yoomoney, Cryptobot, Telegram Stars.
  • SUBPAGE & Личный кабинет: отдельные веб-интерфейсы для пользователей с автоматической настройкой подключения.
  • Гибкая безопасность: ограничение по HWID, Limit IP, математическая капча, обязательная подписка на канал.
  • Xray JSON: генерация готового конфига для клиентов — из шаблона (3X-UI) или напрямую от Remnawave API.

Архитектура

Проект состоит из нескольких независимых сервисов, каждый запускается отдельно:

  • Бот — ядро системы, Aiogram 3. Управляет пользователями, платежами и подписками.
  • Веб-Админка — Quart-платформа для удобного управления проектом.
  • SUBPAGE — страница подписки для клиентов. На отдельном сервере или на том же сервере, что и бот.
  • Личный кабинет — веб-кабинет пользователя для управления подпиской.
  • xuiweb — внутренний API между ботом и SUBPAGE и другими сервисами.

Требования

  • Ubuntu 24.04
  • Python 3.12
  • Сервер для бота 2 GB RAM/1 vCPU
  • Сервер для SUBPAGE 1 GB RAM/1 vCPU
  • Сервер для Личного кабинета 1 GB RAM/1 vCPU проксирующий сервер
💡
Для быстрого старта перейдите в раздел Первичная установка. Там находится пошаговый скрипт развёртывания.