Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Aby połączyć WhatsApp, Telegram i Discord, należy uruchomić trzy oddzielne mosty, zarejestrować każdy z nich jako usługę aplikacji i zalogować się za pomocą osobnego procesu. Sukces oznacza, że ​​każdy bot zgłasza uwierzytelnioną sesję, a wiadomości testowe są przesyłane w obie strony przez pokoje portalowe; samo pojawienie się bota online nie wystarczy.

To jest przeznaczone dla administratora serwera domowego, który zezwala na usługi aplikacyjne. Nie można dodać samodzielnie hostowanego mostu do matrix.org, chyba że administratorzy go zaoferują; należy użyć serwera, nad którym sprawujesz kontrolę, lub dostępnego hostowanego mostu. Dokumentacja projektu została sprawdzona 10 października 2026 r.

1. Zdecyduj, co podłączasz i przygotuj serwer

Są to trzy oddzielne usługi, każda z własną konfiguracją, rejestracją, bazą danych i logowaniem. Mautrix wykorzystuje głównie mechanizm „puppeting”: wiadomości są przesyłane przez połączone konto zdalne i pojawiają się w Matrixie jako to konto. Bot przekaźnikowy działa inaczej; wybierz go tylko wtedy, gdy chcesz korzystać ze wspólnej tożsamości bota, a nie z konta osobistego.

Potrzebujesz serwera domowego obsługującego usługi aplikacyjne, dostępu administratora i połączenia sieciowego z każdym mostem. Docker jest udokumentowany. Przypisz każdemu mostowi własny katalog danych i wybierz tag „wersja utrzymywana”; notatki Mautrix mogą latestśledzić najnowsze zatwierdzenie, a nie wydanie.

Użyj oddzielnej bazy danych dla każdego mostu; serwer PostgreSQL może być współdzielony, ale sama baza danych nie może być współdzielona z innym mostem ani Synapse. SQLite jest opcją dla małych instancji. Zdecyduj o szyfrowaniu typu „end-to-bridge” przed zalogowaniem, ponieważ późniejsze włączenie go w istniejących pokojach portalu jest trudne.

Lista katalogów terminala z oddzielnymi folderami mautrix-whatsapp, mautrix-telegram i mautrix-discord, z których każdy zawiera własny plik konfiguracji i bazy danych.
Przed uruchomieniem kontenerów należy zachować konfigurację i bazę danych każdego mostu w osobnym katalogu roboczym.

2. Skonfiguruj i zarejestruj wszystkie trzy usługi aplikacji

  1. Wygeneruj początkową konfigurację każdego mostu. Postępuj zgodnie ze stroną konfiguracji Dockera dla tego mostu i uruchom raz jego kontener z zamontowanym własnym katalogiem danych. Edytuj wygenerowaną konfigurację przed jej normalnym uruchomieniem. Wprowadź domenę i adres serwera domowego, adres mostu, URI bazy danych oraz uprawnienia. Wartości te są specyficzne dla Twojego wdrożenia; nie wklejaj przykładowych kluczy tajnych do środowiska produkcyjnego.
  2. Używaj adresów dostępnych dla kontenerów. Gdy Synapse i mosty współdzielą sieć Dockera, adres serwera macierzystego mostu może używać nazwy usługi Synapse, takiej jak http://synapse:8008. Adres usługi aplikacji musi wskazywać na nazwę usługi i port nasłuchu tego mostu. localhostAdres wewnątrz kontenera mostu wskazuje na ten sam kontener, a nie na Synapse ani inny most, więc zazwyczaj przerywa komunikację. Jeśli serwer macierzysty znajduje się poza Dockerem, opublikuj lub przekieruj wymagany port mostu.
  3. Wygeneruj i zainstaluj jeden plik rejestracyjny dla każdego mostu. Uruchom polecenie setup dla każdego mostu, aby wygenerować plik YAML dla rejestracji, a następnie umieść wszystkie trzy pliki w miejscu, w którym Synapse będzie mógł je odczytać. W pliku homeserver.yaml, dodaj ich ścieżki w app_service_config_files, na przykład:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Zamontuj pliki rejestracyjne w kontenerze Synapse, jeśli Synapse działa w Dockerze. Po edycji listy uruchom ponownie Synapse. Błąd w pliku YAML, nieprawidłowa ścieżka, nieczytelny montaż lub niezgodny adres mostu mogą uniemożliwić rejestrację lub uruchomienie Synapse. Jeśli później zmienisz ustawienia mostu związane z rejestracją, wygeneruj ponownie odpowiedni plik rejestracyjny i ponownie uruchom Synapse.

Edytor kodu pokazujący plik homeserver.yaml firmy Synapse z trzema oddzielnymi ścieżkami rejestracji usług aplikacji dla WhatsApp, Telegram i Discord.
Synapse wymaga oddzielnej, czytelnej ścieżki rejestracji dla każdego mostu, po której następuje ponowne uruchomienie serwera domowego.
Panel stanu kontenera wyświetlający Synapse oraz trzy kontenery mostu Mautrix uruchomione w sieci współdzielonej Matrix.
Sprawdź, czy Synapse i wszystkie trzy kontenery mostowe działają w sieci, w której nazwy ich usług są rozpoznawane.

3. Dodaj dane uwierzytelniające usługi i zaloguj się

WhatsApp

