Files
buryan-infra/docs/MATRIX-TELEGRAM-BRIDGE.md
root 144335143f Matrix: разбор Telegram-моста — почему в «Семье» была грязь
Разобрано по жалобе владельца: в комнате на каждое сообщение из Matrix
появлялась заметка «Your message was not bridged: You're not logged in
(no usable logins found)», плюс сообщения дублировались.

Причина. Комната «Семья» — это канал Telegram (channel:3999041689,
is_supergroup: true), отражённый в Matrix. Мост не мог отправить
сообщение из Matrix в Telegram: у отправителя нет входа в Telegram
через мост. Вместо сообщения он клал заметку об ошибке — отсюда и
ошибки, и дубли.

Про 11 участников: это 4 настоящих человека и 7 теней Telegram
(@telegram_*). Тени — отражения участников Telegram-группы, их создаёт
сам мост. Это не мусор, а лица людей со стороны Telegram.

Сделано: включён режим передачи (bridge.relay.enabled: true), мост
перезапущен. Отдельно разобрано, чего делать НЕ надо: прописывать
bot_token в разделе network не требуется — мост версии v0.31.0
использует современный режим передачи, где роль передатчика выполняет
обычный вход в Telegram (у нас это Matrix_buryans_bot).

Осталось владельцу: отправить «!tg set-relay» в комнате «Семья».
После этого сообщения тех, у кого своего входа нет, будут уходить в
Telegram одной строкой с подписью отправителя. Права проверены: у
владельца admin, у остальных user — команда доступна только ему.

Честно отмечено ограничение: отправить проверочное сообщение от имени
владельца я не могу — в базе Synapse только хеши токенов, пароль мне
не передавали. Поэтому фактическую проверку делает владелец, и это
записано в документе, а не умолчано.

Заодно в документе: где лежит конфиг моста (внутри CT 155, в контейнер
смонтирован как /data), где задаются права, и правило на будущее —
сообщения уходят в Telegram только если у отправителя есть вход ЛИБО
в комнате назначен передатчик.
2026-10-16 22:09:20 +03:00

108 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 только если у
отправителя есть вход ЛИБО в комнате назначен передатчик. Если ни
того, ни другого — будет заметка об ошибке на каждое сообщение.