Files
buryan-infra/docs/BOTS.md

6.8 KiB

Реестр Telegram-ботов

Обновлено: 2026-10-14 Проверено: все пять ботов отвечают, имена подтверждены запросом к Telegram API.

Значений токенов в этом файле нет и быть не должно. Токен каждого бота хранится ровно в одном месте — в .env соответствующего сервиса на сервере, права 600. Копия — в Vaultwarden. См. раздел «Ротация».


1. Кто за что отвечает

Роль Бот ID Режим работы Кто использует
Администратор @Adm_buryans_bot 8653974364 опрос (getUpdates) — двусторонний comms-agent на CT 108
Аварии и мониторинг @Buryans_AlertBot 8668603602 только отправка self-healing, бэкапы, слежение за версиями
Доступы и регистрация @Auth_buryans_bot 8698835423 вебхук → n8n workflow F6-2 (самообслуживание)
Рабочие задачи @Work_Buryan_bot 8754535508 только отправка задачи Gitea, еженедельный отчёт
Медиа @Media_buryans_bot 8760535198 только отправка медиа-стек (Sonarr, Radarr, Plex, Jellyfin)

Логика разделения простая: один бот — одна роль — один владелец — одно место хранения токена. Когда администратор, аварии и регистрация сидят на одном токене, невозможно ни понять, от кого пришло сообщение, ни отозвать доступ частично — а именно это и произошло 14.10.2026, когда три потребителя одновременно опрашивали бота Auth.


2. Правила, которые нельзя нарушать

  1. Один вебхук на всю инфраструктуру. Вебхук — только у бота доступов (@Auth_buryans_bot). Telegram не разрешает одновременно вебхук и опрос: при попытке получить TelegramConflictError и бот перестаёт работать.
  2. Один опрашивающий бот. Опрос — только у администратора (@Adm_buryans_bot). Два опрашивающих с одним токеном конфликтуют между собой точно так же, как опрос с вебхуком.
  3. Остальные три бота — только отправка. У них не должно быть ни вебхука, ни опроса. Проверять командой из раздела 6.
  4. Токен — никогда в Git. Ни в реестре, ни в workflow, ни в скрипте. Только .env (права 600) и Vaultwarden.
  5. Новый бот — новая строка в этой таблице. Без записи в реестре бот считается временным и подлежит удалению.

3. Маршрутизация сообщений

Событие Кто отправляет Куда
Команды /status, /issues, /runbook, /restart администратор, двусторонний чат владельца и комната Matrix
Падение сервиса, сбой бэкапа, восстановление @Buryans_AlertBot чат владельца
Доступна новая версия образа @Buryans_AlertBot чат владельца + задача в Gitea
Заявка на доступ, одобрение, выдача @Auth_buryans_bot чат владельца, кнопки одобрения
Новая задача или изменение в Gitea @Work_Buryan_bot чат владельца
События медиа-стека @Media_buryans_bot чат владельца

Чат владельца: 273442500.


4. Где лежит токен каждого бота

Бот Файл Хост
@Adm_buryans_bot /opt/automation-lxc/telegram-admin-bot/.env CT 108
@Buryans_AlertBot /opt/automation-lxc/docker-compose.yml (окружение n8n) и .env бота CT 108
@Auth_buryans_bot окружение workflow F6-2 (при переводе — в credentials n8n) CT 108
@Work_Buryan_bot ещё не подключён —
@Media_buryans_bot ещё не подключён —

5. Ротация токена

Достаточно одного действия, потому что у каждого бота ровно один владелец:

  1. @BotFather → /revoke → выбрать бота → получить новый токен.
  2. Записать новый токен в файл из таблицы раздела 4 (права 600).
  3. Перезапустить соответствующий сервис:
    • администратор: pct exec 108 -- bash -c 'cd /opt/automation-lxc/telegram-admin-bot && docker compose up -d --force-recreate'
    • бот алертов: пересоздать контейнер n8n
    • бот доступов: обновить значение в credentials n8n через веб-интерфейс
  4. Убедиться, что режим доставки не сбился (раздел 6).
  5. Обновить запись в Vaultwarden.

6. Проверка состояния

# на pve: проверяет всех ботов — имя, режим, вебхук (токены не печатает)
bash /root/verify-bots.sh /root/bots-tokens.env

Ожидаемая картина: вебхук — только у AUTH, у остальных пусто.


7. История

Дата Изменение
2026-10-14 Реестр создан. Обнаружено, что @Adm_buryans_bot использовался тремя потребителями одновременно (вебхук n8n, бот на VPS, бот на CT 108) — источник конфликта TelegramConflictError.
2026-10-14 Дубль админ-бота на VPS остановлен, два бота на CT 108 и VPS сведены в одного comms-agent.
2026-10-14 Выданы пять отдельных ботов; назначены роли согласно разделу 1.