Uruchom aplikację Mautrix-WhatsApp i otwórz bezpośrednią wiadomość Matrix z botem mostu, zazwyczaj @whatsappbot:your.server. Wyślij login qr, a następnie zeskanuj kod QR z ekranu „Połączone urządzenia” WhatsApp na telefonie. Poczekaj, aż bot potwierdzi uwierzytelnienie; dokumentacja mostu informuje, że pojawienie się pokoi portalowych może zająć około minuty. WhatsApp jest połączony jako urządzenie, więc nie jest to samodzielne konto w chmurze. Dokumentacja mostu informuje, że połączone urządzenia rozłączają się, jeśli telefon pozostaje offline przez ponad dwa tygodnie. Jeśli nie możesz utrzymać telefonu w trybie aktywnym, zastanów się, czy ten most spełnia Twoje wymagania dotyczące niezawodności, zanim zaczniesz na nim polegać w ważnych rozmowach.

Telegram

Przed zalogowaniem się do Telegrama utwórz aplikację API na stronie my.telegram.org/apps i umieść jej api_idwartość ▲ api_hashw konfiguracji mautrix-telegram. Te wartości API umożliwiają mostowi połączenie z API Telegrama; same w sobie nie uwierzytelniają konta Telegrama. Następnie wyślij wiadomość @telegrambot:your.serveri użyj ▼ login qr, skanując ją z aplikacji mobilnej Telegrama w Ustawieniach, Urządzeniach i Połącz urządzenie stacjonarne. Opcja kodu może zostać wysłana do istniejącej sesji Telegrama, a nie SMS-em, a most może poprosić o podanie hasła do weryfikacji dwuetapowej. Sprawdź ustawienia uzupełniania mostu przed zalogowaniem, jeśli importowanie starszych wiadomości ma znaczenie; zmiana oczekiwań po utworzeniu pokoi w portalu może być zbyt późna.

Discord

W przypadku serwera użyj dedykowanego bota Discord, a nie automatyzacji swojego konta osobistego: Discord zabrania self-botów i może zamknąć konta. Utwórz aplikację i bota w Portalu Dewelopera, włącz tylko uprzywilejowane intencje wymagane przez most, które Twoja aplikacja może uzyskać, a następnie zaproś go z zakresem bota OAuth2 i minimalnymi uprawnieniami do kanału. Dostęp do intencji jest kontrolowany przez zasady; bez wymaganej zawartości wiadomości lub dostępu członka, niektóre funkcje mogą nie działać. W Matrix, wyślij wiadomość prywatną @discordbot:your.serveri postępuj zgodnie z instrukcjami logowania za pomocą tokena bota z Mautrix-Discord. Bot nie zapewnia takiego samego dostępu do wiadomości prywatnej, jak most konta użytkownika.

Edytor konfiguracji mostu pokazujący adres usługi Synapse, adres usługi mautrix-whatsapp i unikalną nazwę bazy danych mostu.
Sprawdź nazwę hosta usługi, nasłuchiwacza mostu i unikalne szczegóły bazy danych w konfiguracji każdego mostu.

4. Przetestuj dostawę, a następnie dostosuj tylko to, co pokazuje wynik

Napisz wiadomość prywatną do każdego bota mostu i potwierdź status uwierzytelnienia. W jednym pokoju portalu na usługę wyślij wiadomość testową z Matrix i odpowiedz z aplikacji zdalnej. Sprawdź, czy obie wiadomości dotrą do właściwego pokoju. W przypadku grup lub kanałów Discord najpierw sprawdź, czy konto mostu jest obecne i ma uprawnienia do odczytu/publikowania. Samo pomyślne zalogowanie nie jest dowodem na dostarczenie wiadomości.

Jeśli bot jest cichy, sprawdź jego logi pod kątem brakujących wartości, błędów bazy danych lub łączności z serwerem domowym. Jeśli logowanie działa, ale pokoje się nie pojawiają, sprawdź ustawienia portalu i uzupełniania. W przypadku brakujących wiadomości na kanale Discord sprawdź członkostwo bota, uprawnienia i dostęp do intencji. Jeśli Synapse nie uruchamia się, sprawdź wcięcia w YAML i czytelne montowania plików rejestracyjnych.

Obsługa funkcji różni się w zależności od wersji mostu i typu konta; połączenia, reakcje, szyfrowane czaty, multimedia i import historii mogą się różnić lub być nieobsługiwane. Sprawdź aktualną listę funkcji każdego mostu, zanim zaczniesz używać go jako jedynego punktu dostępu. Ogranicz dostęp do plików rejestracyjnych i danych uwierzytelniających, bezpiecznie twórz kopie zapasowe danych mostu i unieważniaj powiązaną sesję lub token w przypadku ujawnienia.

Skorzystaj z aktualnych instrukcji Mautrix Docker , przewodnika rejestracji , informacji o konfiguracji oraz stron uwierzytelniania WhatsApp , Telegram i Discord , aby zapoznać się z poleceniami specyficznymi dla danej wersji. Zapoznaj się z polityką Discord dotyczącą self-botów .

Zostaw komentarz

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.

Oczyść stare wiadomości i media Synapse bez utraty danych

Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.

Zmniejsz obciążenie pamięci PostgreSQL w Matrix Synapse

Sprawdź, czy pamięć PostgreSQL pochodzi z obsługi zapytań, współdzielonych buforów, połączeń czy konserwacji, a następnie wprowadź ukierunkowane zmiany bezpieczne dla Synapse.

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Śledź powolne dołączanie pokoju Matrix do jednego zdalnego serwera domowego, wycofywanie federacji, obciążenie lokalnej bazy danych lub kolejkę nadawcy wychodzącego przed zmianą ustawień Synapse.

Zamknij rejestrację w Matrix lub wymagaj tokenów zaproszeń w Synapse

Zatrzymaj możliwość tworzenia otwartych kont na samodzielnie hostowanym serwerze Synapse lub zachowaj możliwość rejestracji wyłącznie na zaproszenia, korzystając z tokenów rejestracyjnych o ograniczonym zastosowaniu.