diff --git a/docs/MATRIX-TELEGRAM-BRIDGE.md b/docs/MATRIX-TELEGRAM-BRIDGE.md new file mode 100644 index 0000000..5cc0479 --- /dev/null +++ b/docs/MATRIX-TELEGRAM-BRIDGE.md @@ -0,0 +1,107 @@ +# Telegram-мост: почему в чате было грязно и что с этим делать + +**Разобрано 17.10.2026.** Записано потому, что разбор занял время, а +знание иначе потеряется. + +## Что происходит + +В комнате «Семья» на каждое сообщение из Matrix появлялась служебная +заметка: + +``` +⚠️ Your message was not bridged: You're not logged in (no usable logins found) +``` + +Плюс сообщения **дублировались**. Выглядело это так: + +``` +elena привет +elena привет +Telegram bridge bot +⚠️ Your message was not bridged: ... +``` + +## Причина + +Комната «Семья» — это **канал (супергруппа) в Telegram**, отражённый в +Matrix. В базе моста это видно прямо: + +``` +id = channel:3999041689 name = Семья is_supergroup = true +``` + +Мост не мог отправить сообщение из Matrix в Telegram: у отправителя +**нет входа** в Telegram через мост. На это мост и жаловался — +`no usable logins found` — а вместо сообщения клал заметку об ошибке. + +Ошибка в журнале моста, дословно: + +``` +ERR Failed to get user login to handle Matrix event + error="not logged in (no usable logins found)" + sender=@sergey:matrix.buryans.ru + portal_id=channel:3999041689 +``` + +**Кто такие эти 11 участников.** В комнате 4 настоящих человека и +7 теней Telegram (`@telegram_*`). Тени — это отражения участников +Telegram-группы, их создаёт сам мост. Пока мост работает, они будут; +это не мусор, а лица людей со стороны Telegram. + +## Что сделано + +1. Включён режим передачи в настройках моста: + `bridge.relay.enabled: true` (было `false`). Копия конфигурации + сохранена рядом с файлом. +2. Мост перезапущен, связь с Telegram и Matrix восстановлена. +3. Разобрано, **чего делать НЕ надо**: прописывать `bot_token` в + разделе `network` не нужно. Мост версии v0.31.0 использует + современный режим передачи: его включает `set-relay`, а в роли + передатчика выступает **обычный вход** в Telegram. У нас такой вход + есть — `Matrix_buryans_bot`, он подключён под вашим аккаунтом. + +## Что осталось сделать (одна команда от владельца) + +В комнате «Семья» отправить: + +``` +!tg set-relay +``` + +Это назначит ваш вход (`Matrix_buryans_bot`) передатчиком для этой +комнаты. После этого сообщения от тех, у кого своего входа нет, будут +уходить в Telegram одной строкой с подписью: + +``` +Роман: проверка +``` + +Ошибок и дублей при этом не будет. + +**Права проверены:** у вас уровень `admin`, у остальных — `user`. +Команда доступна вам и недоступна обычным участникам — это правильно. + +## Чего я НЕ смог проверить и почему + +Отправить проверочное сообщение **от вашего имени** я не могу: в базе +Synapse лежат только хеши токенов, а пароль от вашего аккаунта мне не +передавали. Поэтому фактическую проверку передачи надо делать вашими +руками: отправить сообщение в «Семью» из Element и посмотреть, дошло ли +оно до Telegram. + +Это честное ограничение, а не недоделка: передача сообщений от имени +человека требует его доступа. + +## Полезное на будущее + +* Конфигурация моста лежит в `/opt/mautrix-telegram/config.yaml` + **внутри CT 155**; в контейнер эта папка смонтирована как `/data`. + Файлы `/opt/mautrix-telegram/config.yaml` на хосте и `/data/config.yaml` + в контейнере — это один и тот же файл. +* Уровни доступа задаются в `bridge.permissions`: у нас `akadmin` — admin, + остальные — user. +* Тени Telegram (`@telegram_*`) убирать не нужно: они отражения живых + людей. Убирать надо только совсем пустые, если такие появятся. +* **Правило:** сообщения из Matrix уходят в Telegram только если у + отправителя есть вход ЛИБО в комнате назначен передатчик. Если ни + того, ни другого — будет заметка об ошибке на каждое сообщение.