🚀 XRay VLESS/Reality Bot & Web Panel

Профессиональное решение для автоматизации продаж и управления VPN-доступом. Интегрируется с панелью 3x-ui (протокол VLESS Reality).

✨ Основные функции

• Автоматизация: Выдача тестового периода на 3 дня новым пользователям.
• Подключение: Генерация VLESS-ключей напрямую из бота через API 3x-ui.
• Оплата: Интегрированная платежная система (Telegram Invoices).
• Помощь: Интерактивные инструкции по настройке для Android, iOS, Windows и macOS.
• Админ-панель: Веб-интерфейс на Streamlit для управления пользователями, редактирования кода и просмотра логов.

🛠 Установка и запуск (Docker)

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

Python 3.10+

Панель управления 3X-UI

Создан inbound с параметром "Безопасность Reality"

Telegram бот (созданный через @BotFather)

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

git clone https://github.com/HOLKus/3X-UI-TGShopBot.git
cd 3X-UI-TGShopBot

2. Запустите проект:

docker-compose up -d

3. Доступ к админ-панели: http://IP_ВАШЕГО_СЕРВЕРА:8501

⚙️ Ручная установка

1. Создайте окружение и установите зависимости:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Настройка конфигурации Отредактируйте файл src/config.py. Обязательно заполните следующие поля: BOT_TOKEN — токен вашего бота от @BotFather. PAYMENTS_TOKEN — токен для оплаты (раздел Payments в BotFather). Параметры доступа к вашей панели 3x-ui (IP, Port, Login, Password).

2. Запустите веб-панель:

streamlit run admin_panel.py

После запуска перейдите по адресу, который выдаст терминал (обычно порт 8501), и нажмите кнопку «Запустить бота».

3. В веб-панели настройте токены и нажмите "Запустить бота".

🛠 Технологический стек

Язык: Python 3.10+

Библиотека бота: aiogram 3.x

Интерфейс админки: Streamlit

База данных: SQLite

Протокол: VLESS / Trojan / Shadowsocks (зависит от настроек 3x-ui)

👤 Авторы:

Проект собран на базе https://github.com/QueenDekim/XRay-bot

Переработал и добавил WEB-Panel - https://github.com/HOLKus/

⚖️ Лицензия

Этот проект распространяется под лицензией MIT. Это означает, что вы можете свободно использовать, копировать и изменять код, при условии сохранения уведомления об авторстве.

Подробности см. в файле LICENSE.

Demo - Полностью функциональный бот: Telegram: @ReduNet_bot Связь с разработчиком: Telegram: @Redulum

Developed with ❤️ by HOLKus