Telegram-бот

Что даёт бот

Веб-интерфейс удобен, когда вы за компьютером. Но часто нужно быстро проверить статус сервера, посмотреть трафик или перезапустить Xray — с телефона, в дороге. Telegram-бот решает эту задачу: он работает как удалённый пульт для панели.

Бот не заменяет веб-интерфейс полностью, но покрывает большинство рутинных операций.

Возможности

Мониторинг

• Статус сервера — CPU, RAM, диск, uptime, нагрузка.
• Трафик — суммарный и по inbound'ам, за день/неделю/месяц.
• Активные клиенты — кто подключён прямо сейчас.
• Состояние Xray — запущен/остановлен, версия ядра.

Управление

• Перезапуск — Xray-core и панели.
• Клиенты — включить/отключить, сбросить трафик, продлить срок.
• Inbound'ы — просмотр статуса, перезапуск.

Уведомления

• Блокировка клиента (превышение лимита IP, исчерпание квоты).
• Истечение срока подписки.
• Ошибки Xray.
• Недоступность ноды (в мульти-нодовом режиме).

Настройка

В настройках панели 3x-ui есть раздел Telegram. Нужно указать:

• Bot Token — токен, полученный у @BotFather.
• Admin ID — ваш Telegram user ID (можно узнать у @userinfobot).
• Включить уведомления — какие события отправлять.

После сохранения бот запускается автоматически вместе с панелью. Проверить: отправить боту команду /start или /status.

Пример уведомления

🔔 Клиент user@example заблокирован
Причина: превышен лимит IP (3 > 2)
Inbound: VLESS-8443
Время: 2026-11-10 12:30:00 UTC

Такие уведомления приходят в реальном времени и позволяют быстро реагировать: увеличить лимит, продлить срок или связаться с пользователем.

Ограничения

• Бот работает только с одной панелью (мастер-нодой). Для управления нодами напрямую нужен отдельный бот на каждой.
• Чувствительные операции (например, смена пароля панели) через бота недоступны.
• Если сервер недоступен, бот тоже не отвечает — это не «внешний» мониторинг.