Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Um WhatsApp, Telegram und Discord zu verbinden, müssen drei separate Bridges eingerichtet, jede als Anwendungsdienst registriert und der jeweilige Anmeldevorgang genutzt werden. Erfolg bedeutet, dass jeder Bot eine authentifizierte Sitzung meldet und Testnachrichten in beide Richtungen über Portalräume übertragen werden; es genügt nicht, dass ein Bot lediglich online erscheint.

Dies richtet sich an Administratoren von Heimservern, die Anwendungsdienste zulassen. Sie können keine selbstgehostete Bridge zu matrix.org hinzufügen, es sei denn, die Administratoren bieten eine solche an; verwenden Sie stattdessen einen Server, den Sie kontrollieren, oder eine verfügbare gehostete Bridge. Die Projektdokumentation wurde am 10. Oktober 2026 geprüft.

1. Entscheiden Sie, was Sie verbinden möchten, und bereiten Sie den Server vor.

Es handelt sich um drei separate Dienste mit jeweils eigener Konfiguration, Registrierung, Datenbank und Anmeldung. Mautrix nutzt hauptsächlich Puppet: Nachrichten werden über Ihr verknüpftes Remote-Konto übertragen und erscheinen in Mautrix unter diesem Konto. Ein Relay-Bot funktioniert anders; wählen Sie ihn nur, wenn Sie eine geteilte Bot-Identität anstelle Ihres persönlichen Kontos verwenden möchten.

Sie benötigen einen anwendungsfähigen Homeserver, Administratorrechte und Netzwerkverbindungen zu jeder Bridge. Docker ist dokumentiert. Weisen Sie jeder Bridge ein eigenes Datenverzeichnis zu und wählen Sie ein Versionskennzeichen, das regelmäßig aktualisiert wird. Mautris weist darauf hin, dass dies latestmöglicherweise den letzten Commit anstelle einer Release-Version verfolgt.

Verwenden Sie pro Bridge eine separate Datenbank. Ein PostgreSQL-Server kann gemeinsam genutzt werden, die Datenbank selbst darf jedoch nicht mit einer anderen Bridge oder Synapse geteilt werden. Für kleinere Instanzen bietet sich SQLite an. Entscheiden Sie sich vor der Anmeldung für eine Ende-zu-Ende-Verschlüsselung, da deren nachträgliche Aktivierung für bestehende Portalräume schwierig ist.

Terminalverzeichnis mit separaten Ordnern mautrix-whatsapp, mautrix-telegram und mautrix-discord, die jeweils ihre eigene Konfigurations- und Datenbankdatei enthalten.
Die Konfiguration und Datenbank jeder Bridge sollten sich in einem eigenen Arbeitsverzeichnis befinden, bevor die Container gestartet werden.

2. Konfigurieren und registrieren Sie alle drei Anwendungsdienste.

  1. Generieren Sie die Erstkonfiguration jeder Bridge. Folgen Sie der Docker-Einrichtungsseite für die jeweilige Bridge und starten Sie den Container einmalig mit dem eingebundenen Datenverzeichnis. Bearbeiten Sie die generierte Konfiguration, bevor Sie sie regulär starten. Tragen Sie die Domain und Adresse des Homeservers, die Bridge-Adresse, die Datenbank-URI und die Berechtigungen ein. Diese Werte sind spezifisch für Ihre Bereitstellung; verwenden Sie keine Beispiel-Secrets in der Produktionsumgebung.
  2. Verwenden Sie containererreichbare Adressen. Wenn Synapse und die Bridges sich ein Docker-Netzwerk teilen, kann die Homeserver-Adresse der Bridge den Synapse-Dienstnamen verwenden, z. B. `example.com` http://synapse:8008. Die Anwendungsdienstadresse muss auf den Dienstnamen und den Listening-Port dieser Bridge verweisen. localhostWenn die Adresse innerhalb eines Bridge-Containers auf denselben Container verweist, nicht auf Synapse oder eine andere Bridge, führt dies in der Regel zu Kommunikationsproblemen. Befindet sich der Homeserver außerhalb von Docker, veröffentlichen oder routen Sie stattdessen den benötigten Bridge-Port.
  3. Generieren und installieren Sie für jede Bridge eine Registrierungsdatei. Führen Sie den Setup-Befehl jeder Bridge aus, um deren Registrierungs-YAML zu generieren, und platzieren Sie anschließend alle drei Dateien an einem Ort, an dem Synapse sie lesen kann. Fügen Sie in der Datei `/etc/synapse/config/example.com` homeserver.yamlderen Pfade unter `/etc/ synapse/config/example.com` hinzu app_service_config_files, zum Beispiel:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Wenn Synapse in Docker ausgeführt wird, binden Sie die Registrierungsdateien im Synapse-Container ein. Starten Sie Synapse nach der Bearbeitung der Liste neu. Ein Tippfehler in der YAML-Datei, ein falscher Pfad, eine nicht lesbare Einbindung oder eine nicht übereinstimmende Bridge-Adresse können die Registrierung verhindern oder den Start von Synapse unterbrechen. Wenn Sie später registrierungsbezogene Bridge-Einstellungen ändern, generieren Sie die entsprechende Registrierungsdatei neu und starten Sie Synapse erneut.

