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. Правила, которые нельзя нарушать
- Один вебхук на всю инфраструктуру. Вебхук — только у бота доступов
(
@Auth_buryans_bot). Telegram не разрешает одновременно вебхук и опрос: при попытке получитьTelegramConflictErrorи бот перестаёт работать. - Один опрашивающий бот. Опрос — только у администратора
(
@Adm_buryans_bot). Два опрашивающих с одним токеном конфликтуют между собой точно так же, как опрос с вебхуком. - Остальные три бота — только отправка. У них не должно быть ни вебхука, ни опроса. Проверять командой из раздела 6.
- Токен — никогда в Git. Ни в реестре, ни в workflow, ни в скрипте.
Только
.env(права 600) и Vaultwarden. - Новый бот — новая строка в этой таблице. Без записи в реестре бот считается временным и подлежит удалению.
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. Ротация токена
Достаточно одного действия, потому что у каждого бота ровно один владелец:
@BotFather→/revoke→ выбрать бота → получить новый токен.- Записать новый токен в файл из таблицы раздела 4 (права 600).
- Перезапустить соответствующий сервис:
- администратор:
pct exec 108 -- bash -c 'cd /opt/automation-lxc/telegram-admin-bot && docker compose up -d --force-recreate' - бот алертов: пересоздать контейнер
n8n - бот доступов: обновить значение в credentials n8n через веб-интерфейс
- администратор:
- Убедиться, что режим доставки не сбился (раздел 6).
- Обновить запись в 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. |