Files
buryan-infra/docs/MATRIX-TELEGRAM-BRIDGE.md
T
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

5.4 KiB
Raw Blame History

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 только если у отправителя есть вход ЛИБО в комнате назначен передатчик. Если ни того, ни другого — будет заметка об ошибке на каждое сообщение.