Como Assinar um Relay do Mastodon pelo Painel de Administração
🔍 WiseChecker

Como Assinar um Relay do Mastodon pelo Painel de Administração

Se você administra um servidor Mastodon, pode notar que a timeline local parece vazia ou que os usuários reclamam de ver apenas postagens da própria instância. Um relay do Mastodon é um servidor que encaminha postagens públicas de todas as instâncias conectadas para todas as outras, preenchendo sua timeline federada com conteúdo diverso. Sem um relay, sua instância só recebe postagens de usuários seguidos diretamente ou de servidores que alguém na sua instância pesquisou. Este artigo explica o que um relay faz, como assinar um pelo painel de administração do Mastodon e o que observar após a conexão.

Principais Conclusões: Assinar um Relay do Mastodon

  • Administração > Relés > Adicionar novo relay: O caminho exato no painel de administração do Mastodon para inserir a URL de um servidor relay.
  • Formato da URL do relay: Deve ser o endereço raiz do servidor relay, por exemplo https://relay.exemplo.com, sem caminho adicional.
  • Indicadores de status do relay: Após assinar, verifique se o relay mostra “Ativado” ou “Pendente” — um status pendente significa que o operador do relay precisa aprovar sua instância primeiro.

O Que é um Relay do Mastodon e Como Funciona?

Um relay do Mastodon é um servidor dedicado que agrega postagens públicas de muitas instâncias Mastodon e as redistribui para todas as outras instâncias conectadas ao relay. Quando sua instância assina um relay, seu servidor envia suas próprias postagens públicas para o servidor relay. Em troca, o relay envia ao seu servidor as postagens públicas de todas as outras instâncias que também assinaram aquele relay.

Esse mecanismo é fundamentalmente diferente de como o Mastodon normalmente descobre conteúdo. Sem um relay, sua instância conhece outro servidor apenas quando um de seus usuários segue uma conta naquele servidor remoto ou quando um usuário remoto segue alguém na sua instância. Isso é chamado de federação “baseada em pull”. Um relay muda isso para um modelo “baseado em push”: o relay envia conteúdo de todos os servidores membros para todos os outros servidores membros automaticamente.

O relay não armazena postagens permanentemente. Ele atua como um serviço de encaminhamento em tempo real. Quando uma postagem chega de uma instância, o relay a envia imediatamente para todas as outras instâncias conectadas. Se sua instância ficar offline temporariamente, o relay não enfileira as postagens perdidas. Quando sua instância reconectar, ela receberá apenas novas postagens a partir desse momento.

Antes de assinar um relay, você precisa de duas coisas. Primeiro, verifique se sua instância Mastodon está rodando a versão 3.0 ou superior, pois o suporte a relays foi introduzido nessa versão. Segundo, obtenha a URL de um servidor relay confiável. Existem listas públicas de relays, mas você deve verificar se o operador do relay tem boa reputação e não encaminha spam ou conteúdo abusivo. Associar-se a um relay não confiável pode inundar sua instância com postagens indesejadas.

Passos para Assinar um Relay do Mastodon pelo Painel de Administração

Os passos a seguir pressupõem que você tenha acesso de administrador à sua instância Mastodon. Você deve estar logado com uma conta que tenha o papel de Admin ou um papel personalizado com a permissão manage_relays.

  1. Abra o menu Administração
    Na interface web do Mastodon, clique no ícone do menu hambúrguer (três linhas horizontais) no canto superior esquerdo da tela. No menu que aparecer, clique em Preferências. Na página de Preferências, localize e clique em Administração na barra lateral esquerda. Se você não vir essa opção, sua conta não tem privilégios de administrador.
  2. Navegue até a página de Relés
    Na seção Administração, clique em Relés. Isso abre a página de gerenciamento de relays. A página exibe uma lista de todos os relays aos quais sua instância está atualmente inscrita, junto com seus status. Se este for seu primeiro relay, a lista estará vazia.
  3. Clique no botão “Adicionar novo relay”
    Perto do topo da página de Relés, clique no botão Adicionar novo relay. Um campo de entrada de texto e um botão de envio aparecerão.
  4. Insira a URL do servidor relay
    No campo de entrada de texto, digite a URL completa do servidor relay. A URL deve começar com https:// e não deve incluir nenhum caminho após o domínio. Por exemplo, se o relay estiver em https://relay.mastodon.exemplo, digite exatamente isso. Não adicione /inbox ou /api — o software Mastodon anexa os endpoints corretos automaticamente. Clique em Enviar após inserir a URL.
  5. Aguarde a atualização do status do relay
    Após enviar, o relay aparece na lista com um status. O status pode ser Pendente, Ativado ou Desativado. Um status Pendente significa que o operador do relay precisa aprovar sua instância antes que as postagens comecem a fluir. Um status Ativado significa que a conexão está ativa e as postagens estão sendo trocadas. Um status Desativado significa que o relay rejeitou sua inscrição ou foi desligado manualmente. Atualize a página após alguns minutos para ver se o status muda.
  6. Verifique se as postagens estão chegando
    Confira sua timeline federada (a coluna “Federada” na interface web) após 10 a 15 minutos. Se o relay estiver funcionando, você deve ver postagens públicas de instâncias com as quais nunca interagiu antes. Se você não vir novas postagens, o relay pode estar inativo, ou sua instância pode não ter postagens públicas para enviar em troca.

