Como Verificar se um Relay do Mastodon Está Enviando Postagens

Você adicionou um relay à sua instância do Mastodon para aumentar a visibilidade e trazer postagens de outros servidores. Mas sua timeline local continua vazia e você não tem certeza se o relay está funcionando. Um relay é um servidor que atua como intermediário, encaminhando postagens públicas de uma instância para outra. Este artigo explica como testar se um relay está enviando conteúdo ativamente para sua instância e o que fazer se não estiver.

Relays substituem a abordagem antiga e menos eficiente de “seguir todos os usuários”. Eles permitem que sua instância se inscreva em um servidor relay, que então envia postagens públicas de todas as instâncias membros para a sua. No entanto, um relay pode falhar silenciosamente devido a configuração incorreta, bloqueios de rede ou o próprio relay estar offline. Você precisa verificar tanto o status do relay no seu servidor quanto o fluxo real de postagens na sua timeline local.

Este guia cobre as etapas exatas para inspecionar conexões de relay através da interface de administração do Mastodon, verificar a entrega de postagens usando a interface web e logs do servidor, e resolver falhas comuns de relay. Ao final, você será capaz de confirmar se seu relay está enviando postagens ou se precisa substituí-lo ou reconfigurá-lo.

O que um Relay do Mastodon Faz e Por Que Pode Falhar

Um relay do Mastodon é um servidor especializado que coleta postagens públicas de todas as instâncias inscritas e as redistribui para cada instância assinante. Quando sua instância entra em um relay, você não precisa seguir manualmente usuários de cada instância remota. Em vez disso, o relay cuida da distribuição em massa. Isso é especialmente útil para instâncias pequenas que desejam permanecer conectadas ao fediverso sem gerenciar milhares de seguidores individuais.

O relay usa o mecanismo de inscrição ActivityPub do Mastodon. Sua instância envia uma solicitação de seguir para o servidor relay. O relay aceita essa solicitação e então envia para sua instância cada nova postagem pública de todas as suas instâncias membros. O relay em si não armazena postagens permanentemente. Ele apenas as encaminha em tempo real.

Um relay pode parar de enviar postagens por vários motivos:

Servidor Relay Está Offline ou Sobrecarregado

O servidor relay pode estar fora do ar para manutenção, com limite de taxa ou bloqueado pelo seu provedor de hospedagem. Quando o relay está inacessível, sua instância não pode receber postagens encaminhadas. A interface de administração mostrará o relay como “Desativado” ou “Pendente”.

Erro de Configuração da Instância

Sua instância deve ter a federação de saída ativada e a URL correta do relay. Um erro de digitação no endereço do relay ou uma barra final ausente impede a conexão. Além disso, se sua instância estiver configurada em modo privado ou tiver uma lista de permissões restritiva, o handshake do relay pode ser rejeitado.

Problemas de Rede ou DNS

Se seu servidor não conseguir resolver o nome de domínio do relay ou se o endereço IP do relay estiver bloqueado por um firewall, as postagens não chegarão. A configuração incorreta de IPv6 também pode causar falhas silenciosas, pois o relay pode tentar uma conexão IPv6 que sua instância não suporta.

Passos para Verificar se um Relay do Mastodon Está Enviando Postagens

Siga estes passos em ordem. Cada passo fornece uma evidência diferente sobre a saúde do relay.

1. Verifique o status do relay no painel de administração do Mastodon
   Faça login na sua instância do Mastodon como administrador. Vá para Preferências > Administração > Relays. Você verá uma lista de relays aos quais sua instância se inscreveu. Cada relay tem um rótulo de status: Ativado significa que o relay está conectado e funcionando. Pendente significa que o relay ainda não aceitou sua inscrição. Desativado significa que a conexão falhou. Se o status for Desativado, clique no botão Ativar ao lado do relay para tentar reconectar.
2. Observe a timeline federada em busca de novas postagens de instâncias relayadas
   Abra a timeline federada (também chamada de timeline local em algumas interfaces) no seu cliente web do Mastodon. Atualize a página a cada 30 segundos por cerca de cinco minutos. Procure por postagens de nomes de usuário que incluam um sinal @ e um domínio diferente da sua própria instância. Essas são postagens encaminhadas pelo relay. Se você não vir nenhuma nova postagem remota após cinco minutos, o relay pode não estar enviando nada.
