Configurações
Esta seção descreve a página de configurações do plugin.
Termos e condições do chat do canal
Você pode configurar uma mensagem de “termos e condições” que será exibida aos usuários que entrarem em suas salas de bate-papo.
For more information on this feature, check the documentation for channel’s terms & conditions.
Alterar esta configuração reiniciará o servidor de bate-papo e todos os usuários serão desconectados por um curto período.
Listar salas existentes
Ao clicar no botão “Listar salas”, todas as salas de bate-papo existentes serão listadas. Você poderá encontrá-las e moderá-las.
Federação
As configurações a seguir dizem respeito à federação com outras instâncias do Peertube e outros softwares diversos.
Não exibir chats remotos
Ao selecionar esta configuração, sua instância nunca irá exibir chats de vídeos remotos.
Não publicar informações do chat
Ao selecionar esta configuração, sua instância não irá publicar informação de chat no fediverso.
Instâncias remotas do Peertube não estarão cientes de que elas são salas de chat associadas aos seus vídeos.
Atenção: se você já possui chats em andamento, é possível que esta informação já tenha sido publicada.
Você deverá aguardar até a próxima atualização do vídeo antes que a informação seja despublicada.
Também, se você desabilitar esta configuração, você deverá aguardar os vídeos serem atualizados antes que a informação seja publicada novamente. Esta atualização acontece sobre as outras quando um evento ao vivo retorna ou se encerra.
Atenção: esta configuração apenas afeta a publicação de informação via protocolo ActivityPub.
Não irá impedir uma aplicação remota de detectar a presenção de chats de outra maneira, e de tentar conectar-se a ele.
Autenticação
Desativar tokens de chat ao vivo
Caso você tenha algum problema com os tokens de autenticação de longo prazo, você pode desabilitar o recurso aqui.
Autenticação externa
Veja a página de documentação detalhada:
Configuração avançada do canal
As configurações a seguir dizem respeito às opções avançadas do canal: os usuários poderão adicionar alguma personalização em seus canais, ativar o bot de moderação, …
Desabilite a configuração avançada do canal e o chatbot
Caso encontre algum problema com esse recurso, você pode desativá-lo.
Comportamento de bate-papo
Tipo de sala
Você pode escolher aqui ter salas separadas para cada vídeo ou agrupá-las por canal.
Abrir chat automaticamente
Ao assistir a um vídeo, a caixa de bate-papo será aberta automaticamente.
Exibir o botão «abrir em nova janela»
Haverá um botão para abrir o chat da web em uma nova janela.
Exibir o botão «compartilhar link do chat»
Este recurso permite o modal “compartilhar link de bate-papo”. Com este modal, você pode gerar URLs para entrar no bate-papo. O bate-papo pode ser personalizado (modo somente leitura, usar o tema atual, …).
Você pode, por exemplo, gerar uma URL somente leitura e usá-la no OBS para integrar o chat na sua transmissão ao vivo!
Esta configuração permite que você escolha quem pode acessar este modal.
Usuários podem ativar o chat para suas transmissões ao vivo
Se marcada, todos os vídeos ao vivo terão uma caixa de seleção em suas propriedades para habilitar o bate-papo na web.
O proprietário do vídeo poderá ativar chats na web.
Ativar chat para todas as transmissões
Se marcado, o bate-papo será habilitado para todas as vidas.
Ativar chat para todos os não-vivos
Se marcado, o bate-papo será habilitado para todos os vídeos que não sejam ao vivo.
Ativar chat para estes vídeos
UUIDs de vídeos para os quais queremos um bate-papo na web.
Podem ser vídeos não ao vivo. Um por linha.
Você pode adicionar comentários: tudo após o caractere # será removido e as linhas vazias serão ignoradas.
Não adicione vídeos privados, os UUIDs serão enviados para o frontend.
Ocultar chat para usuários anônimos
Se marcado, usuários anônimos do Peertube não verão o chat. Este recurso ainda é experimental. Se você o habilitou, é altamente recomendável também marcar “Não publicar informações do chat”. Caso contrário, algumas ferramentas de terceiros podem tentar abrir o chat e apresentar comportamentos imprevisíveis.
Observação: por enquanto, este recurso simplesmente oculta o chat. Em uma versão futura, o chat será substituído por uma mensagem dizendo “faça login em […]”. Consulte Notas da versão v5.7.0 para obter mais informações.
Banir o IP de um usuário anônimo quando ele for banido de uma sala de bate-papo
Ao habilitar esta opção, cada vez que um usuário anônimo for banido de uma sala de bate-papo, seu IP também será banido do servidor de bate-papo. Aviso: se sua instância estiver aberta para registro, qualquer usuário poderá criar uma sala com armadilha, convidar usuários para participar e banir automaticamente todos os IPs de usuários anônimos. A lista de IPs banidos não é armazenada, ela será apagada na reinicialização do servidor ou quando você alterar as configurações de algum plugin. Os IPs banidos são registrados nos arquivos de log do servidor Prosody, para que os administradores do servidor possam eventualmente usar algumas ferramentas externas (como o fail2ban) para banir IPs de forma mais ampla.
Observação importante: Se você habilitar esse recurso e estiver usando um proxy reverso personalizado na frente do Peertube, certifique-se de que sua configuração esteja configurada corretamente para encaminhar IPs de usuários reais para o Peertube. Caso contrário, ele poderá bloquear todos os usuários anônimos de uma só vez.
Tematização
Conjunto de avatares
Você pode escolher entre vários conjuntos diferentes de avatares padrões que serão usados pelos usuários do bate-papo.
Sepia (mascote do Peertube): Gerador de avatar Peertube de David Revoy, licença CC-By
Gatos: Gerador de avatar de gato de David Revoy, CC-By licença
Pássaros: Gerador de avatar de pássaros de David Revoy, licença CC-By
Fenecs (mascote do Mobilizon): Gerador de avatar fenec/mobilizon de David Revoy, licença CC-By
Abstrato: Gerador de avatar abstrato de David Revoy, licença CC-By
Avatares Sepia legados (aqueles incluídos em versões anteriores do plugin): Baseado no trabalho de David Revoy, licença AGPL-v3
Se você não conseguir ver a alteração imediatamente, pode ser por causa do cache do seu navegador. Basta limpar o armazenamento de sessão do navegador ou reiniciá-lo.
Tema do ConverseJS
Você pode escolher qual tema usar para o ConverseJS:
- Tema Peertube: este é um tema especial, feito especialmente para integração com o Peertube.
- Tema padrão do ConverseJS: este é o tema padrão do ConverseJS.
- Tema cyberpunk do ConverseJS: este é um tema fornecido pelo ConverseJS.
Detecção automática de cor
Tentar detectar automaticamente as cores do tema atual do usuário.
Quando esta configuração está ativada, o plugin tenta detectar automaticamente as cores para aplicar ao tema do chat.
Se isso não estiver funcionando corretamente em algum dos seus temas do Peertube, você pode desativar esta opção.
Você pode relatar o bug no rastreador de problemas oficial
de problemas
. Não se esqueça de especificar qual tema não está funcionando.
Atributo de estilo iframe do Webchat
Estilos adicionais a serem adicionados no atributo de estilo iframe.
Exemplo: altura:400px;
Configurações avançadas do servidor de bate-papo
Usar Prosody do sistema
O plugin vem com uma AppImage que é usada para executar o servidor Prosody
XMPP. Se esta AppImage não estiver funcionando, você
pode recorrer ao Prosody que vem empacotado para o seu servidor. Basta
instalar o pacote prosody
.
Esta configuração só deve ser usada se o plugin estiver quebrado e aguardando um patch.
Desabilitar Websocket
Com Peertube >= 5.0.0, este plugin tenta usar a conexão Websocket para bate-papo.
Se o navegador ou a conexão do usuário for incompatível, o navegador retornará automaticamente ao protocolo BOSH.
Mas em casos raros, isso pode falhar. Por exemplo, se você tiver um proxy reverso na frente do Peertube que não
permita conexão Websocket para plugins.
Neste caso, você pode verificar esta configuração para desabilitar conexões Websocket.
Porta do Prosody
A porta que será usada pelo servidor Prosody.
Altere-a se esta porta já estiver em uso no seu servidor.
Você pode fechar esta porta no seu firewall, ela não será acessada do mundo externo.
Nota: isso pode mudar em um futuro próximo, pois está planejado adicionar um recurso para ativar conexões externas.
URL do Peertube para chamada de API
Deixe esta configuração em branco se você não sabe o que está fazendo.
Em alguns casos raros, o Prosody não consegue chamar a API do Peertube a partir de seu URI público.
Você pode usar este campo para personalizar o URI do Peertube para o módulo Prosodys
(por exemplo, com «http://localhost:9000» ou «http://127.0.0.1:9000»).
If this setting is left empty, and you are using Peertube >= 5.1 or later, the plugin will use values from your Peertube configuration file to guess on which interface and port request have to be done.
Em último caso, ele usará o URI público do Peertube. Portanto, qualquer
chamada de API passará pelo seu servidor Nginx. Isso pode falhar em alguns
casos: por exemplo, se você estiver em um contêiner Docker, onde o nome do
host público não resolve para o IP correto. Nesse caso, tente alterar as
configurações de “URL do Peertube para chamada de API”
definindo http://127.0.0.1:9000
(assumindo que 9000 é a porta na qual o
Peertube escuta, pergunte aos administradores da sua instância se você não
souber).
Logar conteúdo das salas por padrão
Se marcado, o conteúdo da sala será salvo por padrão.
Qualquer usuário que entrar em uma sala verá o que foi escrito antes de entrar.
Observe que sempre é possível ativar/desativar o arquivamento
de conteúdo para uma sala específica, editando as propriedades.
Expiração dos logs de sala
Você pode escolher aqui por quanto tempo o conteúdo da sala de bate-papo será mantido pelo servidor. O valor pode ser:
- 60: o conteúdo será salvo por 60 segundos. Você pode substituir 60 por qualquer valor inteiro.
- 1d: o conteúdo será salvo por 1 dia. Você pode substituir 1 por qualquer valor inteiro.
- 1s: o conteúdo será salvo por 1 semana. Você pode substituir 1 por qualquer valor inteiro.
- 1m: o conteúdo será salvo por 1 mês. Você pode substituir 1 por qualquer valor inteiro.
- 1a: o conteúdo será salvo por 1 ano. Você pode substituir 1 por qualquer valor inteiro.
- nunca: o conteúdo jamais expirará, sendo mantido para sempre.
Habilitar conexão à sala usando contas XMPP externas
Ao habilitar esta opção, será possível conectar-se a salas usando contas XMPP externas e clientes XMPP.
Aviso, habilitar esta opção pode demandar configuração extra de servidor e DNS.
Consulte a documentação:
Habilitar conexões de contas XMPP externas.
Porta do servidor Prosody para o servidor
A porta que será usada para conexões XMPP s2s (servidor para servidor).
Você deve usar a porta padrão 5269.
Caso contrário, você deve configurar um registro de DNS específico
.
Interfaces de rede de servidor para servidor
As interfaces de rede para escutar conexões entre servidores.
Lista de IPs para escutar, separados por vírgulas (os espaços serão removidos).
Você pode usar «*» para escutar em todas as interfaces IPv4 e «::» para todas as IPv6.
Examplos:
- *, ::
- *
- 127.0.0.1, ::1
- 172.18.0.42
Pasta dos certificados
Se este campo estiver vazio, o plugin irá gerar e usar certificados autoassinados.
Caso queira utilizar outros certificados, basta especificar aqui a pasta onde o
Prosody pode encontrá-los. Observação: o usuário “peertube” deve ter acesso de leitura a esta pasta.
Habilitar conexões de cliente para servidor
Habilite os clientes XMPP para se conectarem ao servidor Prosody integrado.
Esta opção sozinha permite apenas conexões em localhost.
Esta configuração permite que clientes XMPP se conectem ao servidor Prosody integrado. Por enquanto, esta opção permite conexões apenas de clientes de host local.
Por exemplo, esta opção pode permitir que uma instância do Matterbridge (que poderia usar login anônimo) na mesma máquina faça uma ponte entre seu bate-papo e outros serviços, como uma sala Matrix.
Porta do cliente para o servidor Prosody
A porta que será usada pelo módulo c2s do servidor Prosody integrado.
Os clientes XMPP devem usar essa porta para se conectar.
Altere-o se esta porta já estiver em uso em seu servidor.
Você pode manter esta porta fechada em seu firewall por enquanto, ela não será acessada do mundo exterior.
Nota: isso pode mudar em um futuro próximo, pois está planejado adicionar um recurso para ativar conexões externas.
Interfaces de rede cliente-servidor
As interfaces de rede para escutar conexões de cliente para servidor.
Esta configuração é fornecida para usuários avançados. Não altere essa configuração se você não entender completamente o que ela significa.
Lista de IP para ouvir, separados por vírgula (os espaços serão removidos).
Você pode usar «*» para escutar em todas as interfaces IPv4 e «::» para todas as interfaces Ipv6.
Exemplos:
- *, ::
- *
- 127.0.0.1, ::1
- 127.0.0.1, ::1, 172.18.0.42
Habilitar componentes externos personalizados do Prosody
Esta configuração permite que componentes externos XMPP se conectem ao servidor. Por padrão, esta opção permite conexões apenas de componentes do host local. Você precisa alterar o valor “Interfaces de rede de componentes externos da Prosody” para escutar em outras interfaces de rede.
Esse recurso pode ser usado para conectar pontes ou bots.
Mais informações sobre os componentes externos do Prosody aqui.
Habilitar componentes externos personalizados do Prosody
Habilitar o uso de componentes XMPP externos.
Esta opção por si só permite conexões apenas do localhost.
Você precisa configurar as interfaces de escuta e abrir a porta no seu firewall para torná-lo disponível em servidores remotos.
Este recurso pode, por exemplo, ser usado para conectar alguns bots às salas de bate-papo.
Porta de componentes externos do Prosody
A porta que será usada pelos componentes XMPP para se conectar ao servidor Prosody.
Altere-a se esta porta já estiver em uso no seu servidor.
Você pode manter esta porta fechada no seu firewall se não permitir acesso em interfaces diferentes do host local.
Interfaces de rede de componentes externos da Prosody
As interfaces de rede para escutar conexões de componentes externos.
Lista de IPs para escutar, separados por vírgulas (os espaços serão removidos).
Você pode usar «*» para escutar em todas as interfaces IPv4 e «::» para todas as IPv6.
Examplos:
- *, ::
- *
- 127.0.0.1, ::1
- 172.18.0.42
Componentes externos
Os componentes externos a declarar:
- Um por linha.
- Use o formato «nome_do_componente:segredo_do_componente» (os espaços serão cortados).
- Você pode adicionar comentários: tudo após o caractere # será removido e as linhas vazias serão ignoradas.
- O nome só pode conter caracteres alfanuméricos latinos e pontos.
- Se o nome contiver apenas caracteres alfanuméricos, ele será sufixado com o domínio XMPP. Por exemplo, «ponte» se tornará «ponte.seu_dominio.tld». Você também pode especificar um nome de domínio completo, mas certifique-se de configurar seu DNS corretamente.
- Use apenas caracteres alfanuméricos na frase secreta (use pelo menos 15 caracteres).
Habilitar Prosody mod_firewall
Você pode habilitar mod_firewall no seu servidor Prosody.
Para mais informações, consulte a documentação.