Problemas Comuns e Limitações ao Usar um Relay do Mastodon

O status do relay permanece “Pendente” por horas

Este é o problema mais comum. O operador do relay precisa aprovar manualmente cada instância que solicita uma inscrição. Alguns operadores de relay são lentos para responder ou pararam de manter seu relay. Se o status permanecer “Pendente” por mais de 24 horas, tente um relay diferente. Você pode remover o relay pendente clicando no ícone de exclusão ao lado dele na lista de relays e depois assinar outro relay.

O relay mostra “Desativado” imediatamente após a inscrição

Um status “Desativado” geralmente significa que o operador do relay bloqueou sua instância. Isso pode acontecer se sua instância tem reputação de hospedar spam, se seu servidor está rodando uma versão desatualizada do Mastodon, ou se o operador do relay tem uma política de adesão fechada. Verifique a saúde da federação da sua instância olhando a página Administração > Federação. Se sua instância estiver listada como “Suspensa” em muitos servidores, considere moderar seus usuários antes de tentar novamente.

A timeline federada ainda está vazia após o relay ser ativado

Mesmo com um relay ativado, sua timeline federada pode parecer vazia se nenhuma instância conectada estiver postando publicamente. Relays só encaminham postagens públicas de instâncias que estão ativamente postando. Se todas as instâncias no relay estiverem quietas, você não verá nada. Além disso, sua instância deve ter pelo menos uma postagem pública para enviar ao relay. Se seus usuários só postam com visibilidade “Não listada” ou “Seguidores”, o relay não tem nada para encaminhar. Peça aos seus usuários para tornar pelo menos algumas de suas postagens públicas para manter o relay ativo.

Problemas de desempenho após entrar em um relay grande

Um relay grande com centenas de instâncias pode enviar milhares de postagens por minuto para seu servidor. Se seu servidor tiver CPU, RAM ou largura de banda limitados, essa enxurrada pode fazer a interface web ficar lenta ou até derrubar os processos workers do Sidekiq. Monitore o uso de recursos do seu servidor após conectar a um relay. Se o desempenho degradar, considere cancelar a assinatura do relay ou mudar para um relay menor e curado que limite a adesão.

Relay do Mastodon vs Federação Direta

Item Relay do Mastodon Federação Direta
Descoberta de conteúdo Baseada em push: o relay envia todas as postagens públicas de todos os membros para sua instância Baseada em pull: sua instância só conhece um servidor remoto quando um usuário segue alguém nele
Esforço de configuração Inscrição única pelo painel de administração Nenhuma configuração necessária; acontece automaticamente conforme os usuários seguem contas remotas
Controle sobre o conteúdo Baixo: você recebe tudo de todos os membros do relay, a menos que use bloqueios de domínio Alto: você só recebe conteúdo de servidores com os quais seus usuários interagem explicitamente
Carga no servidor Alta: fluxo constante de postagens recebidas de muitos servidores Baixa: só recebe postagens de servidores que seus usuários seguem
Melhor para Instâncias que desejam uma timeline federada movimentada e diversa rapidamente Instâncias que priorizam baixo uso de recursos ou moderação rigorosa de conteúdo

Após assinar um relay, você pode gerenciar a conexão na mesma página Administração > Relés. Você pode desativar um relay sem excluí-lo clicando no botão de alternância ao lado dele. Desativar interrompe todo o tráfego de entrada e saída do relay. Excluir o relay o remove completamente da sua instância e interrompe toda a comunicação com aquele servidor relay.

Se você quiser ajustar qual conteúdo do relay chega aos seus usuários, use a página Administração > Federação > Bloqueios de domínio para bloquear domínios específicos que fazem parte do relay. Bloqueios de domínio substituem as assinaturas de relay, então postagens de um domínio bloqueado não aparecerão na sua instância mesmo que sejam encaminhadas pelo relay.

Considere começar com um relay pequeno e moderado, com menos de 50 instâncias. Isso dá a você a chance de observar como o relay afeta o desempenho do servidor e a qualidade do conteúdo antes de se comprometer com um relay maior. Você sempre pode adicionar mais relays depois pelo mesmo painel de administração.