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.
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.