Исходники Бесплатная панелька + бот ТГ

[SUNKEM_1]

​

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

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

🛠️ Установка "под ключ"​

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

1. Подключитесь по SSH.
2. Выполните:

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

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

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

1. По завершении получите 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). Реф-ссылка формируется как Telegram – a new era of messaging<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

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

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