Перейти к содержимому

Статья 108 из 141

Гайды

Telegram-бот 3x-ui: токен BotFather, ID администратора, уведомления и бэкапы в Telegram

В 3x-ui встроен Telegram-бот. Он присылает администратору ежедневный отчёт о сервере, предупреждает о входах в панель и высокой нагрузке, может отправлять резервную копию базы. Через бота можно найти клиента, посмотреть его трафик, получить ссылку на подписку и QR-код. Ваши пользователи тоже могут проверять в боте свой расход.

Бот работает внутри самой панели, отдельный сервер или Docker не нужен. Статья написана по 3x-ui v3.11.0 (ноябрь 2026). Установка панели: руководство по 3x-ui.

Что Где взять
Работающая панель 3x-ui установка
Аккаунт Telegram ваш личный
Токен бота @BotFather
Ваш числовой Telegram ID @userinfobot или команда /id в вашем боте
Доступ сервера к api.telegram.org исходящий HTTPS с VPS

Серверу не нужен входящий порт для бота: панель сама опрашивает Telegram.

  1. Откройте в Telegram @BotFather и отправьте /newbot.
  2. Введите отображаемое имя бота, затем username. Username должен заканчиваться на bot, например my_vps_panel_bot.
  3. BotFather пришлёт токен вида 123456789:AA.... Это ключ к управлению ботом, не показывайте его никому.
  4. Откройте своего бота и нажмите Start.

Нужен числовой ID, а не username. Его покажет бот @userinfobot. Можно и позже: после настройки ваш бот 3x-ui ответит на команду /id вашим ID.

Для группы ID начинается с минуса, например -1001234567890. Чтобы бот писал в определённую тему форума, добавьте номер темы через двоеточие: -1001234567890:42.

Откройте Настройки панели → Telegram-бот, вкладка Панель.

Настройки Telegram-бота в 3x-ui: токен, ID администратора, язык

Поле Что ввести
Включить Telegram бота включите
Telegram-токен токен от BotFather
User ID администратора бота ваш числовой ID. Несколько администраторов через запятую
Язык Telegram-бота язык ответов бота, по умолчанию English, в списке есть «Русский»
Telegram API Server оставьте пустым. Нужен только для своего сервера Bot API

Нажмите Сохранить, затем Перезапустить панель. После этого кнопка Отправить тестовое сообщение должна прислать вам сообщение от бота. Напишите боту /start: администратору он покажет меню с кнопками.

Если сервер не может напрямую достучаться до Telegram, в Настройки панели → Панель есть поле Исходящий для трафика панели. Через выбранный исходящий Xray панель отправляет и запросы к Telegram.

Вкладка Уведомления в настройках бота:

Уведомления Telegram-бота 3x-ui: расписание отчётов, бэкап базы и события

Частота уведомлений для администраторов от бота. Расписание периодического отчёта. По умолчанию @daily, то есть каждый день в 00:00 по часовому поясу из Настройки панели → Панель → Дата и время. В списке есть @every (с интервалом), @hourly, @daily, @weekly, @monthly и Произвольный (crontab) для своего выражения:

@hourly каждый час
@every 8h каждые 8 часов
@weekly раз в неделю
0 9 * * * каждый день в 09:00

В отчёте: данные о сервере (версии, время работы, нагрузка, память), онлайн-клиенты, трафик и список клиентов, у которых закончился или скоро закончится трафик или срок.

Резервное копирование базы данных. Если включить, к периодическому отчёту прикладывается копия базы панели и конфигурации Xray. Это простой способ хранить бэкап вне сервера. Учтите, что в базе лежат все ключи и UUID клиентов. Держите чат с ботом только для себя и включите двухфакторную защиту Telegram. Другие способы бэкапа: резервные копии.

Telegram уведомления о событиях. Отметьте, о чём сообщать сразу:

Группа События
Безопасность Попытка входа в панель (удачная и неудачная, с IP). Включено по умолчанию
Система Превышение порога CPU (по умолчанию 80%, включено), превышение порога памяти
Ядро Xray Сбой Xray
Исходящие Исходящее подключение недоступно / снова работает
Узлы Узел недоступен / снова в сети (для нескольких серверов)

Пороги предупреждений о клиентах задаются в Настройки панели → Панель → Уведомления: Задержка уведомления об истечении сессии (за сколько дней до окончания срока) и Порог трафика для уведомления (сколько ГБ должно остаться). По умолчанию оба равны 0, то есть такие предупреждения выключены.

После изменений снова Сохранить и Перезапустить панель.

По официальной документации 3x-ui:

Команда Кто может Что делает
/start все приветствие и меню. Чужому аккаунту бот только сообщит его ID
/help админ и пользователи меню с кнопками
/status админ и пользователи проверка, что бот работает
/id все ваш числовой Telegram ID
/usage <email или UUID> админ и пользователи администратор ищет клиента, пользователь видит свой расход
/inbound <примечание> админ сведения о подключении
/restart админ перезапуск Xray

Через кнопки администратор также может смотреть отчёты по трафику, сбрасывать трафик, запрашивать бэкап базы, добавлять клиентов и получать для клиента ссылку на подписку и QR-код. Про подписки подробнее: подписки в 3x-ui.

Обычный пользователь видит в боте только своих клиентов. В v3.11 привязка делается из бота: администратор открывает карточку клиента и нажимает Ссылка-приглашение, затем отправляет пользователю ссылку t.me/.... Первый аккаунт, открывший её, привязывается ко всем клиентам с этим ID подписки. Поэтому ID подписки должен быть длинным и случайным. Аккаунты, не привязанные к клиентам, могут выполнять только /start и /id.

  • Токен бота даёт полный контроль над ботом. Если он утёк, отзовите его в BotFather командой /revoke и вставьте новый в панель.
  • В поле администраторов указывайте только свои ID. Администратор бота может добавлять клиентов и получать бэкапы.
  • Оповещения о входе не содержат паролей, но показывают IP и имя пользователя. Это полезно, чтобы заметить подбор пароля. Вместе с ботом настройте fail2ban и защиту панели.
Симптом Причина/решение
Бот молчит после сохранения Панель не перезапущена, бот выключен переключателем или вы не нажали Start в чате с ботом
Тестовое сообщение не приходит Неверный токен или ID. ID должен быть числом, а не @username
Ошибки соединения с Telegram в x-ui log Сервер не достаёт до api.telegram.org. Проверьте исходящий HTTPS, задайте Исходящий для трафика панели
Бот отвечает только своим ID Ваш ID не указан в поле администраторов, или аккаунт пользователя не привязан к клиенту
Отчёт приходит не в то время Расписание считается по часовому поясу панели. Проверьте поле Часовой пояс в Настройки панели → Панель → Дата и время
Нет бэкапа в отчёте Не включено Резервное копирование базы данных

Ошибки самой панели разобраны в статье диагностика 3x-ui. Для отдельного бота на своём коде смотрите развёртывание Telegram-бота на VPS.