Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Для подключения WhatsApp, Telegram и Discord необходимо запустить три отдельных моста, зарегистрировать каждый из них как службу приложения и выполнить вход через собственный процесс. Успех означает, что каждый бот сообщает об аутентифицированной сессии, а тестовые сообщения передаются в обоих направлениях через порталы; простого появления бота в сети недостаточно.

Это относится к администратору домашнего сервера, который разрешает использование сервисов приложений. Вы не можете добавить саморазмещенный мост на matrix.org, если его администраторы его не предлагают; используйте сервер, который вы контролируете, или доступный размещенный мост. Документация проекта была проверена 10 октября 2026 года.

1. Определите, к чему вы будете подключаться, и подготовьте сервер.

Это три отдельных сервиса, каждый со своей конфигурацией, регистрацией, базой данных и авторизацией. Mautrix в основном использует механизм Puppeting: сообщения передаются через вашу связанную удаленную учетную запись и отображаются в Matrix от имени этой учетной записи. Релейный бот работает иначе; выбирайте его только в том случае, если вам нужна общая идентификация бота, а не ваша личная учетная запись.

Для работы каждого моста вам потребуется домашний сервер с поддержкой сервисов приложений, административный доступ и сетевое подключение. Документация Docker имеется. Для каждого моста создайте собственный каталог данных и выберите поддерживаемый тег версии; заметки Mautrix могут latestотслеживать последний коммит, а не релиз.

Используйте отдельную базу данных для каждого моста; сервер PostgreSQL может быть общим, но сама база данных не должна использоваться совместно с другим мостом или Synapse. SQLite — вариант для небольших экземпляров. Решите вопрос о сквозном шифровании моста до входа в систему, поскольку его включение позже для существующих комнат портала будет затруднительным.

Список содержимого каталога терминала с отдельными папками mautrix-whatsapp, mautrix-telegram и mautrix-discord, каждая из которых отображает свой собственный файл конфигурации и базы данных.
Перед запуском контейнеров храните конфигурацию и базу данных каждого моста в отдельном рабочем каталоге.

2. Настройте и зарегистрируйте все три службы приложения.

  1. Сгенерируйте начальную конфигурацию для каждого моста. Следуйте инструкциям на странице настройки Docker для этого моста и запустите его контейнер один раз с подключенным каталогом данных. Отредактируйте сгенерированную конфигурацию перед обычным запуском. Заполните домен и адрес домашнего сервера, адрес моста, URI базы данных и права доступа. Эти значения специфичны для вашего развертывания; не вставляйте примеры секретов в рабочую среду.
  2. Используйте адреса, доступные из контейнера. Когда Synapse и мосты используют общую сеть Docker, адрес домашнего сервера моста может использовать имя службы Synapse, например http://synapse:8008. Адрес службы приложения должен указывать на имя службы и порт прослушивания этого моста. localhostАдрес внутри контейнера моста указывает на тот же контейнер, а не на Synapse или другой мост, поэтому обычно это нарушает связь. Если домашний сервер находится вне Docker, вместо этого опубликуйте или перенаправьте необходимый порт моста.
  3. Создайте и установите по одному регистрационному файлу для каждого моста. Запустите команду настройки каждого моста, чтобы сгенерировать его регистрационный YAML-файл, затем поместите все три файла туда, где Synapse сможет их прочитать. В файле homeserver.yamlдобавьте их пути в раздел app_service_config_files, например:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Если Synapse работает в Docker, смонтируйте файлы регистрации внутри контейнера Synapse. Перезапустите Synapse после редактирования списка. Опечатка в YAML-файле, неправильный путь, нечитаемый монтирование или несоответствующий адрес моста могут помешать регистрации или остановить запуск Synapse. Если вы позже измените настройки моста, связанные с регистрацией, сгенерируйте соответствующий файл регистрации заново и снова перезапустите Synapse.

Редактор кода показывает файл Synapse homeserver.yaml с тремя отдельными путями регистрации сервисов приложений для WhatsApp, Telegram и Discord.
Для работы Synapse требуется отдельный читаемый путь регистрации для каждого моста, после чего необходимо перезапустить домашний сервер.
На панели состояния контейнеров отображается информация о том, что Synapse и три контейнера mautrix bridge работают в общей сети Matrix.
Убедитесь, что Synapse и все три контейнера-моста работают в сети, где разрешаются имена их служб.

3. Добавьте учетные данные для конкретной службы и войдите в систему.

WhatsApp

Запустите mautrix-whatsapp и откройте личное сообщение Matrix с помощью его бота-моста, обычно это @whatsappbot:your.server. Отправьте login qr, затем отсканируйте QR-код на экране «Связанные устройства» WhatsApp на своем телефоне. Подождите, пока бот подтвердит аутентификацию; в документации к мосту указано, что появление комнат портала может занять около минуты. WhatsApp связан как устройство, поэтому это не автономная облачная учетная запись. В документации к мосту указано, что связанные устройства отключаются, если телефон остается в автономном режиме более двух недель. Если вы не можете постоянно держать телефон активным, подумайте, соответствует ли этот мост вашим требованиям к надежности, прежде чем полагаться на него для важных чатов.

Telegram

Перед входом в Telegram создайте API-приложение на my.telegram.org/apps и укажите его api_idпараметры api_hashв конфигурации mautrix-telegram. Эти значения API позволяют мосту подключаться к API Telegram; сами по себе они не аутентифицируют учетную запись Telegram. Затем отправьте сообщение @telegrambot:your.serverи используйте login qrего, отсканировав его из мобильного приложения Telegram в разделе «Настройки», «Устройства» и «Связать настольное устройство». Код может быть доставлен в существующую сессию Telegram, а не по SMS, и мост может запросить ваш пароль для двухфакторной аутентификации. Проверьте настройки заполнения моста перед входом, если импорт старых сообщений имеет значение; изменение ожиданий после создания комнат портала может быть уже слишком поздно.

