Matterbridge benutzen

Das Folgende basiert auf einem Tutorial zur Verwendung von Matterbridge mit dem Plugin: Matterbridge + Peertube

Anforderungen

Am einfachsten ist es, wenn die PeerTube-Instanz und Matterbridge auf demselben Server laufen.

Nur interne Verbindungen (EInfach)

Sie müssen Aktivieren von Client-Server-Verbindungen in den Einstellungen des Livechat-Plugins aktivieren.

Dadurch können XMPP-Clients von localhost eine Verbindung zum Prosody XMPP-Server herstellen.

Möglicherweise müssen Sie eine Zeile in Ihre Datei /etc/hosts hinzufügen:

127.0.0.1       anon.example.org raum.example.org

Ersetzen Sie example.org durch den Namen Ihrer tatsächlichen Instanzdomäne. Danach können Sie mit der Matterbridge-Konfiguration fortfahren.

Externe Verbindungen zulassen (Fortgeschritten)

Standardmäßig lauscht der interne Prosody XMPP-Server nur auf localhost (127.0.0.1).

Dem Livechat Plugin Versionen >= 10.1.0 wurde eine neue Option Client zu Server Netzwerkschnittstellen hinzugefügt, um dies zu ändern.

Es ermöglicht das Hinzufügen einer Liste von IPs, die abgehört werden sollen, durch Kommata getrennt (Leerzeichen werden entfernt).

Sie können auch * verwenden, um an allen IPv4-Schnittstellen zu lauschen, und :: für alle IPv6-Schnittstellen. Dadurch wird der externe Zugriff auf die Schnittstelle zwischen Client und Server ermöglicht.

Dann müssen Sie den C2S-Port (standardmäßig 52822, aber überprüfen Sie die Plugin-Einstellungen, um den aktuellen Wert zu erhalten) in Ihrer Firewall öffnen, damit er vom Internet aus erreicht werden kann. Wenn Sie C2S-Verbindungen nur für Ihren Matterbridge-Dienst verwenden möchten, sollten Sie den Zugriff auf diesen Port auf die IP Ihres Matterbridge-Servers beschränken.

Sie müssen auch DNS-Einträge (A und AAAA) für anon.example.org und room.example.org hinzufügen (ersetzen Sie example.org durch Ihren tatsächlichen Domänennamen).

Falls Sie einen anderen Port als 5222 (XMPP-Standardport) verwenden, müssen Sie auch den xmpp-client SRV record auf den richtigen Port setzen.

Matterbridge konfigurieren

In der Version 1.22.4 hat Matterbridge Unterstützung für anonyme XMPP-Verbindungen hinzugefügt, die für die Verbindung mit der eingebauten Prosody benötigt werden.

Setzen Sie also in die TOML-Konfigurationsdatei:

[xmpp.mypeertube]
Anonymous=true
Server="anon.example.org:52822"
Muc="raum.example.org"
Nick="Matterbridge"
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
NoTLS=true
  • Ersetzen Sie example.org durch den Namen Ihrer tatsächlichen Instanzdomäne.
  • Ersetzen Sie “52822” durch den tatsächlichen Port, wenn Sie ihn geändert haben.
  • mypeertube kann durch einen anderen Namen ersetzt werden.
  • Die Verwendung von peertube als Nick stellt ein PeerTube-Symbol für Overlay-Nachrichten zur Verfügung, kann aber auch mit einer Overlay-Konfigurationsänderung durchgeführt werden.
  • Die Einstellung NoTLS=true ermöglicht die Verbindung zu einem Server mit selbstsignierten Zertifikaten.

Jetzt können Sie dieses Konto zu Gateways hinzufügen und bestimmte Live-Übertragungskanäle weiterleiten.

Info

In dieser Dokumentation wird ein anonymes Konto verwendet, um die Brücke mit dem Chat zu verbinden. Aber seit dem Livechat v10.1.0 gibt es eine neue Möglichkeit, ein langfristiges Authentifizierungs-Token zu generieren, das es erlaubt, sich mit dem eigenen Konto zu verbinden. Dies wird für OBS docks verwendet. Die Verwendung dieser Funktion für andere Zwecke ist nicht dokumentiert und wird noch nicht offiziell unterstützt. Wenn Sie es trotzdem benutzen wollen, können Sie ein Token anfordern, indem Sie den Endpunkt /plugins/livechat/router/api/auth/tokens aufrufen. Um die benötigten Header und den Request Body zu erhalten, prüfe einfach, was passiert, wenn du ein neues Token für OBS Docks generierst.