3X-ui-ShopBot | Telegram-бот для продажи VPN

Установка и обновление • Баги и предложения • Поддержка по проекту • Группа для соискателей • Поддержать проект

3X-ui-ShopBot — комплексное решение для автоматизированной продажи VLESS‑конфигураций через Telegram с глубокой интеграцией в панель 3x‑ui и собственной веб‑панелью на базе Tabler.

Поддержка по проекту

👥 Группа для соискателей

Присоединяйтесь к нашей группе: 3xui-shopbot

---

🚀 Возможности

• Полная автоматизация: от регистрации до выдачи ключа после оплаты.
• Веб‑панель «все‑в‑одном»: сервера, тарифы, пользователи, платежи, логи, спидтесты.
• Мульти‑хост: любое число серверов 3x‑ui, централизованное управление.
• Гибкие тарифы: месяцы/цена для каждого хоста.
• Платежи: YooKassa, CryptoBot, Heleket, TON Connect (опционально чеки YooKassa).
• Принудительная подписка на канал.
• Тестовый период (trial).
• Реферальная система (несколько типов начислений).
• Встроенная поддержка: внешний саппорт‑бот либо контакт пользователя.
• Тест скорости по хостам: SSH‑speedtest + сетевой Net‑Probe.

---

🖼️ Скриншоты

Показать скриншоты

Панель — Дашборд	Панель — Настройки
Рефералы	Спидтесты
Бот — Главное меню	Бот — Админ‑меню
Бот — Настройки/Помощь

Клик по миниатюре откроет оригинал в полном размере.

---

⚠️ Требования

1. Сервер Ubuntu/Debian с доступом по SSH.
2. Домен, A‑запись которого уже указывает на IP сервера.
3. Установленная панель 3x‑ui на одном или нескольких серверах.

---

💻 Где купить сервер/домен

Если нет сервера/домена — можно приобрести здесь: Aeza

---

🛠️ Установка «под ключ»

Скрипт поставит Docker, Nginx, Certbot, скачает и развернёт бота и панель.

1. Подключитесь по SSH.

2. Выполните:

curl -sSL https://raw.githubusercontent.com/tweopi/3xui-shopbot/main/install.sh | sudo bash

curl -sSL https://raw.githubusercontent.com/baphosa/origa/main/install.sh | sudo bash

3. Следуйте инструкциям установщика:

• Введите домен (например, shop.example.com).
• Укажите email для SSL (Let's Encrypt).
• Скрипт автоматически поднимет контейнеры и выпишет сертификат.

4. По завершении получите URL панели и первичные доступы:

Веб‑панель: https://your-domain.com/login
Логин: admin
Пароль: admin

---

⚙️ Первичная настройка

1. Войдите в панель (https://your-domain.com/login) и сразу смените логин/пароль в «Настройки → Настройки панели».
2. Заполните Telegram‑параметры: Токен бота, Имя телеграмм бота, ID администратора в телеграмме.
3. Добавьте хост 3x‑ui в «Настройки → Управление хостами» (URL панели, логин/пароль 3x‑ui, inbound id).
4. Создайте тарифы для добавленного хоста (месяцы/цена).
5. Сохраните настройки и нажмите «Запустить бота» в шапке панели.

Бот готов к работе.

---

💳 Платёжные системы

Откройте «Настройки → Настройки платёжных систем» и заполните соответствующие поля.

YooKassa

• Укажите yookassa_shop_id и yookassa_secret_key.
• В кабинете YooKassa задайте URL вебхука: https://your-domain.com/yookassa-webhook Если при установке выбран порт 8443, то: https://your-domain.com:8443/yookassa-webhook
• При желании добавьте Почту для чеков

CryptoBot

• Получите токен в @CryptoBot → Crypto Pay.
• Включите вебхуки на https://your-domain.com/cryptobot-webhook (или с портом :8443).
• Укажите cryptobot_token в настройках.

Heleket

• Укажите heleket_merchant_id и heleket_api_key.

TON Connect (опционально)

• Укажите ton_wallet_address и tonapi_key для курсов.

---

🔗 Принудительная подписка и ссылки

В файле БД настроек заданы ключи (управляются через веб‑панель):

• force_subscription: включить/выключить обязательную подписку (true/false).
• channel_url: ссылка на канал/чат для подписки. Бот должен быть админом канала.
• terms_url, privacy_url: ссылки на условия и политику — используются в онбординге.

---

🧪 Тест скорости (Speedtest)

Тесты скорости доступны из админ‑меню бота и из панели.

Поддерживаются 2 метода:

• SSH‑Speedtest: запуск speedtest или speedtest-cli на удалённом сервере по SSH.
• Net‑Probe: лёгкая сетевая проверка доступности и задержки HTTP с панели до host_url.

Результаты сохраняются в БД (host_speedtests), отображаются в панели на дашборде у каждого хоста.

Настройки для SSH‑Speedtest на хосте

Откройте «Настройки → Управление хостами → SSH‑параметры» и заполните:

• ssh_host — адрес сервера.
• ssh_port — порт (по умолчанию 22).
• ssh_user — пользователь.
• ssh_password — пароль (или оставьте пустым, если используется ключ).
• ssh_key_path — путь к приватному ключу на машине, где запущена панель (контейнер).

Можно запустить «Автоустановку speedtest» из админ‑меню и из веб панели.

Запуск

• В боте: Админ‑меню → Speedtest → выбрать хост или «Запустить для всех».
• В панели: кнопка «Run speedtests» на дашборде (асинхронный запуск на сервере панели).

Фиксируются: ping_ms, jitter_ms, download_mbps, upload_mbps, сервер‑узел, статус и ошибки.

---

🤝 Реферальная система

Основные параметры — в таблице настроек, UI панели: «Настройки → Общие».

Типы начислений:

• Процент с покупки реферала
• Фиксированная сумма за покупку реферала
• Фиксированный бонус пригласившему при старте по реферальной ссылке

Дополнительно:

• — скидка для приглашённого (в процентах), если используется.
• — минимальная сумма на вывод/перевод (если реализовано в вашей бизнес‑логике).

Профиль пользователя отображает: число приглашённых и суммарно заработано по рефералке (см. get_referral_balance_all). Рефссылка формируется как https://t.me/<bot_username>?start=ref_<telegram_id>.

---

🆘 Настройки поддержки (Support)

В панели доступны два режима поддержки:

1. Внешний саппорт‑бот

   • Поля: support_bot_token, support_bot_username, support_text.
   • Пользователи переходят в отдельного бота по кнопке в разделе «Помощь».

2. Внешний контакт

   • Поле: support_user (например, @username).
   • Кнопка ведёт в личные сообщения указанному контакту.

Дополнительно: support_forum_chat_id — ID форума/топиков для расширенных сценариев (при наличии).

---

🔄 Управление и обновление

Все команды выполняются в каталоге проекта на сервере (папка 3xui-shopbot).

Просмотр логов в реальном времени:

docker-compose logs -f

Остановка контейнеров:

docker-compose down

Запуск в фоне:

docker-compose up -d

Обновить бота до последней версии:

curl -sSL https://raw.githubusercontent.com/tweopi/3xui-shopbot/main/install.sh | sudo bash

docker-compose down && docker-compose up

🙌 Баги и предложения

Если вы нашли баг, или у вас есть предложение, то создавайте "Issue" или присылайте Pull Request'ы. Так же можно со мной связаться @tweopi

💎 Поддержать разработку

СБП/Карта РФ: Нажать чтобы поддержать Т-Банк:Нажать чтобы поддержать

Я ценю любой вклад в развитие проекта ❤️