Black Fox Group
EN

Пошаговая инструкция

Обучающая статья Telegram Bot Expert Installer

Управляйте развертыванием ботов на Linux VPS через локальный веб-интерфейс Telegram Bot Expert Installer.

Страница продукта Скачать (ZIP) Частые вопросы и ошибки Ко всем руководствам

Архитектура и ключевые возможности

  • Локальный сервер: работает на http://127.0.0.1:4780/ и выполняет команды на сервере по SSH.
  • Поддержка 5 стеков: автоподготовка Python, Node.js, Go, PHP и Docker с сервисом systemd.
  • 4 языка и темы: русский, английский, персидский, китайский и тёмная/светлая тема.

Быстрый маршрут запуска

  • 1. Старт: запустите Start-Expert.bat или скрипт PowerShell.
  • 2. Мастер установки: режим (Webhook/Polling) → SSH → скан VPS → токен → источник → деплой.
  • 3. Обслуживание: Dashboard, Logs, Health и Backup.

1. Dashboard и управление сервисом

На экране Dashboard собраны статусы бота и ресурсы VPS:

  • Карточки статуса: статус бота, режим, CPU · RAM · Disk, @username и автозапуск при старте.
  • Кнопки управления: Start, Stop, Restart, Enable on Boot, Disable on Boot.
  • Язык и тема: кнопки Language и Theme вверху справа.
Примечание: до завершения установки карточки показывают Stopped и Offline.
Рис. 1: Dashboard
Рис. 1: Dashboard

2. 6-шаговый мастер установки (Webhook и Polling)

Во вкладке Install bot выберите путь установки:

  • Режимы: Install with Webhook (домен, SSL, Nginx, порт) или Install without Webhook (Polling).
  • Шаги 1–2 (SSH): хост, порт 22, логин и пароль или SSH-ключ с проверкой.
  • Шаг 3 (Скан VPS): ОС, ядра, RAM, диск, IP, открытые порты и проверки.
  • Шаги 4–6 (Бот и код): токен @BotFather, ID админа, каталог /opt/telegram-bot, Git-репозиторий или путь на сервере.
Совет: без домена выбирайте Polling.
Рис. 2: Install bot
Рис. 2: Install bot

3. Просмотр и экспорт логов (Logs)

Во вкладке Logs отслеживается работа сервиса:

  • Обновление и очистка: кнопки Refresh и Clear.
  • Экспорт: кнопка Download log сохраняет файл bot.log.
Рис. 3: Logs
Рис. 3: Logs

4. Проверка здоровья и авторемонт (Health & Repair)

Вкладки Health и Repair диагностируют сбои:

  • Статусы проверок: понятные метки готовности и проблем.
  • Авторемонт: кнопка исправления запускает починку по SSH.
Перед переустановкой: проверьте Health — многие ошибки чинятся в 1 клик.
Рис. 4: Health check
Рис. 4: Health check

5. Резервные копии и откат (Backup)

Вкладка Backup защищает ваши файлы:

  • Создание: Create Backup формирует архив .tgz и .meta.json.
  • Откат: кнопки Restore и Delete.
Рис. 5: Backup
Рис. 5: Backup

6. Удаление и обновления (Uninstall & Contact)

Безопасное удаление и контакты:

  • 3 режима в Uninstall: Remove app, Remove app and data и Remove everything (с Nginx и данными).
  • Contact: ссылки на foxnext.net, GitHub и Update.
Внимание: сохраняйте data/ перед Remove everything.
Рис. 6а: Uninstall
Рис. 6а: Uninstall
Рис. 6б: Contact
Рис. 6б: Contact

7. Частые вопросы и решения (FAQ)

Вопрос / ОшибкаПричинаРешение
Ошибка подключения VPS в Logs/HealthНет активной SSH-сессии.Пройдите шаг подключения SSH во вкладке Install bot.
Не проходит проверка домена WebhookDNS не указывает на VPS или закрыты порты 80/443.Настройте A-запись и файрвол либо выберите Polling.
Долгий первый запуск Start-Expert.batИдёт установка npm-пакетов и сборка.Не закрывайте консоль, дождитесь открытия 127.0.0.1:4780.
Как безопасно обновить файлы бота?Нужен снимок перед правками.Нажмите Create Backup в разделе Backup.
Страница продукта Открыть на GitHub Ко всем руководствам