Utilitzar Matterbridge

El següent es basa en un tutorial per utilitzar Matterbridge amb el connector: Matterbridge + Peertube

Requisits

El més fàcil és si la instància PeerTube i Matterbridge s’executen al mateix servidor.

Només connexions internes (versió simple)

Haureu d’habilitar Activar les connexions client-servidor a la configuració del connector Livechat.

Això permetrà els clients XMPP locals connectar al servidor XMPP Prosody.

És possible que hàgiu d’afegir alguna línia al vostre /etc/hosts:

127.0.0.1       anon.exemple.cat room.exemple.cat

Substituïu exemple.cat pel nom de domini de la vostra instància. A continuació, podeu continuar amb la configuració de Matterbridge següent.

Permetre connexions externes (avançat)

De manera predeterminada el servidor XMPP Prosody intern només escolta a l’host local (127.0.0.1).

A les versions de Livechat >= 10.1.0, s’ha afegit una nova crida d’opció «interfícies de client a servidor» per permetre que això es pugui canviar.

Això afegeix una llista d’adreces IP per escoltar separades per comes (s’eliminaran espais).

També podeu utilitzar * per escoltar a totes les interfícies IPv4 i :: per a totes les interfícies IPv6. Això permet l’accés extern a la interfície client-servidor.

A continuació heu d’obrir el port C2S (per defecte 52822, però comproveu la configuració del connector per obtenir el valor actual) al vostre tallafoc perquè sigui accessible des d’Internet. Si no voleu utilitzar connexions C2S per a res que no sigui el vostre servei Matterbridge, hauríeu de restringir l’accés a aquest port a la IP del vostre servidor Matterbridge.

També heu d’afegir registres DNS (A i AAAA) per a «anon.exemple.cat» i «room.exemple.cat» (substituïu «exemple.cat» pel vostre nom de domini actual).

Si utilitzeu un port diferent de 5222 (port estàndard XMPP), també heu de configurar el registre SRV xmpp-client al port correcte.

Configurar Matterbridge

A la versió 1.22.4, Matterbridge va afegir suport per a connexions anònimes XMPP, necessàries per connectar-se al servidor Prosody integrat.

Per tant, al fitxer de configuració TOML heu de posar:

[xmpp.elmeupeertube]
Anonymous=true
Server="anon.exemple.cat:52822"
Muc="room.exemple.cat"
Nick="Matterbridge"
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
NoTLS=true
  • Substituïu exemple.cat pel nom de domini de la vostra instància.
  • Substituïu 52822 pel port actual si l’heu canviat.
  • elmeupeertube es pot substituir per un altre nom.
  • L’ús de peertube com a àlies (Nick) proporcionarà la icona PeerTube per als missatges superposats, que també es pot fer canviant la configuració de la superposició.
  • El paràmetre NoTLS=true us permet connectar-vos a un servidor amb certificats autofirmats.

Ara podeu afegir aquest compte a passarel·les i que faci de pont entre canals de xat.

Info

Aquesta documentació utilitza un compte anònim per connectar la passarel·la al xat. Però des de la versió 10.1.0 del Livechat, hi ha una nova manera de generar una fitxa d’autenticació a llarg termini, que us permet iniciar sessió amb el vostre compte. S’utilitza per a OBS docks. L’ús d’aquesta funció per a altres finalitats no està documentat i encara no s’admet oficialment. Si el voleu utilitzar de totes maneres, podeu sol·licitar una fitxa cridant a /plugins/livechat/router/api/auth/tokens. Per obtenir les capçaleres necessàries i el cos de la sol·licitud, només cal que mireu què passa quan genereu una nova fitxa per a OBS docks.