3. Inspecione os logs do servidor em busca de atividade do relay
   Conecte-se via SSH ao seu servidor Mastodon. Execute o seguinte comando para procurar entradas de log relacionadas ao relay na última hora: grep -i relay /var/log/mastodon/log | tail -50. Procure por linhas contendo relay, forward ou subscribe. Um relay saudável produz linhas como INFO -- : Processing ActivityPub relay delivery. Erros como Net::OpenTimeout ou SSL_connect indicam problemas de conectividade.
4. Teste o endpoint do relay manualmente com curl
   No seu servidor, execute este comando curl para ver se o servidor relay responde: curl -I https://relay.exemplo.com/inbox. Substitua relay.exemplo.com pelo domínio real do seu relay. Uma resposta bem-sucedida retorna o status HTTP 200 ou 202. Um timeout ou 404 significa que o relay está inacessível ou mal configurado. Se o relay for um relay público conhecido, como relay.fedibird.com, verifique sua página de status, se existir.
5. Crie uma postagem de teste em uma instância remota e verifique se ela chega
   Peça a um amigo em outra instância do Mastodon que também esteja inscrita no mesmo relay para publicar uma mensagem pública com uma palavra-chave única, como #relaytest2025. Em seguida, na sua instância, pesquise por essa hashtag usando a barra de pesquisa. Se a postagem aparecer, o relay está enviando conteúdo. Se não aparecer após 10 minutos, o relay não está entregando essa postagem à sua instância.

Se o Relay Ainda Não Enviar Postagens

Quando os passos acima confirmam que o relay não está enviando, o problema geralmente é um desses problemas específicos. Verifique cada um em ordem.

Relay Mostra “Pendente” Indefinidamente

Um status pendente significa que sua instância enviou uma solicitação de seguir, mas o relay não a aceitou. Isso acontece frequentemente quando o relay requer aprovação manual. Acesse o site do relay, se disponível, e procure por um contato de administrador. Alguns relays públicos têm um formulário web para aprovar novos assinantes. Alternativamente, remova o relay de Administração > Relays e adicione-o novamente usando a URL exata fornecida pelo operador do relay.

Postagens Chegam Apenas de Algumas Instâncias, Mas Não de Outras

Se você vê postagens de uma instância remota, mas não de outra, o relay em si está funcionando, mas a instância ausente pode não estar inscrita no mesmo relay. Verifique a lista de membros do relay, se for pública. A instância ausente pode ter saído do relay ou sido removida. Sua instância só recebe postagens de instâncias que também estão inscritas nesse relay.

Relay Funciona, Mas as Postagens Atrasam Horas

Atrasos indicam que a fila do sidekiq da sua instância está acumulada. Conecte-se via SSH ao seu servidor e execute systemctl status mastodon-sidekiq. Se o serviço mostrar um número alto de jobs na fila, as postagens do relay estão esperando para serem processadas. Reinicie o sidekiq com systemctl restart mastodon-sidekiq. Verifique também o uso de CPU e memória do seu servidor. Uma instância com recursos escassos não consegue processar postagens recebidas rapidamente.

URL do Relay Foi Inserida Incorretamente

Um erro comum é adicionar a URL principal do site do relay em vez do endpoint específico da caixa de entrada. A URL correta para a maioria dos relays termina com /inbox. Por exemplo, https://relay.exemplo.com/inbox. Se você inseriu algo como https://relay.exemplo.com, o relay não pode aceitar sua inscrição. Remova o relay e adicione-o novamente com a URL completa da caixa de entrada.

Item	Relay Funcionando	Relay com Falha
Status no painel admin	Ativado	Pendente ou Desativado
Timeline federada após 5 minutos	Mostra novas postagens remotas	Nenhuma postagem remota aparece
Entradas de log do servidor	Contém linhas “relay delivery”	Contém erros de timeout ou SSL
Teste curl para inbox do relay	HTTP 200 ou 202	Timeout ou HTTP 4xx/5xx
Postagem de teste de instância remota	Aparece em até 10 minutos	Não aparece

Agora você pode confirmar se seu relay do Mastodon está enviando postagens ativamente ou precisa ser substituído. Se o relay estiver funcionando, sua timeline federada mostrará um fluxo constante de postagens públicas de outras instâncias. Se não estiver funcionando, verifique primeiro o status do relay no painel de administração, depois confirme a URL e a conectividade de rede. Para falhas persistentes, considere mudar para um relay público diferente, como relay.fedi.network ou relay.fedibird.com. Uma dica: configure um segundo relay como backup para que, se um falhar, sua instância ainda receba conteúdo do outro.