Ajustaments

Aquesta secció descriu la pàgina de configuració del connector.

Condicions d’ús del xat del canal

Podeu configurar un missatge de «condicions del servei» que es mostrarà a les persones que s’uneixin a les vostres sales de xat.

Per obtenir més informació sobre aquesta funció, consulteu la documentació condicions d’ús del canal.

Info

Si canvieu aquesta configuració, es reiniciarà el servidor de xat i tots els usuaris es desconnectaran durant un breu període de temps.

Llistar sales existents

Quan premeu el botó «Llista de sales» s’enumeren totes les sales de xat existents, a continuació les podeu trobar i moderar.

Federació

La configuració següent es refereix a la federació amb altres instàncies de PeerTube i altres programes del fedivers.

No mostrar xats remots

Marcant aquest paràmetre, la vostra instància no mostrarà mai els xats dels vídeos remots.

No publiqueu informació de xat

En acceptar aquesta configuració, la vostra instància no publicarà la informació del xat al fediverse. Les instàncies remotes de Peertube no estaran al corrent de l’existència de sales de xat associades als vostres vídeos.
Tingueu en compte: si ja teniu xats en progrés, és possible que la informació ja hagi estat publicada. Haureu d’esperar a la propera actualització del vídeo abans que la informació sigui ocultada. A més, si desactiveu aquesta opció, haureu d’esperar a la propera actualització del vídeo abans que la informació sigui publicada una altra vegada. Aquesta actualització succeeix, entre d’altres, quan un esdeveniment en viu reprèn o s’atura.
Tingueu en compte: aquesta configuració només afecta la publicació d’informació mitjançant el protocol ActivityPub. No impedirà que una aplicació remota detecti la presència de xats i que intenti connectar-s’hi.

Autenticació

Desactivar les fitxes de Livechat

Si teniu problemes amb les fitxes d’autenticació a llarg termini, podeu desactivar aquesta funció aquí.

Autenticació externa

Vegeu la pàgina de documentació detallada:

Autenticació externa

Configuració avançada del canal

La configuració següent es refereix a les opcions avançades del canal: els usuaris podran personalitzar els seus canals, activar el bot de moderació, etc.

Desactivar la configuració avançada del canal i el bot de moderació

Si teniu un problema amb aquesta funció, podeu desactivar-la.

Comportament del xat

Tipus de sala

Podeu triar tenir diferents sales per a cada vídeo o agrupar-les per canal.

Obrir el xat automàticament

Quan es miri un vídeo el xat s’obrirà automàticament.

Mostrar el botó «obriu en una finestra nova»

Hi haurà un botó per obrir el xat en una finestra nova.

Mostrar el botó «Comparteix l’enllaç de la sala“

Aquesta funció us permet habilitar una finestra modal «comparteix l’enllaç de xat». Amb aquest modal podeu generar URL per unir-vos al xat. El xat es pot personalitzar (mode de només lectura, ús del tema actual, etc.).

Per exemple, podeu generar un URL de només lectura i utilitzar-lo a OBS per integrar el xat a la vostra emissió en directe!

Aquesta configuració us permet triar qui pot accedir a aquesta finestra modal.

Les persones poden activar el xat per als seus directes

Si es marca tots els vídeos en directe tindran una casella a les propietats per activar el xat.

El propietari del vídeo podrà activar el xat en línia.

Activar el xat per a tots els directes

Si està marcat hi haurà un xat a tots els directes.

Activar xat per als vídeos que no són en directe

Si està marcat hi haurà un xat per a tots els vídeos que no siguin en directe.

Activar el xat per a aquests vídeos

Poseu aquí els UUID dels vídeos per als quals vols forçar l’activació del xat. Poden ser en directe o no. Un UUID per línia.
Podeu afegir comentaris: s’eliminarà tot el que hi ha després del caràcter # i s’ignoraran les línies buides.
No afegiu vídeos privats perquè l’UUID es revelaria.

Amagar xat per a persones anònimes

Si està marcat, les persones que no hagin iniciat sessió no veuran els xats. Aquesta característica encara és experimental. Si l’heu activada, és molt recomanable que també marqueu «No publicar informació de xat». En cas contrari, determinades eines de tercers no podrien intentar obrir el xat i tindrien resultats impredictibles.

