Používání Matterbridge

Následující text vychází z návodu pro použití zásuvného modulu Matterbridge:Matterbridge + Peertube

Požadavky

Nejjednodušší je, pokud instance PeerTube a Matterbridge běží na stejném serveru.

Pouze interní připojení (základní)

V nastavení pluginu livechat je třeba povolit Povolení připojení klienta k serveru.

To umožní klientům XMPP na hostitelském serveru připojit se k serveru Prosody XMPP.

Možná budete muset přidat nějaký řádek do /etc/hosts:

127.0.0.1       anon.example.org room.example.org

Nahraďte example.org skutečným názvem domény vaší instance. Poté můžete pokračovat v níže uvedené konfiguraci Matterbridge.

Povolit externí připojení (pokročilé)

Ve výchozím nastavení interní server Prosody XMPP naslouchá pouze na serveru localhost (127.0.0.1).

Ve verzích livechatu >= 10.1.0 byla přidána nová volba Síťová rozhraní klienta a serveru, která umožňuje tuto volbu změnit.

Umožňuje přidat seznam IP adres pro poslech, oddělených čárkami (mezery budou odstraněny).

Můžete také použít * pro naslouchání na všech rozhraních IPv4 a :: pro všechna rozhraní IPv6. Tímto způsobem umožníte externí přístup k rozhraní mezi klientem a serverem.

Pak je třeba otevřít port C2S (ve výchozím nastavení 52822, ale aktuální hodnotu zjistíte v nastavení zásuvného modulu) ve firewallu, aby byl přístupný z internetu. Pokud nechcete používat připojení C2S pro nic jiného než pro službu Matterbridge, měli byste omezit přístup k tomuto portu na IP adresu vašeho serveru Matterbridge.

Je také třeba přidat záznamy DNS (A a AAAA) pro anon.example.org a room.example.org (example.org nahraďte skutečným názvem domény).

V případě, že používáte jiný port než 5222 (standardní port XMPP), musíte také nastavit xmpp-client SRV record na správný port.

Konfigurace Matterbridge

Ve verzi 1.22.4 přidal Matterbridge podporu anonymních připojení XMPP potřebných k připojení k vestavěnému prosodiu.

Do konfiguračního souboru TOML tedy vložte:

[xmpp.mypeertube]
Anonymous=true
Server="anon.example.org:52822"
Muc="room.example.org"
Nick="Matterbridge"
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
NoTLS=true
  • Nahraďte example.org skutečným názvem domény vaší instance.
  • Nahraďte 52822 skutečným portem, pokud jste jej změnili.
  • mypeertube lze nahradit jiným názvem.
  • Použití peertube jako Nick zajistí vložení ikony PeerTube pro překryvné zprávy, lze také provést pomocí úpravy konfigurace překryvu.
  • Nastavení NoTLS=true umožňuje připojit se k serveru s certifikáty podepsanými samotným uživatelem.

Nyní můžete tento účet přidat k branám a přemostit konkrétní kanály živého chatu.

Info

Tato dokumentace používá anonymní účet pro připojení bridge k chatu. Od verze livechat v10.1.0 však existuje nový způsob generování dlouhodobého ověřovacího tokenu, který umožňuje připojení pomocí vašeho účtu. To se používá pro OBS doky. Použití této funkce pro jiné účely není zdokumentováno a zatím není oficiálně podporováno. Pokud ji přesto chcete použít, můžete si vyžádat token zavoláním koncového bodu /plugins/livechat/router/api/auth/tokens. Chcete-li získat potřebné hlavičky a tělo požadavku, stačí se podívat, co se děje při generování nového tokenu pro doky OBS.