Главная
» Как сделать
»
Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.
Подключите Matrix к WhatsApp, Telegram и Discord с помощью отдельных мостов.
Для подключения WhatsApp, Telegram и Discord необходимо запустить три отдельных моста, зарегистрировать каждый из них как службу приложения и выполнить вход через собственный процесс. Успех означает, что каждый бот сообщает об аутентифицированной сессии, а тестовые сообщения передаются в обоих направлениях через порталы; простого появления бота в сети недостаточно.
Это относится к администратору домашнего сервера, который разрешает использование сервисов приложений. Вы не можете добавить саморазмещенный мост на matrix.org, если его администраторы его не предлагают; используйте сервер, который вы контролируете, или доступный размещенный мост. Документация проекта была проверена 10 октября 2026 года.
1. Определите, к чему вы будете подключаться, и подготовьте сервер.
Это три отдельных сервиса, каждый со своей конфигурацией, регистрацией, базой данных и авторизацией. Mautrix в основном использует механизм Puppeting: сообщения передаются через вашу связанную удаленную учетную запись и отображаются в Matrix от имени этой учетной записи. Релейный бот работает иначе; выбирайте его только в том случае, если вам нужна общая идентификация бота, а не ваша личная учетная запись.
Для работы каждого моста вам потребуется домашний сервер с поддержкой сервисов приложений, административный доступ и сетевое подключение. Документация Docker имеется. Для каждого моста создайте собственный каталог данных и выберите поддерживаемый тег версии; заметки Mautrix могут latestотслеживать последний коммит, а не релиз.
Используйте отдельную базу данных для каждого моста; сервер PostgreSQL может быть общим, но сама база данных не должна использоваться совместно с другим мостом или Synapse. SQLite — вариант для небольших экземпляров. Решите вопрос о сквозном шифровании моста до входа в систему, поскольку его включение позже для существующих комнат портала будет затруднительным.
Перед запуском контейнеров храните конфигурацию и базу данных каждого моста в отдельном рабочем каталоге.
2. Настройте и зарегистрируйте все три службы приложения.
Сгенерируйте начальную конфигурацию для каждого моста. Следуйте инструкциям на странице настройки Docker для этого моста и запустите его контейнер один раз с подключенным каталогом данных. Отредактируйте сгенерированную конфигурацию перед обычным запуском. Заполните домен и адрес домашнего сервера, адрес моста, URI базы данных и права доступа. Эти значения специфичны для вашего развертывания; не вставляйте примеры секретов в рабочую среду.
Используйте адреса, доступные из контейнера. Когда Synapse и мосты используют общую сеть Docker, адрес домашнего сервера моста может использовать имя службы Synapse, например http://synapse:8008. Адрес службы приложения должен указывать на имя службы и порт прослушивания этого моста. localhostАдрес внутри контейнера моста указывает на тот же контейнер, а не на Synapse или другой мост, поэтому обычно это нарушает связь. Если домашний сервер находится вне Docker, вместо этого опубликуйте или перенаправьте необходимый порт моста.
Создайте и установите по одному регистрационному файлу для каждого моста. Запустите команду настройки каждого моста, чтобы сгенерировать его регистрационный YAML-файл, затем поместите все три файла туда, где Synapse сможет их прочитать. В файле homeserver.yamlдобавьте их пути в раздел app_service_config_files, например:
Если Synapse работает в Docker, смонтируйте файлы регистрации внутри контейнера Synapse. Перезапустите Synapse после редактирования списка. Опечатка в YAML-файле, неправильный путь, нечитаемый монтирование или несоответствующий адрес моста могут помешать регистрации или остановить запуск Synapse. Если вы позже измените настройки моста, связанные с регистрацией, сгенерируйте соответствующий файл регистрации заново и снова перезапустите Synapse.
Для работы Synapse требуется отдельный читаемый путь регистрации для каждого моста, после чего необходимо перезапустить домашний сервер.Убедитесь, что 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. Бот не предоставляет такой же доступ к личным сообщениям, как мост между учетной записью пользователя и учетной записью.
Проверьте имя хоста службы, прослушиватель моста и уникальные сведения о базе данных в конфигурации каждого моста.
4. Протестируйте доставку, затем внесите корректировки только в соответствии с полученными результатами.
Отправьте личное сообщение каждому боту-мосту и подтвердите статус аутентификации. В одной из комнат портала для каждого сервиса отправьте тестовое сообщение из Matrix и ответьте из удаленного приложения. Убедитесь, что оба сообщения дошли до нужной комнаты. Для групп или каналов Discord сначала убедитесь, что учетная запись моста присутствует и имеет права на чтение/публикацию. Успешный вход в систему сам по себе не доказывает доставку.
Если бот молчит, проверьте его логи на наличие отсутствующих значений, ошибок базы данных или проблем с подключением к домашнему серверу. Если вход в систему работает, но комнаты не отображаются, проверьте настройки портала и заполнения пропусков. В случае отсутствия сообщений в каналах Discord проверьте членство бота, разрешения и доступ к намерениям. Если Synapse не запускается, проверьте отступы YAML-файла и читаемость монтированных файлов регистрации.
Поддержка функций зависит от версии моста и типа учетной записи; звонки, реакции, зашифрованные чаты, медиафайлы и импорт истории могут отличаться или не поддерживаться. Перед тем как использовать мост в качестве единственной точки доступа, проверьте текущий список его функций. Ограничьте доступ к файлам регистрации и учетным данным, создавайте резервные копии данных моста и отзывайте связанную сессию или токен, если они были раскрыты.