Der Code-Editor zeigt die Synapse homeserver.yaml mit drei separaten Anwendungsregistrierungspfaden für WhatsApp, Telegram und Discord an.
Synapse benötigt für jede Bridge einen separaten, lesbaren Registrierungspfad, gefolgt von einem Neustart des Homeservers.
Container-Statusanzeige listet Synapse und drei Mauttrix-Bridge-Container auf, die auf einem gemeinsam genutzten Matrix-Netzwerk laufen.
Prüfen Sie, ob Synapse und alle drei Bridge-Container in einem Netzwerk laufen, in dem ihre Dienstnamen aufgelöst werden können.

3. Fügen Sie die dienstspezifischen Anmeldeinformationen hinzu und melden Sie sich an.

WhatsApp

Starten Sie mautrix-whatsapp und öffnen Sie eine Matrix-Direktnachricht mit dem Bridge-Bot @whatsappbot:your.server. Senden Sie eine Nachricht login qrund scannen Sie anschließend den QR-Code auf Ihrem Smartphone unter „Verknüpfte Geräte“. Warten Sie, bis der Bot die Authentifizierung bestätigt hat. Laut Dokumentation kann es bis zu einer Minute dauern, bis die Portalräume angezeigt werden. WhatsApp ist als Gerät verknüpft, es handelt sich also nicht um ein eigenständiges Cloud-Konto. Die Dokumentation besagt, dass die Verbindung zwischen verknüpften Geräten getrennt wird, wenn das Smartphone länger als zwei Wochen offline ist. Wenn Sie Ihr Smartphone nicht durchgehend nutzen können, überlegen Sie, ob diese Bridge Ihre Zuverlässigkeitsanforderungen erfüllt, bevor Sie sie für wichtige Chats verwenden.

Telegram

Erstellen Sie vor der Telegram-Anmeldung eine API-Anwendung unter my.telegram.org/apps und tragen Sie deren api_idWerte api_hashin die Konfiguration von mautrix-telegram ein. Diese API-Werte ermöglichen die Verbindung der Bridge zur Telegram-API; sie authentifizieren jedoch kein Telegram-Konto. Senden Sie anschließend eine Nachricht @telegrambot:your.serverund verwenden Sie login qrdie Option `--code`, indem Sie diese in der Telegram-App unter Einstellungen > Geräte > Desktop-Gerät verknüpfen scannen. Die Code-Option kann an eine bestehende Telegram-Sitzung anstatt per SMS übermittelt werden, und die Bridge kann Sie zur Eingabe Ihres Zwei-Faktor-Authentifizierungspassworts auffordern. Überprüfen Sie die Einstellungen für das Importieren älterer Nachrichten vor der Anmeldung; Änderungen nach der Erstellung von Portalräumen sind möglicherweise nicht mehr möglich.

Discord

Verwenden Sie für einen Server einen dedizierten Discord-Bot und nicht die Automatisierung Ihres persönlichen Kontos: Discord verbietet Self-Bots und kann Konten sperren. Erstellen Sie eine Anwendung und einen Bot im Entwicklerportal, aktivieren Sie nur die privilegierten Intents, die die Bridge benötigt und Ihre App abrufen kann, und laden Sie sie anschließend mit dem OAuth2-Bot-Scope und den minimalen Kanalberechtigungen ein. Der Intent-Zugriff ist richtliniengesteuert; ohne die erforderlichen Zugriffsrechte für Nachrichteninhalte oder Mitglieder funktionieren einige Funktionen möglicherweise nicht. In Matrix senden Sie eine Direktnachricht @discordbot:your.serverund folgen Sie den Anweisungen zur Anmeldung mit dem Bot-Token von mautrix-discord. Ein Bot bietet nicht denselben Zugriff auf persönliche Direktnachrichten wie eine Benutzerkonto-Bridge.

Ein Bridge-Konfigurationseditor, der eine Synapse-Dienstadresse, eine Mauttrix-WhatsApp-Dienstadresse und einen eindeutigen Bridge-Datenbanknamen anzeigt.
Überprüfen Sie den Dienst-Hostnamen, den Bridge-Listener und die eindeutigen Datenbankdetails in der jeweiligen Konfiguration jeder Bridge.

4. Testen Sie die Auslieferung und passen Sie anschließend nur die Ergebnisse an.

Senden Sie jedem Bridge-Bot eine Direktnachricht und bestätigen Sie den Authentifizierungsstatus. Senden Sie in einem Portalraum pro Dienst eine Testnachricht von Matrix und antworten Sie über die Remote-App. Stellen Sie sicher, dass beide Nachrichten im richtigen Raum ankommen. Bei Gruppen oder Discord-Kanälen prüfen Sie zunächst, ob das Bridge-Konto vorhanden ist und Lese-/Schreibberechtigungen besitzt. Ein erfolgreicher Login allein beweist noch keine Zustellung.

