Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Se a moderação do Matrix estiver espalhada por contas pessoais e salas, execute o Mjölnir como um bot dedicado e forneça aos moderadores uma sala de gerenciamento privada para comandos. A configuração auto-hospedada mais simples usa o Docker Compose, uma conta Matrix separada e uma sala de gerenciamento criptografada; em seguida, adicione as salas da comunidade que o Mjölnir deve proteger e verifique suas permissões.

O que Mjölnir faz — e do que ele precisa.

Mjölnir é um bot de moderação do Matrix que aplica listas de políticas e ações de moderação como se fosse sua própria conta. Um servidor doméstico é o servidor Matrix que hospeda contas de usuário e salas. Uma sala de gerenciamento é a sala privada onde moderadores autorizados emitem comandos para o bot. Uma sala protegida é uma sala que o Mjölnir monitora e pode moderar.

Para este guia, você precisa de acesso a uma conta Matrix no servidor doméstico, permissão para criar uma conta de bot e salas, além de um host com Docker Engine e o plugin Docker Compose. Não é necessário tornar o Mjölnir um administrador do servidor doméstico para a moderação comum de salas. Algumas ações em todo o servidor — como desativar usuários ou encerrar salas — exigem um servidor doméstico Synapse e privilégios de administrador do servidor; omita esses privilégios, a menos que seu caso de uso os exija. Consulte o repositório oficial do Mjölnir no projeto .

1. Crie uma conta de bot e uma sala de controle privada.

Registre uma conta dedicada, como @mjolnir:example.orgem seu servidor doméstico. Não use a conta pessoal de um moderador: credenciais separadas facilitam a rotação de acesso e mantêm as ações do bot distintas. Crie uma sala privada para moderadores, habilite a criptografia de ponta a ponta e convide tanto os moderadores humanos quanto o bot. Limite a participação a pessoas de sua confiança. Qualquer pessoa na sala de gerenciamento configurada pode emitir comandos, e o Mjölnir não oferece permissões de comando mais detalhadas dentro dessa sala.

Faça login como o bot em um perfil de navegador separado ou em uma janela anônima para obter o token de acesso do Matrix por meio das configurações de Ajuda e Sobre do Element . Copie o token para sua configuração em um local seguro. Feche a janela do navegador sem sair da conta; sair da conta invalida o token. A documentação oficial de configuração recomenda criptografia para a sala de gerenciamento e instrui a habilitar a criptografia na configuração do Mjölnir para que o bot possa se comunicar por lá.

Formulário de configuração de conta Matrix para um bot Mjölnir dedicado com seu token de acesso mascarado.
A primeira tarefa de configuração é criar uma identidade de bot separada; nunca exponha seu token de acesso em uma captura de tela ou registro público.

2. Configure o Mjölnir para seu servidor doméstico

No host Docker, crie um diretório de dados persistente e copie a configuração de exemplo do projeto para lá ./mjolnir/config/production.yaml. O arquivo de exemplo documenta opções adicionais; defina apenas os valores necessários para sua implantação. No mínimo, use a URL da API do cliente do seu servidor doméstico, o token do bot, a criptografia nativa e o ID ou alias da sala Matrix de gerenciamento:

homeserverUrl: "https://matrix.example.org"
accessToken: "YOUR_BOT_ACCESS_TOKEN"
encryption:
  use: true
managementRoom: "!roomid:example.org"

Substitua todos os valores de exemplo. O ID da sala começa com !`_`; o alias começa com ` #_`. Não cole matrix.tolinks em ` managementRoom_`. Trate o arquivo de configuração e o token como segredos: restrinja o acesso ao arquivo, mantenha-o fora do controle de versão e não o publique em solicitações de suporte. Se o bot não conseguir descriptografar a sala de gerenciamento, verifique novamente a configuração de criptografia e confirme se o bot entrou na sala.

Um exemplo de configuração YAML mostrando a URL do servidor doméstico, o token de acesso mascarado, a criptografia ativada e o ID da sala de gerenciamento.
O exemplo ilustra os campos de configuração necessários; substitua o servidor, o token e o ID da sala de exemplo pelos seus próprios valores.

3. Inicie o serviço Docker Compose.

As instruções oficiais do Docker usam a matrixdotorg/mjolnirimagem e montam um diretório do host em /data. Crie docker-compose.ymlao lado do mjolnirdiretório:

services:
  mjolnir:
    image: matrixdotorg/mjolnir:latest
    restart: unless-stopped
    volumes:
      - ./mjolnir:/data

A partir desse diretório, inicie o Mjölnir com `mjölnir start` docker compose up -d. O diretório montado preserva a configuração e os dados do bot quando o contêiner é recriado. O guia oficial usa a latesttag `<release>` como exemplo; para um servidor de produção, escolha uma tag de versão que você tenha testado e registre-a para que as atualizações sejam feitas de forma planejada. Após a inicialização, execute `mjölnir start` docker compose logs -f --tail 100 mjolnir. Aguarde as mensagens de inicialização do Mjölnir na sala de gerenciamento antes de prosseguir.

