Статья 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. Создайте бота в BotFather
Заголовок раздела «Шаг 1. Создайте бота в BotFather»- Откройте в Telegram @BotFather и отправьте
/newbot. - Введите отображаемое имя бота, затем username. Username должен заканчиваться на
bot, напримерmy_vps_panel_bot. - BotFather пришлёт токен вида
123456789:AA.... Это ключ к управлению ботом, не показывайте его никому. - Откройте своего бота и нажмите Start.
Шаг 2. Узнайте свой Telegram ID
Заголовок раздела «Шаг 2. Узнайте свой Telegram ID»Нужен числовой ID, а не username. Его покажет бот @userinfobot. Можно и позже: после настройки ваш бот 3x-ui ответит на команду /id вашим ID.
Для группы ID начинается с минуса, например -1001234567890. Чтобы бот писал в определённую тему форума, добавьте номер темы через двоеточие: -1001234567890:42.
Шаг 3. Настройте бота в панели
Заголовок раздела «Шаг 3. Настройте бота в панели»Откройте Настройки панели → Telegram-бот, вкладка Панель.

| Поле | Что ввести |
|---|---|
| Включить Telegram бота | включите |
| Telegram-токен | токен от BotFather |
| User ID администратора бота | ваш числовой ID. Несколько администраторов через запятую |
| Язык Telegram-бота | язык ответов бота, по умолчанию English, в списке есть «Русский» |
| Telegram API Server | оставьте пустым. Нужен только для своего сервера Bot API |
Нажмите Сохранить, затем Перезапустить панель. После этого кнопка Отправить тестовое сообщение должна прислать вам сообщение от бота. Напишите боту /start: администратору он покажет меню с кнопками.
Если сервер не может напрямую достучаться до Telegram, в Настройки панели → Панель есть поле Исходящий для трафика панели. Через выбранный исходящий Xray панель отправляет и запросы к Telegram.
Шаг 4. Уведомления и бэкапы
Заголовок раздела «Шаг 4. Уведомления и бэкапы»Вкладка Уведомления в настройках бота:

Частота уведомлений для администраторов от бота. Расписание периодического отчёта. По умолчанию @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.