Nota: de moment, aquesta funcionalitat simplement amaga el xat. En una versió futura, el xat serà substituït per un missatge que especifiqui «si us plau connectar-vos […]». Consulteu les notes de la versió 5.7.0 per obtenir més informació.

Prohibir la IP de persones anònimes quan se’ls bandeja d’alguna sala

En activar aquesta opció cada vegada que una persona anònima és bandejada d’una habitació, la seva IP també quedarà prohibida del servidor de xat. Avís: si la vostra instància està oberta per a registres, algú podria crear una sala trampa, convidar-hi persones i prohibir automàticament les IP de les anònimes. La llista d’IP prohibides no es desa i s’eliminarà quan es reiniciï el servidor o si canvieu determinades configuracions del complement. Les IP prohibides es registren als registres del servidor de Prosody, de manera que els administradors del servidor poden utilitzar opcionalment eines externes (com ara fail2ban) per prohibir les IP de manera més àmplia.

Nota important: Si activeu aquesta funció i utilitzeu un servidor intermediari invers personalitzat davant de PeerTube, assegureu-vos que l’heu configurat correctament per reenviar IP d’usuari real a PeerTube. En cas contrari podria bloquejar tots els usuaris anònims alhora.

Tematització

Conjunt d’avatars

Podeu triar entre diversos jocs diferents els avatars predeterminats que s’utilitzaran per als usuaris de xat.

