Документация

Полное руководство по установке, настройке и использованию VPS Manager Bot

Быстрый старт

Установка и запуск за 5 минут

Системные требования

Минимальные

  • Ubuntu 22.04+
  • Python 3.10+
  • 1 GB RAM
  • 10 GB Disk

Рекомендуемые

  • Ubuntu 24.04 LTS
  • Python 3.11+
  • 2 GB RAM
  • 20 GB SSD + 2 CPU cores
Совет

Для мультисерверного управления с 10+ нодами рекомендуется выделить отдельный VPS под бота с 4 GB RAM.

Подготовка

  1. Получите токен бота Напишите @BotFather и создайте нового бота командой /newbot
  2. Узнайте свой Telegram ID Отправьте любое сообщение @userinfobot — он вернет ваш ID
  3. Подготовьте сервер Установите необходимые пакеты командой ниже 
sudo apt update && sudo apt install -y curl git

Установка одной командой

Запустите универсальный скрипт установки:

bash <(wget -qO- https://raw.githubusercontent.com/jatixs/tgbotvpscp/main/deploy.sh)

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

Secure Mode Рекомендуется

Изолированный пользователь, мониторинг ресурсов, управление Docker-контейнерами и сервисами, бэкапы

Root Mode

Полный доступ: перезагрузка сервера, системные логи (journalctl), оптимизация, Fail2Ban, SSH-мониторинг

Сравнение режимов

Secure: CPU/RAM/Disk мониторинг, Docker, systemd-сервисы, веб-панель, ноды
Root добавляет: reboot/shutdown, journalctl, sysctl-оптимизация, Fail2Ban, SSH-логи, apt upgrade

После выбора режима введите:

  • Bot Token — токен от @BotFather
  • Admin User ID — ваш Telegram ID
Готово!

Бот запущен! API и веб-интерфейс доступны на http://YOUR_IP:8080

Подключение удаленных серверов

Добавление нод для мультисерверного управления

На главном боте:

1
Откройте меню нод Ноды в главном меню
2
Создайте новую ноду Добавить ноду → имя
3
Скопируйте токен Сохраните для следующего шага

На удаленном сервере:

bash <(wget -qO- https://raw.githubusercontent.com/jatixs/tgbotvpscp/main/deploy.sh)

Выберите 7) Установить НОДУ (Клиент) и введите:

  • URL агента: http://MAIN_IP:8080
  • Токен ноды
Автоматическая установка

Можно передать параметры сразу:
bash <(wget -qO- .../deploy.sh) --agent=http://IP:8080 --token=TOKEN

Успех!

Нода появится в списке через несколько секунд. Вы можете мониторить состояние ноды в одном окне/чате!

Веб-интерфейс

Доступ и использование веб-панели управления

Доступ к веб-панели

http://YOUR_SERVER_IP:8080
Авторизация

HTTP: Ваш Telegram ID + пароль из установщика, или Magic Link из бота
HTTPS: Виджет Telegram (при привязке домена к боту в BotFather)

Как узнать свой Telegram ID?

Через @userinfobot или в боте: Управление → Пользователи → Мой ID

Основные функции панели

  • Графики CPU/RAM/Disk
  • Список всех нод
  • Настройки оповещений
  • Менеджер сервисов
  • История уведомлений
  • Управление пользователями
Мобильная версия

Веб-интерфейс полностью адаптирован для мобильных устройств. Управляйте сервером с телефона!

Конфигурация

Настройка и персонализация бота

Основные настройки (.env)

# Telegram Bot
BOT_TOKEN=your_bot_token
ADMIN_ID=your_telegram_id

# Web Server
WEB_PORT=8080
SECRET_KEY=auto_generated

# Database
DATABASE_URL=sqlite:///data/database.db

# Security
ENABLE_WAF=true
ENABLE_RATE_LIMIT=true
MAX_LOGIN_ATTEMPTS=5
Автоматическая конфигурация

Большинство настроек генерируются автоматически при установке. Редактируйте .env только при необходимости.

Настройки алертов

Можно изменить в веб-интерфейсе Settings → Alerts Config:

  • CPU: 80%
  • RAM: 90%
  • Disk: 85%
  • ⏱️ Интервал: 30 сек
Умные оповещения

Бот отправляет алерты только при превышении порогов и автоматически уведомляет, когда ситуация нормализовалась.

Безопасность

Управление доступом и защита системы

Смена пароля веб-интерфейса

1
Откройте настройки Настройки → Блок «Безопасность».
2
Заполните форму Будьте очень внимательны!
3
Нажмите «Сменить пароль» Пароль успешно сменён
Безопасность

Никогда не используйте стандартный пароль admin в продакшене! Смените его сразу после первого входа.

Управление пользователями

Добавление нового пользователя через Telegram:

1
Откройте меню Управление → Пользователи
2
Добавьте Добавить → Telegram ID
3
Назначьте роль Админы или Пользователи

Роли и права

Root Полный доступ ко всем функциям, включая управление пользователями
Админы Управление сервисами, мониторинг, настройка оповещений
Пользователи Только просмотр информации и статистики

Обслуживание

Мониторинг, обновление и резервное копирование

Просмотр логов

Docker:

docker logs tg-bot

Systemd:

sudo journalctl -u tg-bot -f

Перезапуск бота

Docker:

docker restart tg-bot

Systemd:

sudo systemctl restart tg-bot

Обновление до новой версии

cd /opt/tg-bot
git pull origin main
docker-compose down && docker-compose up -d --build
Автообновления

Встроено прямо из Telegram-бот!

Резервное копирование

Важные файлы для бэкапа:

/opt/tg-bot/.env Конфигурация бота
/opt/tg-bot/data/database.db База данных
/opt/tg-bot/data/configs/ Зашифрованные конфиги
Регулярный бэкап

Настройте cron-задачу для автоматического резервного копирования этих файлов на внешнее хранилище.

Дополнительная документация

Полезные ресурсы для углубленного изучения

Архитектура проекта

Структура кода, компоненты и их взаимодействие

Кастомные модули

Создание и подключение собственных модулей

История изменений

Полный список обновлений и новых функций

Известные проблемы

Открытые issues и отслеживание багов

Решение проблем

Часто встречающиеся проблемы и их решения

Бот не запускается

  • Проверьте правильность BOT_TOKEN
  • Убедитесь, что порт 8080 свободен: sudo netstat -tulpn | grep 8080
  • Проверьте логи: docker logs tg-bot

Нода не подключается

  • Проверьте доступность агента: curl http://AGENT_IP:8080/health
  • Убедитесь, что токен правильный
  • Проверьте firewall на агенте

Веб-интерфейс недоступен

  • Проверьте, что бот запущен: docker ps
  • Откройте порт 8080 в firewall: sudo ufw allow 8080/tcp
  • Попробуйте через localhost: http://localhost:8080

Нет оповещений

  • Проверьте настройки Alerts Config в веб-панели
  • Убедитесь, что бот не заблокирован в Telegram
  • Проверьте пороговые значения (CPU/RAM/Disk)

Нужна помощь?

Не нашли ответ в документации? Сообщество всегда готово помочь!
Задайте вопрос в Discussions или сообщите о баге в Issues

Обсуждения Сообщить о баге