Contents

  1. Matrix Synapse (Unterhaltungsserver)
    1. Was ist Matrix?
    2. Wie greif man auf Ihren Matrix Synapse-Server zu?
    3. Port-Weiterleitung
    4. Einrichten von Matrix Synapse auf Ihrer FreedomBox
    5. Einrichten von Audio-/Videoanrufen
    6. Verbung mit anderen Matrix-Instanzen
    7. Speichernutzung
    8. Fortgeschrittene Verwendung
    9. Externe Links

Matrix Synapse (Unterhaltungsserver)

Matrix Synapse Ikon

Verfügbar seit: Version 0.14.0

1. Was ist Matrix?

Matrix ist ein offenes Protokoll für interoperable, dezentrale Echtzeitkommunikation über IP. Synapse ist die Referenzimplementierung eines Matrix-Servers. Es kann zum Einrichten von Instant Messaging auf FreedomBox, um Unterhaltungsräume mit durchgängige verschlüßelte Kommunikation und Audio- / Videoanrufe zu hosten, verwendet werden. Matrix Synapse ist eine verbundete Anwendung, bei der Unterhaltungsräume auf jedem Server gehostet sein können und Benutzer von jedem Server im Verbundnetzwerk beitreten können. Lernen Sie mehr über Matrix.

2. Wie greif man auf Ihren Matrix Synapse-Server zu?

Wir empfehlen dem Client Element, um auf den Matrix Synapse-Server zuzugreifen. Sie können Element für Desktops herunterladen. Mobile Anwendungen für Android und iOS sind in den jeweiligen App Stores erhältlich.

3. Port-Weiterleitung

Wenn Ihre FreedomBox hinter einem Router steht, brauchen Sie die Portweiterleitung auf Ihrem Router einrichten. Sie sollten die folgenden Ports für Matrix weiterleiten:

4. Einrichten von Matrix Synapse auf Ihrer FreedomBox

Um Matrix Synapse einzuschalten, navigieren Sie zuerst zur Seite "Matrix Synapse (Unterhaltungsserver)" und installieren Sie es. Matrix braucht einen gültigen Domainnamen, um konfiguriert zu werden. Nach der Installation werden Sie aufgefordert, sie zu gestalten. Sie können eine Domain aus einem Aufklappmenü mit der verfügbaren Domains auswählen. Domänen werden über die Seite System -> Gestalten festgelegt. Nach der Domaingestaltung sieht man, daß der Dienst ausgeführt wird. Der Dienst ist über der festgelegten FreedomBox-Domain zugreiffbar. Sobald festgelegt, können Sie die Domain derzeit nicht mehr ändern.

Alle registrierten FreedomBox-Benutzer haben ihre Matrix-IDs als @benutzername: domain. Nach die öffentliche Registrierung angeschaltet ist, kann man auch Ihrer liebling Client für Benutzerregistrierung verwenden.

Wenn Ihre FreedomBox hinter einem Router (NAT) befindet, brauchen Sie vielleicht Coturn für Stimmeanrufe über IP.

5. Einrichten von Audio-/Videoanrufen

Der Matrix-Synapse-Server ist nur für den Aufbau von Anrufen zwischen Teilnehmern in Räumen zuständig. Matrix-Clients wie Element sind für die Übertragung des Audio-/Video-Verkehrs zuständig. Element unterstützt sowohl Einzelgespräche als auch Gruppenanrufe.

Bei Einzelgesprächen versucht Element, eine Peer-to-Peer-Verbindung zwischen den beiden Teilnehmern herzustellen. Dies funktioniert, wenn beide Teilnehmer Element auf Computern mit einer öffentlichen IP-Adresse verwenden oder wenn sie sich im selben Netzwerk befinden. Wenn sich beide Teilnehmer hinter verschiedenen NAT-Geräten befinden, ist es nicht möglich, eine direkte Peer-to-Peer-Verbindung zwischen ihnen herzustellen. Dieses Problem kann durch die Konfiguration von Matrix Synapse mit einem STUN/TURN-Server gelöst werden. FreedomBox bietet zu diesem Zweck eine App namens Coturn. FreedomBox installiert Coturn nicht automatisch bei der Installation von Matrix Synapse. Sobald jedoch die Coturn-App installiert ist, konfiguriert FreedomBox automatisch Matrix Synapse so, daß es für Audio-/Videoanrufe verwendet wird. Es ist möglich in der Weboberfläche, diese Konfiguration mit einem anderen STUN/TURN-Server zu überschreiben.