Um terminal mostra o serviço Mjölnir Docker Compose sendo iniciado com um volume de dados persistente.
Inicie o serviço a partir do diretório que contém o arquivo Compose e, em seguida, verifique os registros em busca de erros de inicialização.

4. Crie uma lista de políticas e proteja os quartos.

Na sala de administração, pergunte ao bot !mjolnir helpse ele não responder. Crie uma lista de banimento com um código curto e um alias para a sala e defina-a como lista padrão.

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC

Mjölnir cria a sala da lista e convida você para ela. Uma lista de políticas é uma sala do Matrix que contém regras de moderação, portanto, verifique sua visibilidade e membros antes de compartilhá-la. Adicione cada sala da comunidade que você deseja que Mjölnir monitore:

!mjolnir rooms add #community:example.org
!mjolnir verify

O bot precisa de privilégios suficientes em cada sala protegida para realizar ações de moderação, geralmente a capacidade de banir usuários e editar eventos. Use as configurações de privilégios da sala para conceder apenas as permissões necessárias. O verifycomando verifica se o Mjölnir possui as permissões necessárias nas salas protegidas. Adicione o bot a uma sala antes de protegê-la. Não configure isso protectAllJoinedRoomsde forma aleatória: isso amplia a proteção para as salas às quais o bot se junta e torna a seleção sala por sala menos útil.

Uma sala de moderação Matrix criptografada mostra Mjölnir online e um comando criando uma lista de políticas COC.
Assim que o bot responder na sala de gerenciamento privada, crie uma lista e teste os comandos lá.

Verifique a configuração e evite erros comuns.

  • O bot está online: docker compose ps o serviço está em execução, os registros não mostram erros repetidos de autenticação ou criptografia e o bot publica seu status de inicialização na sala de gerenciamento.
  • Os comandos são restritos: moderadores podem usá-los !mjolnir statusna !mjolnir rulessala configurada. Não teste comandos em uma sala pública.
  • Os cômodos estão protegidos: !mjolnir rooms lista os cômodos em questão e !mjolnir verifyinforma os níveis de energia adequados.
  • Os segredos permanecem privados: o token não está em um repositório público, histórico do shell ou logs publicados. Se exposto, revogue ou alterne o token encerrando a sessão do bot e atualizando a configuração antes de reiniciar.

Se o bot permanecer em silêncio, primeiro confirme se o ID ou alias da sala de administração está correto e se o bot é um membro ativo. Para salas criptografadas, verifique se a criptografia está ativada e se o bot consegue descriptografar as mensagens. Se a moderação falhar apenas em uma sala, verifique se ela está protegida e se seus níveis de permissão permitem a ação solicitada. Para obter informações sobre a sintaxe dos comandos e as opções de configuração, consulte o guia do moderador do Mjölnir , o guia de configuração do Docker e a configuração de exemplo .

Deixar um comentário

Restaure o Matrix Synapse com segurança usando um dump do PostgreSQL.

Faça backup do Synapse com pg_dump, proteja sua chave de assinatura e mídia e restaure-o em um banco de dados PostgreSQL limpo, sem reutilizar chaves de uso único obsoletas.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Configure o Mjölnir com uma conta Matrix dedicada, sala de gerenciamento criptografada, Docker Compose, lista de políticas e verificações de permissão.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ignore o proxy descontinuado e configure a Sincronização Deslizante integrada do Synapse. Verifique a descoberta de clientes e, em seguida, meça o carregamento da lista de salas e o comportamento de reconexão em um telefone compatível.

Hospedagem de elementos web no Nginx com um servidor doméstico personalizado

Implante o Element Web como um site estático, aponte-o para o seu servidor Matrix, adicione HTTPS e configure o Nginx para servir atualizações sem arquivos obsoletos.

Execute um servidor doméstico Matrix leve no Raspberry Pi 4

Configure o Conduit em um Raspberry Pi 4 de 64 bits com dados persistentes, federação HTTPS, registro protegido e verificações para um servidor doméstico em funcionamento.

Configure um alias personalizado para a sala Matrix em seu próprio domínio.

Atribua um endereço fácil de compartilhar a uma sala do Matrix em seu domínio usando o Element ou a API do Matrix, com verificações de permissões, nomenclatura Synapse e federação.

Configure o Coturn para chamadas de voz e vídeo confiáveis ​​no Remake Matrix.

Configure o coturn e o Synapse com credenciais TURN correspondentes, abra as portas de retransmissão necessárias e verifique se os clientes Matrix conseguem obter candidatos de retransmissão.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Configure um servidor doméstico Synapse persistente com Docker Compose, PostgreSQL, uma configuração privada e verificações antes de expô-lo via HTTPS.

Personalize o tema e a identidade visual do Element Web.

Defina um nome de marca, cores personalizadas e recursos de login para sua implementação do Element Web, entendendo quais partes permanecerão com a marca Element.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Diagnostique se o Synapse atingiu seu limite de arquivos abertos por processo, configure um comando systemd para o serviço ou worker correto e verifique o limite em tempo real.