3X-UI-TGShopBot

KO | EN

gitlite — search

#javascript #python #ai #llm #go #linux #docker #java #windows #awesome-list #security #mcp #ios #open-source

3X-UI-TGShopBot

(★ 9)

🛡️ Мощный Telegram-бот для продажи VLESS-подписок с интеграцией 3x-ui API, платежной системой и встроенной веб-панелью администратора на Streamlit.

3X-UI-TGShopBot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 XRay VLESS/Reality Bot & Web Panel

![CodeQL](https://github.com/HOLKus/3X-UI-TGShopBot/actions/workflows/codeql-analysis.yml/badge.svg)
![Python](https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square&logo=python)
![Aiogram](https://img.shields.io/badge/aiogram-3.x-red?style=flat-square&logo=telegram)
![GitHub last commit](https://img.shields.io/github/last-commit/HOLKus/3X-UI-TGShopBot?style=flat-square&color=6f42c1)
![License](https://img.shields.io/github/license/HOLKus/3X-UI-TGShopBot?style=flat-square&color=28a745)

Профессиональное решение для автоматизации продаж и управления 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. Клонируйте репозиторий:
```bash
git clone https://github.com/HOLKus/3X-UI-TGShopBot.git
cd 3X-UI-TGShopBot
```

## 2. Запустите проект:
```bash
docker-compose up -d
```

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

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

## 1. Создайте окружение и установите зависимости:
```bash
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. Запустите веб-панель:
```bash
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](./LICENSE).

Demo - Полностью функциональный бот: Telegram: @ReduNet_bot
Связь с разработчиком: Telegram: @Redulum
---
*Developed with ❤️ by [HOLKus](https://github.com/HOLKus)*

3X-UI-TGShopBot

3X-UI-TGShopBot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

3X-UI-TGShopBot

3X-UI-TGShopBot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README