A federação do Mastodon permite que usuários de servidores diferentes sigam uns aos outros e compartilhem postagens. Mas às vezes você não consegue saber se sua instância está realmente federando corretamente com o resto do fediverso. Você pode ver uma linha do tempo federada vazia ou suas postagens nunca alcançarem usuários em outras instâncias. Este artigo explica como usar uma instância de teste independente para verificar se seu servidor Mastodon consegue enviar e receber dados pela rede. Você aprenderá as etapas exatas para verificar a federação e o que os resultados significam.
Principais Conclusões: Testando a Federação do Mastodon com um Serviço de Verificação Remota
- Instância de teste de federação em fedi.tips/check-federation: Envia uma mensagem de teste de um servidor externo para sua conta para confirmar que a federação de entrada funciona.
- Seu domínio do Mastodon e a URL de uma postagem pública: Informações necessárias para a ferramenta de teste iniciar o handshake com sua instância.
- Notificação da mensagem de teste no seu cliente Mastodon: A confirmação visível de que sua instância aceitou uma postagem remota do servidor de teste.
Por que a Federação Pode Falhar Sem Nenhuma Mensagem de Erro
A federação do Mastodon depende do ActivityPub, um protocolo descentralizado. Sua instância deve ser capaz de receber requisições de entrada de outros servidores e entregar postagens de saída para eles. Muitos administradores de servidor assumem que a federação funciona porque conseguem ver postagens locais ou seguir contas em instâncias populares como mastodon.social. Mas uma porta bloqueada, um proxy reverso mal configurado ou uma regra de firewall pode silenciosamente quebrar o tráfego de saída ou entrada. A própria instância não mostrará um erro porque não consegue detectar que o servidor remoto nunca recebeu os dados. Uma instância de teste independente ignora a visão do seu próprio servidor e verifica a conectividade de fora.
A ferramenta check-federation do fedi.tips é um serviço de terceiros que não pertence à sua instância. Ela envia uma postagem de teste do seu próprio servidor Mastodon diretamente para sua conta. Se sua instância aceitar essa postagem, você sabe que a federação de entrada funciona. Se a postagem nunca chegar, o problema está do seu lado. Este método é mais confiável do que verificar logs porque simula tráfego real de usuários.
Passos para Verificar a Federação Usando a Instância de Teste do fedi.tips
- Abra a página de teste de federação
Acesse fedi.tips/check-federation no seu navegador. Esta página é mantida pela comunidade fedi.tips e não requer registro. - Insira seu domínio do Mastodon
Digite o domínio completo da sua instância, por exemplo mastodon.exemplo.com. Não inclua o protocolo ou uma barra no final. A ferramenta de teste precisa disso para rotear a mensagem de teste para seu servidor. - Forneça a URL de uma postagem pública da sua conta
Copie a URL de qualquer postagem pública que você tenha feito na sua instância. A ferramenta de teste usará essa postagem para verificar se sua instância pode ser alcançada e se a postagem está visível para servidores externos. Se a postagem estiver configurada como seguidores-only ou não listada, o teste pode falhar. - Inicie o teste
Clique no botão Check Federation ou similar. A ferramenta enviará uma postagem de teste do seu próprio servidor Mastodon para sua conta. Esse processo leva alguns segundos. - Verifique suas notificações do Mastodon
Abra seu cliente Mastodon ou a interface web. Olhe na aba de notificações. Você deve ver uma nova notificação da conta de teste @feditips@mastodonapp.uk contendo a mensagem de teste. Se a notificação aparecer, a federação de entrada está funcionando. - Verifique a postagem de teste na sua linha do tempo federada
Mude para sua linha do tempo federada. A postagem de teste do @feditips deve aparecer também. Isso confirma que sua instância não está apenas recebendo postagens remotas, mas também as exibindo no feed público.
Se você não vir a notificação em dois minutos, atualize a página e tente novamente. Algumas instâncias demoram mais para processar mensagens ActivityPub recebidas.
O Que Fazer se o Teste de Federação Falhar
Nenhuma notificação chega da conta de teste
Isso geralmente significa que o servidor de teste não consegue alcançar sua instância. Verifique o firewall do servidor e a configuração do proxy reverso. Certifique-se de que as portas 443 e 80 estão abertas para tráfego de entrada. Confirme também que o processo sidekiq do Mastodon está em execução. O Sidekiq lida com a entrega de ActivityPub de entrada. Se o sidekiq estiver parado, sua instância não processará mensagens recebidas.
A notificação chega, mas a linha do tempo federada continua vazia
Isso indica que a federação de entrada funciona, mas sua instância pode ter um filtro ou uma configuração que oculta postagens remotas da linha do tempo pública. Verifique as Configurações do Site no painel de administração. Certifique-se de que a opção Modo de federação limitada está desabilitada. Verifique também se você não silenciou manualmente a conta de teste ou a instância de teste. Vá em Preferências > Usuários silenciados e Preferências > Domínios silenciados para confirmar.
O teste funciona, mas usuários em outras instâncias não veem suas postagens
A federação de saída ainda pode estar quebrada. Execute um segundo teste pedindo a um amigo em uma instância diferente que verifique se suas postagens públicas aparecem na linha do tempo federada dele. Se não aparecerem, inspecione suas filas sidekiq de saída. No painel de administração do Mastodon, vá em Sidekiq > Filas e procure por um grande acúmulo na fila push. Um acúmulo significa que as entregas de saída estão falhando. Causas comuns são problemas de resolução de DNS ou limites de taxa no servidor remoto.
| Item | Federação de Entrada (Recebimento) | Federação de Saída (Envio) |
|---|---|---|
| O que é testado | Capacidade de aceitar postagens remotas de outra instância | Capacidade de entregar postagens locais para instâncias remotas |
| Método de teste | Use fedi.tips/check-federation para enviar uma postagem de teste para sua conta | Peça a um usuário em outra instância para verificar sua postagem pública |
| Sinais comuns de falha | Nenhuma notificação da conta de teste, linha do tempo federada vazia | Usuários remotos nunca veem suas postagens, acúmulo na fila push |
| Causa provável | Firewall bloqueando a porta 443, sidekiq parado, modo de federação limitada ativado | Configuração incorreta de DNS, limite de taxa ou servidor na lista negra |
Agora você pode confirmar se sua instância Mastodon federar corretamente com o resto do fediverso. Use a ferramenta de teste do fedi.tips regularmente após atualizações do servidor ou mudanças de configuração. Se o teste falhar, verifique primeiro seu firewall, filas sidekiq e modo de federação limitada. Para uma verificação mais aprofundada, monitore os logs do sidekiq da sua instância em busca de falhas de push usando o comando journalctl -u mastodon-sidekiq -f no servidor.