Wenn ein Bot keine Meldungen ausgibt, überprüfen Sie seine Protokolle auf fehlende Werte, Datenbankfehler oder Verbindungsprobleme mit dem Homeserver. Wenn die Anmeldung funktioniert, aber keine Räume angezeigt werden, überprüfen Sie die Portal- und Backfill-Einstellungen. Bei fehlenden Discord-Kanalnachrichten überprüfen Sie die Bot-Mitgliedschaft, Berechtigungen und den Zugriff auf Intents. Falls Synapse nicht startet, überprüfen Sie die YAML-Einrückung und die korrekte Einbindung der Registrierungsdatei.

Der Funktionsumfang variiert je nach Bridge-Version und Kontotyp; Anrufe, Reaktionen, verschlüsselte Chats, Medien und der Import des Verlaufs können abweichen oder nicht unterstützt werden. Prüfen Sie die aktuelle Funktionsliste der jeweiligen Bridge, bevor Sie diese als einzigen Zugriffspunkt nutzen. Beschränken Sie den Zugriff auf Registrierungsdateien und Zugangsdaten, sichern Sie Bridge-Daten sicher und widerrufen Sie verknüpfte Sitzungen oder Token, falls diese offengelegt wurden.

Verwenden Sie die aktuellen mautrix Docker-Anweisungen , die Registrierungsanleitung , die Konfigurationsreferenz sowie die Authentifizierungsseiten von WhatsApp , Telegram und Discord für versionsspezifische Befehle. Lesen Sie die Richtlinien von Discord für Self-Bots .

Einen Kommentar hinterlassen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Synapses Systemd-Dateilimit ohne Rätselraten erhöhen

Prüfen Sie, ob Synapse die maximale Anzahl offener Dateien pro Prozess erreicht hat, richten Sie ein systemd-Drop-in für den richtigen Dienst oder Worker ein und überprüfen Sie das aktuelle Limit.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Element zeigt „Entschlüsselung fehlgeschlagen“ an? Stellen Sie den fehlenden Raumschlüssel wieder her.

Finden Sie heraus, ob der Fehler auf einen bestimmten Browser oder ein bestimmtes Ereignis beschränkt ist, und verwenden Sie dann den Wiederherstellungsschlüssel von Element oder ein vertrauenswürdiges Gerät, ohne Ihre übrigen verschlüsselten Verlaufsdaten zu riskieren.

Alte Synapse-Nachrichten und Mediendateien bereinigen, ohne Daten zu verlieren

Verwenden Sie die Verlaufs- und Medienbereinigungs-APIs oder die Aufbewahrungseinstellungen von Synapse, um veraltete Daten sicher zu entfernen, und überprüfen Sie anschließend den Abschluss und die Wiederherstellung des Speicherplatzes.

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Erstelle einen Matrix-Echo-Bot in Python mit Simple-Matrix-Bot-Lib

Installieren Sie die aktuelle Bibliothek, verbinden Sie ein dediziertes Matrix-Konto und führen Sie einen kleinen !echo-Bot mit sichererer Anmeldeinformationsverwaltung und einem klaren Test aus.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Verbinde Matrix mit WhatsApp, Telegram und Discord über separate Brücken.

Richten Sie drei Mauttrix-Bridges mit separaten Registrierungen, Logins und Tests ein – und vermeiden Sie Überraschungen bei Docker-Netzwerken, Kontorichtlinien und Synchronisierung.

Synapse Media-Speicherplatz freigeben, ohne freigegebene Dateien zu beschädigen

Ermitteln Sie, was den Synapse-Speicher belegt, legen Sie eine sichere Medienaufbewahrung fest und leeren Sie den Remote-Cache, ohne Dateien direkt von der Festplatte zu löschen.

Inaktive Matrix-Benutzer deaktivieren, ohne den Raumverlauf zu löschen

Inaktive Matrix-Benutzer deaktivieren, ohne den Raumverlauf zu löschen

Überprüfen Sie die Geräteaktivität, deaktivieren Sie bestätigte inaktive Synapse-Konten über die Admin-API und erfahren Sie, was genau durch das optionale Löschflag entfernt wird.

PostgreSQL-Speicherdruck in Matrix Synapse reduzieren

Ermitteln Sie, ob der PostgreSQL-Speicher durch Abfragen, gemeinsam genutzte Puffer, Verbindungen oder Wartungsarbeiten belegt wird, und nehmen Sie dann gezielte, Synapse-sichere Änderungen vor.

Warum Matrix Synapse Room Joins langsam sind – und was Sie überprüfen sollten

Warum Matrix Synapse Room Joins langsam sind – und was Sie überprüfen sollten

Bevor Sie die Synapse-Einstellungen ändern, sollten Sie langsame Matrix-Raumbeitritte auf einen entfernten Homeserver, Federation-Backoff, lokale Datenbanklast oder eine ausgehende Senderwarteschlange zurückführen.

Matrix-Registrierungen schließen oder Einladungstoken auf Synapse anfordern

Unterbinden Sie die Erstellung offener Konten auf einem selbstgehosteten Synapse-Server oder beschränken Sie die Registrierung auf Einladung mit Registrierungstoken mit begrenzter Nutzungsdauer.