Für Gruppenanrufe mit mehr als zwei Teilnehmern (d. h. keine Einzelgespräche) verwendet Element eine externe Jitsi Meet-Instanz. Element verwendet jitsi.riot.im als Standard-Jitsi Meet-Instanz. Wenn der Matrix Synapse-Server so konfiguriert ist, daß eine andere Jitsi Meet-Instanz als Standardinstanz verwendet wird, verwendet Element diese stattdessen für alle Benutzer auf diesem Server.

6. Verbung mit anderen Matrix-Instanzen

Sie werden mit jeder anderen Person, die eine andere Matrix-Instanz ausführt, interagieren können. Dazu starten Sie einfach ein Gespräch mit ihnen unter Verwendung ihrer Matrix-ID, daß im Format @ihr-Benutzername:ihre-Domain lautet. Sie können auch Räumen beitreten, die sich auf einem anderen Server befinden, sowie Audio- bzw. Videoanrufe mit Kontakten anderer Servern führen.

7. Speichernutzung

Der in Python implementierte Synapse-Referenzserver ist bekanntermaßen sehr RAM-hungrig, insbesondere beim Laden großer Räume mit Tausenden von Mitgliedern wie #matrix: matrix.org. Es wird empfohlen, solche Räume nicht zu betreten, wenn Ihr FreedomBox-Gerät nur 1 GB RAM oder weniger hat. Räume mit bis zu hundert Mitgliedern sollten sicher sein. Das Matrix-Team arbeitet an einer neuen in Go geschriebenen Implementierung des Matrix-Servers namens Dendrite, die in Speichermangelhafte Systeme möglicherweise beßer leisten.

Einige große öffentliche Räume im Matrix-Netzwerk sind auch als IRC-Kanäle verfügbar (z.B. #freedombox: matrix.org ist auch als #freedombox auf irc.debian.org verfügbar). Für solchgroße Räume ist es beßer, IRC anstatt Matrix zu verwenden. Sie können den IRC-Kanälen mit Quassel beitreten .

8. Fortgeschrittene Verwendung

  1. Wenn Sie eine große Benutzermenge auf Ihrem Matrix Synapse-Server erstellen möchten, verwenden Sie als Root-Benutzer die folgenden Befehle auf einer Remote-Shell: 
    • cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1 | sed "s+^+registration_shared_secret: +" > /etc/matrix-synapse/conf.d/registration_shared_secret.yaml
chmod 600 /etc/matrix-synapse/conf.d/registration_shared_secret.yaml
chown matrix-synapse:nogroup /etc/matrix-synapse/conf.d/registration_shared_secret.yaml
systemctl restart matrix-synapse
register_new_matrix_user -c /etc/matrix-synapse/conf.d/registration_shared_secret.yaml
  2. Wenn Sie die Liste der in Matrix Synapse registrierten Benutzer anzeigen möchten, geben Sie als Root-Benutzer Folgendes an: 
    • apt install sqlite3
echo 'select name from users' | sqlite3 /var/lib/matrix-synapse/homeserver.db

  3. Wenn Sie in Matrix Synapse eine Gesellschaft erstellen wollen, brauchen Sie ein Matrix-Benutzer mit Serveraverwaltungsrechten. Um dem benutzernamen solche Berechtigungen zu erteilen, führen Sie die folgenden Befehle als Root-Benutzer aus: 

    • sudo apt install sqlite3
echo "UPDATE users SET admin=1 WHERE name='@benutzername:domainname'" | sudo sqlite3 /var/lib/matrix-synapse/homeserver.db

Zurück zur Einführung zu Funktionen oder Handbuch Seiten.

CategoryFreedomBox