Como Configurar um Relay do Mastodon para uma Comunidade de Nicho

Se você administra uma instância do Mastodon para uma comunidade de nicho, como colecionadores de computadores antigos, observadores de pássaros ou desenvolvedores de jogos independentes, seus usuários podem se sentir isolados. A linha do tempo local mostra apenas postagens da sua instância, e a linha do tempo federada pode ser sobrecarregante ou irrelevante. Um relay do Mastodon resolve isso puxando automaticamente postagens públicas de outras instâncias que compartilham os interesses da sua comunidade. Este artigo explica o que é um relay, como configurar um na sua instância e como ajustá-lo para que sua comunidade de nicho se mantenha engajada com conteúdo relevante de todo o fediverso.

O que um Relay do Mastodon Faz por uma Comunidade de Nicho

Um relay do Mastodon é um servidor separado que executa software de relay como Relayator ou Pub-Relay. Quando você inscreve sua instância em um relay, sua instância envia todas as suas postagens públicas para o relay. O relay então encaminha essas postagens para todas as outras instâncias inscritas no mesmo relay. Em troca, sua instância recebe postagens públicas de todas essas outras instâncias. Isso cria um fluxo bidirecional de conteúdo sem exigir que seus usuários sigam manualmente contas em cada instância remota.

Para uma comunidade de nicho, um relay é muito mais eficiente do que pedir para cada membro seguir dezenas de contas relevantes. Em vez da linha do tempo federada padrão, que mostra postagens de qualquer instância com a qual seus usuários interagiram, o relay garante que apenas postagens de instâncias que compartilham o tópico do seu nicho apareçam. Por exemplo, um relay para “entusiastas de computadores antigos” conectaria instâncias focadas em computação retrô, hardware antigo e emulação. Postagens sobre tópicos não relacionados, como esportes ou política, não apareceriam porque essas instâncias não fazem parte do relay.

Pré-requisitos Antes de Configurar um Relay

Antes de configurar um relay, confirme que você tem acesso administrativo completo à sua instância do Mastodon. Você precisa ser capaz de modificar arquivos de configuração e reiniciar os serviços do Mastodon. Você também precisa de acesso a um servidor separado para hospedar o software de relay. Esse servidor deve ter um endereço IP público e um nome de domínio. Um pequeno servidor virtual privado com 1 núcleo de CPU e 2 GB de RAM é suficiente para a maioria das comunidades de nicho. O servidor de relay não precisa de um banco de dados; ele só precisa executar o software de relay e ter um servidor web como Nginx ou Caddy para terminação TLS.

Passos para Configurar um Relay do Mastodon para Sua Comunidade de Nicho

Siga estes passos para instalar o software de relay, configurá-lo e inscrever sua instância do Mastodon no relay. Este guia usa o Pub-Relay porque é mantido ativamente e suporta Mastodon 4.x.

1. Crie um registro DNS para o servidor de relay
   No seu registrador de domínio ou provedor de DNS, crie um registro A que aponte um subdomínio como relay.suacomunidade.org para o endereço IP do seu servidor de relay. Aguarde a propagação do DNS, que pode levar alguns minutos a algumas horas.
2. Instale o Pub-Relay no servidor de relay
   Conecte-se via SSH ao servidor de relay. Instale o Node.js versão 18 ou mais recente usando o gerenciador de pacotes da sua distribuição ou NodeSource. Clone o repositório do Pub-Relay: git clone https://github.com/umonaca/pub-relay.git. Entre no diretório: cd pub-relay. Execute npm install para instalar as dependências.
3. Configure o relay
   Copie a configuração de exemplo: cp config/default.toml config/production.toml. Edite o arquivo com um editor de texto. Defina server_name para o subdomínio do seu relay, por exemplo relay.suacomunidade.org. Defina allowed_instances como uma lista vazia para permitir todas as instâncias. Se quiser restringir o relay apenas a instâncias específicas, liste seus nomes de domínio. Defina max_connections para 100 ou mais, dependendo do tráfego esperado. Salve o arquivo.
4. Inicie o Pub-Relay
   Execute NODE_ENV=production node index.js para iniciar o relay. Confirme que ele escuta na porta 8080 por padrão. Use um gerenciador de processos como pm2 ou systemd para manter o relay em execução após você sair. Para pm2, execute npm install -g pm2 e depois pm2 start index.js --name pub-relay.