Discord

Для сервера используйте выделенного бота Discord, а не автоматизацию вашей личной учетной записи: Discord запрещает использование ботов, созданных самостоятельно, и может заблокировать учетные записи. Создайте приложение и бота на портале разработчика, включите только те привилегированные интенты, которые требуются мосту и которые может получить ваше приложение, затем пригласите его с областью действия бота OAuth2 и минимальными разрешениями канала. Доступ к интентам контролируется политиками; без необходимого содержимого сообщений или доступа участников некоторые функции могут не работать. В Matrix отправьте личные сообщения @discordbot:your.serverи следуйте инструкциям по входу через токен бота mautrix-discord. Бот не предоставляет такой же доступ к личным сообщениям, как мост между учетной записью пользователя и учетной записью.

Редактор конфигурации моста, отображающий адрес службы Synapse, адрес службы mautrix-whatsapp и уникальное имя базы данных моста.
Проверьте имя хоста службы, прослушиватель моста и уникальные сведения о базе данных в конфигурации каждого моста.

4. Протестируйте доставку, затем внесите корректировки только в соответствии с полученными результатами.

Отправьте личное сообщение каждому боту-мосту и подтвердите статус аутентификации. В одной из комнат портала для каждого сервиса отправьте тестовое сообщение из Matrix и ответьте из удаленного приложения. Убедитесь, что оба сообщения дошли до нужной комнаты. Для групп или каналов Discord сначала убедитесь, что учетная запись моста присутствует и имеет права на чтение/публикацию. Успешный вход в систему сам по себе не доказывает доставку.

Если бот молчит, проверьте его логи на наличие отсутствующих значений, ошибок базы данных или проблем с подключением к домашнему серверу. Если вход в систему работает, но комнаты не отображаются, проверьте настройки портала и заполнения пропусков. В случае отсутствия сообщений в каналах Discord проверьте членство бота, разрешения и доступ к намерениям. Если Synapse не запускается, проверьте отступы YAML-файла и читаемость монтированных файлов регистрации.

Поддержка функций зависит от версии моста и типа учетной записи; звонки, реакции, зашифрованные чаты, медиафайлы и импорт истории могут отличаться или не поддерживаться. Перед тем как использовать мост в качестве единственной точки доступа, проверьте текущий список его функций. Ограничьте доступ к файлам регистрации и учетным данным, создавайте резервные копии данных моста и отзывайте связанную сессию или токен, если они были раскрыты.

Используйте текущие инструкции по Docker-контейнеру Mautrix , руководство по регистрации , справочник по настройке , а также страницы аутентификации WhatsApp , Telegram и Discord для команд, специфичных для каждой версии. Ознакомьтесь с политикой Discord в отношении самостоятельных ботов .

Оставить комментарий

Увеличьте лимит файлов Systemd в Synapse без догадок.

Увеличьте лимит файлов Systemd в Synapse без догадок.

Проверьте, не превысил ли Synapse лимит на количество открытых файлов в одном процессе, установите параметр systemd для нужной службы или рабочего процесса и проверьте текущий лимит.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

На экране отображается сообщение «Не удалось расшифровать»? Восстановите отсутствующий ключ от комнаты.

Выясните, ограничивается ли ошибка одним браузером или одним событием, затем используйте ключ восстановления Element или доверенное устройство, не рискуя при этом оставшейся зашифрованной историей.

Удалите старые сообщения и медиафайлы Synapse без потери данных.

Используйте API Synapse для очистки истории и мультимедиа или настройки хранения данных, чтобы безопасно удалить устаревшие данные, а затем проверьте завершение процесса и восстановление дискового пространства.

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Создайте эхо-бота на основе матрицы на Python с помощью библиотеки Simple-Matrix-Bot-Lib.

Установите текущую библиотеку, подключите выделенную учетную запись Matrix и запустите небольшой бот !echo с более безопасной обработкой учетных данных и понятным тестом.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.

Настройте три моста Mautrix с отдельными регистрациями, входами в систему и тестами — и избегайте неожиданностей, связанных с сетевыми настройками Docker, политиками учетных записей и синхронизацией.

Освободите место на диске Synapse Media, не нарушая работу общих файлов.

Узнайте, что заполняет хранилище Synapse, установите безопасное время хранения медиафайлов и очистите удаленный кэш, не удаляя файлы непосредственно с диска.

Деактивация неактивных пользователей матрицы без удаления истории комнат.

Деактивация неактивных пользователей матрицы без удаления истории комнат.

Просматривайте активность устройства, деактивируйте подтвержденные неактивные учетные записи Synapse через Admin API и узнайте, что именно удаляет необязательный флаг удаления.

Снижение нагрузки на память PostgreSQL в Matrix Synapse

Определите, связана ли нехватка памяти в PostgreSQL с выполнением запросов, использованием общих буферов, соединениями или обслуживанием, а затем внесите целенаправленные изменения, безопасные для Synapse.

Почему соединение комнат в Matrix Synapse происходит медленно — и что следует проверить

Почему соединение комнат в Matrix Synapse происходит медленно — и что следует проверить

Перед изменением настроек Synapse отследите медленные подключения к комнатам Matrix до одного из удаленных домашних серверов, задержки федерации, загрузки локальной базы данных или исходящей очереди отправителя.

Закройте регистрацию в Matrix или требуйте токены приглашения в Synapse.

Прекратите создание новых учетных записей на собственном сервере Synapse или сделайте регистрацию доступной только по приглашениям с использованием регистрационных токенов ограниченного действия.