Utilitzar Matterbridge
El següent es basa en un tutorial per utilitzar Matterbridge amb el connector: Matterbridge + Peertube
Requisits
- Connector de PeerTube Livechat versió 3.2.0 o posterior.
- Matterbridge versió 1.22.4 o posterior.
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.
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.