5. Configure TLS com um proxy reverso
   Instale o Nginx no servidor de relay. Crie um bloco de servidor que proxy as requisições da porta 443 para localhost:8080. Use o Certbot para obter um certificado TLS gratuito do Let’s Encrypt para o subdomínio do seu relay. Após a configuração, teste se https://relay.suacomunidade.org retorna uma resposta JSON.
6. Inscreva sua instância do Mastodon no relay
   Faça login na sua instância do Mastodon como administrador. Vá em Preferências > Administração > Relays. Clique em “Adicionar novo relay”. No campo, cole a URL do relay: https://relay.suacomunidade.org. Clique em “Salvar”. O Mastodon enviará uma solicitação de inscrição para o relay. Após alguns segundos, o status do relay deve mostrar “Ativado”.
7. Verifique a atividade do relay
   Abra a linha do tempo federada da sua instância do Mastodon. Você deve ver postagens públicas de outras instâncias que estão inscritas no mesmo relay. Se não vir novas postagens após 10 minutos, verifique os logs do sidekiq do Mastodon em busca de erros. Causas comuns incluem configuração incorreta de DNS ou regras de firewall bloqueando a porta 443.

Problemas Comuns ao Configurar um Relay do Mastodon

A inscrição no relay falha com erros HTTP 400 ou 500

Isso geralmente acontece quando o servidor de relay não está acessível a partir da instância do Mastodon. Verifique se o subdomínio do relay resolve para o endereço IP correto. Confirme que o Nginx está em execução e que a porta 443 está aberta no firewall do servidor de relay. Na instância do Mastodon, execute curl -I https://relay.suacomunidade.org para testar a conectividade. Se a resposta incluir um status 200, o problema provavelmente está na configuração do Pub-Relay. Verifique novamente o valor de server_name no production.toml; ele deve corresponder exatamente ao subdomínio do relay.

Postagens do relay não aparecem na linha do tempo federada

Se a inscrição no relay mostrar “Ativado” mas nenhuma nova postagem aparecer, o relay pode não ter outras instâncias inscritas. Um relay só distribui postagens quando pelo menos duas instâncias estão inscritas. Peça a outro administrador de instância da sua comunidade de nicho para se inscrever no mesmo relay. Alternativamente, verifique o arquivo de log do relay em busca de erros. No servidor de relay, execute pm2 logs pub-relay para ver a saída em tempo real. Procure por linhas contendo “error” ou “rejected”.

Relay causa alta carga no servidor da instância do Mastodon

Um relay pode aumentar significativamente o número de postagens recebidas. Se sua instância roda em um servidor pequeno, pode ter dificuldades. Limite o relay apenas a instâncias relevantes definindo allowed_instances na configuração do Pub-Relay. Você também pode reduzir o max_connections do relay para 50. No lado do Mastodon, aumente as configurações de concorrência do sidekiq no .env.production se houver capacidade de CPU disponível. Monitore a carga do servidor com htop e ajuste conforme necessário.

Item	Relay Próprio (Pub-Relay)	Serviço de Relay de Terceiros
Descrição	Você executa o software de relay no seu próprio servidor	Você se inscreve em um relay operado por outra pessoa
Controle	Controle total sobre quais instâncias são permitidas	Limitado às regras do operador do relay
Custo	Taxa de aluguel do servidor, geralmente US$ 5–10 por mês	Geralmente gratuito
Privacidade	Todos os dados das postagens permanecem no seu servidor de relay	As postagens passam por um servidor externo
Esforço de configuração	Médio: requer habilidades de administração de servidores	Baixo: basta colar uma URL de inscrição
Melhor para	Comunidades de nicho que precisam de controle rigoroso de tópicos	Comunidades gerais que desejam federação rápida

Após configurar o relay, sua comunidade de nicho verá um fluxo constante de postagens relevantes de outras instâncias. Incentive seus membros a seguir contas remotas específicas que descobrirem através do relay. Isso fortalece ainda mais a federação entre as instâncias. Como próximo passo, considere criar um diretório público das instâncias que participam do seu relay para que novos membros possam encontrá-las e se juntar a elas facilmente. Uma dica avançada: configure o relay para rejeitar postagens com muitos anexos definindo um tamanho máximo de anexo na configuração do Pub-Relay, o que mantém o relay rápido para comunidades focadas em texto.