Gerenciar uma instância do Mastodon para uma rede temática significa que você quer ver apenas postagens relevantes de outros servidores. Sem um relay, sua instância precisa seguir manualmente cada conta ou hashtag remota. Um relay filtrado automatiza isso ao receber postagens públicas de instâncias participantes e encaminhar apenas aquelas que correspondem às suas palavras-chave ou hashtags escolhidas. Este artigo explica como configurar um relay filtrado no Mastodon usando o módulo Relay no Mastodon 4.2 ou superior, configurar filtros de palavras-chave e conectar sua instância a uma rede temática específica.
Principais Conclusões: Configuração de Relay Filtrado no Mastodon
- Administração > Relays > Adicionar novo relay: Cria uma assinatura de relay que puxa postagens públicas de instâncias selecionadas.
- Relay filtrado via listas de palavras-chave: Limita as postagens recebidas àquelas que contêm hashtags ou termos específicos definidos na configuração do relay.
- Códigos de convite do relay: Compartilhe com outros administradores de instância para que eles possam participar da sua rede temática filtrada.
O Que um Relay Filtrado do Mastodon Faz e Por Que Você Precisa de Um
Um relay padrão do Mastodon encaminha todas as postagens públicas de todas as instâncias conectadas para todos os assinantes. Isso gera ruído para uma rede temática que deseja apenas postagens sobre astronomia ou discussões sobre Linux. Um relay filtrado aplica um conjunto de regras de inclusão antes de encaminhar qualquer postagem. Apenas postagens que contenham pelo menos uma das palavras-chave ou hashtags definidas são enviadas para as instâncias assinantes.
O Mastodon 4.2 introduziu a filtragem de relay integrada através do painel de administração. Você define o filtro como uma lista de termos. O mecanismo do relay verifica cada postagem recebida contra essa lista. Se nenhuma correspondência for encontrada, a postagem é descartada silenciosamente. Isso reduz a carga do servidor e mantém a linha do tempo local relevante para sua comunidade.
O relay filtrado funciona no nível do servidor. Ele não substitui listas de mute ou bloqueio por usuário. Os usuários ainda podem filtrar conteúdo em suas próprias linhas do tempo. O relay controla apenas o que entra na sua instância a partir de servidores externos.
Pré-requisitos para Executar um Relay Filtrado
Você precisa da versão 4.2 ou superior do Mastodon na instância que hospedará o relay. O relay não é um serviço separado. É um recurso do próprio software Mastodon. Você deve ter acesso de administrador à instância. A instância deve ter o recurso de relay ativado na configuração de ambiente. Verifique a variável de ambiente RELAY_ENABLED. Ela deve estar definida como true no seu arquivo .env.production.
Seu servidor deve ter armazenamento e largura de banda suficientes para lidar com o volume esperado de postagens correspondentes. Um relay filtrado com palavras-chave restritivas gera muito menos tráfego do que um relay sem filtro. Ainda assim, monitore o espaço em disco e o tamanho do banco de dados após ativar o relay.
Passos para Criar e Configurar um Relay Filtrado na Sua Instância do Mastodon
- Ative o recurso de relay na sua instância do Mastodon
Faça login no seu servidor via SSH. Abra/home/mastodon/live/.env.productioncom um editor de texto. Adicione ou edite a linhaRELAY_ENABLED=true. Salve o arquivo. Executesystemctl restart mastodon-sidekiqesystemctl restart mastodon-webpara aplicar a alteração. - Acesse a página de administração de relays
Abra sua instância do Mastodon em um navegador web. Faça login com uma conta de administrador. Navegue até Preferências > Administração > Relays. Esta página lista todos os relays aos quais sua instância está inscrita e permite criar novos. - Adicione uma nova assinatura de relay
Clique no botão Adicionar novo relay. No campo URL do relay, insira a URL do servidor de relay ao qual deseja se inscrever. Para um relay filtrado, esta URL aponta para a instância que define as regras de filtro. Clique em Enviar. Sua instância enviará uma solicitação de assinatura para esse relay. - Defina os filtros de palavras-chave para o relay
Após a assinatura do relay estar ativa, volte para a página de Relays. Encontre seu novo relay na lista. Clique no botão Filtrar ao lado dele. Uma caixa de texto aparece onde você pode inserir palavras-chave ou hashtags. Insira um termo por linha. Por exemplo, para filtrar conteúdo de astronomia, digite#astronomia,#astrofoto,espaço,telescópio. Clique em Salvar. - Gere códigos de convite para outros administradores
Na página de Relays, clique no botão Código de convite para o seu relay. Um código é gerado. Copie este código. Compartilhe com administradores de outras instâncias que desejam participar da sua rede temática. Eles usarão este código ao adicionar seu relay na instância deles. - Verifique se as postagens filtradas estão chegando
Aguarde alguns minutos após a configuração. Verifique a linha do tempo federada da sua instância. Você deve ver apenas postagens que contenham pelo menos um dos seus termos de filtro. Se vir postagens irrelevantes, revise a lista de filtros em busca de termos ausentes ou configurações incorretas do relay.
Problemas Comuns ao Construir um Relay Filtrado no Mastodon
Relay Filtrado Não Está Encaminhando Nenhuma Postagem
Se nenhuma postagem aparecer na sua linha do tempo federada após configurar um relay filtrado, verifique a lista de filtros. Listas de filtro vazias bloqueiam todas as postagens. O relay precisa de pelo menos uma palavra-chave para encaminhar conteúdo. Verifique também se o servidor relay está realmente recebendo postagens públicas de outras instâncias. Se o relay em si não tiver assinantes, ele não encaminhará nada.
Verifique os logs do Mastodon no servidor relay. Execute journalctl -u mastodon-sidekiq -n 50. Procure por erros relacionados ao processamento do relay. Um erro comum é um segredo de relay incompatível entre instâncias. Regere o código de convite no servidor relay e compartilhe o novo código com os assinantes.
Assinatura do Relay Falha com 401 Não Autorizado
Um erro 401 significa que o servidor relay rejeitou a solicitação de assinatura. Isso acontece quando o código de convite está expirado ou incorreto. Gere um novo código de convite no servidor relay. Envie o novo código para o administrador assinante. O administrador assinante deve remover a entrada antiga do relay e adicionar uma nova com o código atualizado.
Se o problema persistir, confirme que ambas as instâncias estão executando Mastodon 4.2 ou superior. Versões mais antigas não suportam filtragem de relay e podem rejeitar handshakes de assinatura. Atualize ambas as instâncias para a versão estável mais recente.
Termos de Filtro Não Correspondem às Postagens Esperadas
O filtro corresponde a substrings exatas no conteúdo da postagem e hashtags. Ele não diferencia maiúsculas de minúsculas. Se você filtrar por #linux, uma postagem com #Linux ainda será correspondida. No entanto, uma postagem com #linuxmint também será correspondida porque contém a substring linux. Para evitar correspondências não intencionais, use hashtags mais específicas como #linuxdesktop em vez de #linux.
O filtro não suporta expressões regulares ou operadores booleanos. Você não pode escrever #astronomia AND #marte. Cada termo é avaliado independentemente. Uma postagem que corresponda a qualquer termo único será encaminhada. Se você precisar de uma lógica mais rigorosa, considere executar um bot separado que republique apenas conteúdo que atenda aos seus critérios.
Relay Filtrado vs Relay Sem Filtro: Desempenho e Controle de Conteúdo
| Item | Relay Filtrado | Relay Sem Filtro |
|---|---|---|
| Filtragem de conteúdo | Encaminha apenas postagens contendo palavras-chave ou hashtags definidas | Encaminha todas as postagens públicas de todas as instâncias conectadas |
| Carga do servidor | Menor, pois a maioria das postagens é descartada antes do processamento | Maior, pois cada postagem deve ser recebida e armazenada |
| Uso de armazenamento | Menor, proporcional às postagens correspondentes | Maior, proporcional ao total de postagens recebidas |
| Complexidade de configuração | Requer definição de lista de palavras-chave e manutenção periódica | Simples, basta adicionar URL do relay e assinar |
| Melhor caso de uso | Comunidades temáticas e redes de nicho | Instâncias de uso geral que desejam federação ampla |
Agora você pode configurar um relay filtrado no Mastodon para atender a uma rede temática específica. Comece ativando o recurso de relay na sua instância. Adicione uma assinatura de relay e defina uma lista de palavras-chave que capture as postagens relevantes. Compartilhe o código de convite com outros administradores para expandir sua rede. Para controle avançado, considere executar um bot de moderação separado que aplique regras adicionais antes de republicar conteúdo na sua instância.