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

• PeerTube plugin livechat verze 3.2.0 nebo novější.
• Matterbridge verze 1.22.4 nebo novější.

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.