Sepia (mascota de Peertube): Generador d’avatars PeerTube de David Revoy, Llicència [CC-By](https://creativecommons .org/licenses/by/4.0/)

Exemple d’avatar de\nSepia Exemple d’avatar de\nSepia

Gats: Generador d’avatars de xat per David Revoy, Llicència [CC-By](https: //creativecommons .org/licenses/by/4.0/)

Exemple d’avatar de\ngats Exemple d’avatar de\ngats

Ocells: Generador d’avatars d’ocells de David Revoy, Llicència CC-By

Exemple d’avatar\nd’ocells Exemple d’avatar\nd’ocells

Fennecs (mascota de Mobilizon): Generador d’avatar fenec/mobilizon de David Revoy, Llicència CC-By

Exemple d’avatar de\nfenecs Exemple d’avatar de\nfenecs

Abstracte: Generador d’avatars abstractes de David Revoy, llicència [CC-By]( https: //creativecommons.org/licenses/by/4.0/)

Exemple d’avatar\nabstracte Exemple d’avatar\nabstracte

Avatars antics de Sepia (els inclosos en versions anteriors del complement): basat en el treball de David Revoy, llicència [AGPL-v3](https://www.gnu.org/licenses/agpl -3.0.fr.html)

Exemple d’avatar\n«llegat» Exemple d’avatar\n«llegat»

Si no veieu el canvi immediatament, es pot deure a la memòria cau del vostre navegador. Esborreu l’emmagatzematge de la sessió del navegador o reinicieu-lo.

Tema ConverseJS

Podeu triar el tema que voleu utilitzar per a ConverseJS:

  • Tema PeerTube: aquest és un tema especial, dissenyat específicament per a la integració a PeerTube.
  • Tema de ConverseJS predeterminat: aquest és el tema per defecte de ConverseJS.
  • Tema cyberpunk de ConverseJS: aquest és un tema proporcionat per ConverseJS.

Detecció de color automàtica

Intenta detectar automàticament els colors del tema actual.
Quan aquesta opció està activada el complement prova de detectar automàticament els colors per aplicar-los al tema del xat.
Si això no funciona correctament per a alguns dels vostres temes de Peertube, podeu desactivar aquesta opció. Podeu informar d’errors al gestor de tiquets . No oblideu especificar per a quin tema no funciona.

Atribut d’estil iframe de xat

Estils addicionals per aplicar a l’iframe de xat.
Exemple: height:400px;

Configuració avançada del xat

Utilitzeu el servidor Prosody instal·lat al sistema

El connector ve amb una AppImage que s’utilitza per executar el servidor XMPP Prosody. Si aquesta AppImage no funciona, podeu recórrer a la versió de Prosody empaquetada per al vostre servidor. Simplement instal·leu el paquet prosody.

Aquesta configuració només s’ha d’utilitzar si el connector està trencat i s’espera una solució.

Desactivar Websocket

Amb Peertube >= 5.0.0, aquest complement intentarà utilitzar Websocket per a connexions de xat. Si el navegador o la connexió utilitzada no és compatible, el navegador canviarà automàticament al protocol BOSH.
Però, en casos rars, pot fallar. Per exemple, si teniu un servidor intermediari invers davant del vostre Peertube que no permet connexions Websocket. En aquest cas podeu marcar aquesta opció per desactivar les connexions Websocket.

Port de Prosody

El port que utilitzarà el servidor Prosody.
Canvieu-lo si aquest port ja s’utilitza al vostre servidor.
Podeu tancar aquest port al vostre tallafoc, el món exterior no hi accedirà.
Nota: això pot canviar en un futur proper, ja que hi ha plans per afegir paràmetres per permetre connexions externes.

URL de Peertube per a peticions d’API

No toqueu aquest paràmetre si no sabeu què feu.
En casos excepcionals, el servidor de Prosody no pot alcançar l’API de Peertube mitjançant l’URL públic. Podeu utilitzar aquesta configuració per personalitzar l’URL que utilitzaran els mòduls de Prosody API de Peertube (per exemple, posant «http://localhost:9000» ó «http://127.0.0.1:9000»).

Si aquest paràmetre es deixa buit i utilitzeu PeerTube >= 5.1, el connector utilitzarà els valors del vostre fitxer de configuració de PeerTube per determinar en quina interfície i port s’han de fer les sol·licituds.

Com a últim recurs, utilitzarà l’URI públic de la vostra instància. Així, les crides a l’API passaran per Nginx. Això pot fallar en alguns casos: per exemple, si esteu en un contenidor Docker per al qual el nom d’amfitrió públic no es resol a la IP correcta. En aquest cas, proveu de canviar el paràmetre «URL de Peertube per a peticions d’API», posant http://127.0.0.1:9000 (si és el port 9000 que fa servir el vostre PeerTube, pregunteu als administradors de la vostra instància si no ho sabeu).

Desa registres de les sales per defecte

Si està marcat el contingut de les sales es desarà per defecte. Quan un usuari s’uneix a una sala, podrà veure què s’ha dit abans.
Tingueu en compte que sempre és possible activar/desactivar aquesta funcionalitat per a una sala específica, canviant-ne la configuració.

Caducitat dels registres de la sala

Podeu triar quant de temps es conserva el contingut de les sales al servidor. El valor pot ser:

  • 60: el contingut es desarà durant 60 segons. Podeu substituir 60 per qualsevol valor enter.
  • 1d: el contingut es desarà durant 1 dia. Podeu substituir 1 per qualsevol valor enter.
  • 1s: el contingut es desarà durant 1 setmana. Podeu substituir 1 per qualsevol valor enter.
  • 1m: el contingut es desarà durant 1 mes. Podeu substituir 1 per qualsevol valor enter.
  • 1a: el contingut es desarà durant 1 any. Podeu substituir 1 per qualsevol valor enter.
  • mai: el contingut no se suprimirà mai.

Permetre la connexió a les sales mitjançant comptes XMPP externs

En activar aquesta opció serà possible connectar-se a sales mitjançant comptes XMPP externs amb clients XMPP.
Avís, l’habilitació d’aquesta opció pot requerir una configuració a nivell de servidor i registres DNS. Per obtenir més informació, consulteu la documentació: Permet connexions amb comptes XMPP externs.

Port Prosody de servidor a servidor

El port que s’utilitza per a les connexions XMPP s2s (servidor a servidor).
Es recomana utilitzar el port estàndard 5269. En cas contrari, haureu de configurar un registre DNS específic .

Interfícies de xarxa per a connexions servidor a servidor

Les interfícies de xarxa per escoltar les connexions s2s (servidor servidor).
Una llista d’IP separades per comes (s’eliminaran espais). Podeu utilitzar «*» per escoltar a tots els IPv4 i «::» a tots els IPv6.
Exemples de configuració possibles:

  • *,::
  • *
  • 127.0.0.1,::1
  • 172.18.0.42

Directori de certificats

Si aquest camp està buit, el complement generarà i utilitzarà certificats autofirmats.
Si voleu utilitzar altres certificats, només heu d’especificar aquí la carpeta on Prosody els pot trobar. Nota: l’usuari «peertube» ha de tenir accés de lectura a aquesta carpeta.

Activar les connexions client-servidor

Permetre que els clients XMPP es connectin al servidor de Prosody.
Aquesta opció sola només permet connexions de client a l’host local.

Aquesta configuració permet als clients XMPP connectar-se al servidor Prosody incrustat. Actualment aquesta opció només permet connexions de client a localhost.

Per exemple, aquesta opció pot permetre que una instància de Matterbridge (un cop pugui utilitzar una connexió anònima) a la mateixa màquina vinculi el vostre xat a altres serveis, com ara una sala de Matrix.

Port de client a servidor Prosody

Port que s’utilitzarà per a les connexions XMPP c2s (client a servidor).
Els clients XMPP hauran d’utilitzar aquest port per connectar-se.
Canvieu aquest port si ja està en ús al servidor.
De moment podeu mantenir aquest port tancat al vostre tallafoc, serà inaccessible des de l’exterior (Prosody només escolta l’host local).
Nota: això pot canviar aviat, ja que hi ha plans per afegir una funció per habilitar connexions externes.

Interfícies de xarxa client-servidor

Les interfícies de xarxa per escoltar les connexions c2s (client a servidor).
Aquesta configuració es proporciona als usuaris avançats. No canvieu aquesta configuració si no enteneu completament el que significa.<br< Ès una llista d’IP separades per comes (s’eliminaran espais).
Podem utilitzar «*» per escoltar a tots els IPv4 i «::» a tots els IPv6.
Exemples:

  • *,::
  • *
  • 127.0.0.1,::1
  • 127.0.0.1,::1, 172.18.0.42

Activar els components externs personalitzats de Prosody

Aquesta configuració permet que els components XMPP externs es connectin al servidor. Per defecte, aquesta opció només permet connexions de components a localhost. Heu de canviar el valor del paràmetre “Interfícies de xarxa per a components externs de Prosody” per escoltar a altres interfícies de xarxa.

Aquesta funció es pot utilitzar per connectar ponts o robots.

Més informació sobre els components externs de Prosody aquí.

Activar els components externs personalitzats de Prosody

Habilita l’ús de components XMPP externs.
Aquesta opció sola només permet connexions des de l’host local.
Heu de configurar les interfícies per escoltar i obrir els ports del vostre tallafoc perquè això estigui disponible per als servidors remots.
Aquesta característica es pot utilitzar, per exemple, per connectar robots a sales.

Port per a components externs de Prosody

El port que cal utilitzar per als components XMPP.
Canvieu aquest port si ja està en ús al vostre servidor.
Podeu mantenir aquest port tancat al vostre tallafoc si no permeteu l’accés a interfícies diferents de l’host local.

Interfícies de xarxa per a components externs de Prosody

Interfícies de xarxa per escoltar components externs.
És una llista d’IP separades per comes (s’eliminaran espais). Podeu utilitzar «*» per escoltar a tots els IPv4 i «::» a tots els IPv6.
Exemples:

  • *,::
  • *
  • 127.0.0.1,::1
  • 172.18.0.42

Components externs

Components externs a declarar:

  • Un per línia.
  • Utilitzeu el format «nom_component:contrasenya_component» (s'eliminaran espais).
  • Podeu afegir comentaris: s'eliminarà tot el que hi ha després d'un caràcter # i s'ignoraran les línies buides.
  • El nom només pot contenir caràcters alfanumèrics llatins i punts.
  • Si el nom només conté caràcters alfanumèrics, se li sufixarà el domini XMPP. Per exemple, «bridge“ es convertirà en «bridge.el_vostre_domini.cat». També podeu especificar un nom de domini complet, però haureu d'assegurar-vos que la vostra configuració de DNS sigui correcta.
  • Utilitzeu només caràcters alfanumèrics a la contrasenya secreta (utilitzeu almenys 15 caràcters).

Activar mod_firewall per a Prosody

Podeu habilitar mod_firewall al vostre servidor de Prosody.

Per obtenir més informació, consulteu la documentació.