Quando a linha do tempo federada do Mastodon para de mostrar novas postagens de outras instâncias, a experiência parece que a rede ficou em silêncio. Esse problema geralmente decorre de uma interrupção na conectividade entre seu servidor local e instâncias remotas, um processo de atualização em segundo plano travado ou um problema de cache local. Este artigo explica as causas raízes de uma linha do tempo federada congelada e fornece um conjunto claro de etapas de diagnóstico para restaurar a atividade normal.
Principais Conclusões: Diagnosticando uma Linha do Tempo Federada Congelada
- Recarregar a interface web com Ctrl+F5: Força uma atualização completa do cache para descartar dados de página desatualizados.
- Verificar a linha do tempo inicial: Se a linha do tempo inicial atualiza, mas a federada não, o problema está na federação do lado do servidor, não na sua conexão local.
- Logs do servidor em /admin/sidekiq: Mostra trabalhos de federação enfileirados ou com falha que impedem novas postagens remotas de aparecerem.
Por que a Linha do Tempo Federada Para de Receber Novas Postagens
A linha do tempo federada exibe postagens públicas de todas as instâncias que seu servidor conhece. Seu servidor recebe essas postagens através de um sistema de trabalhos em segundo plano chamado Sidekiq. Quando o Sidekiq trava ou fica sem memória, novas postagens remotas não podem ser processadas e a linha do tempo parece congelada.
Outra causa comum é um bloqueio em nível de rede. Se o endereço IP do seu servidor foi limitado por uma instância remota grande, ou se seu servidor está executando uma regra de firewall que restringe conexões de saída para endpoints ActivityPub, o handshake de federação falha silenciosamente. A linha do tempo então mostra apenas conteúdo em cache mais antigo.
Uma terceira causa é um cache local corrompido de instâncias remotas. O Mastodon armazena metadados de instâncias e chaves públicas localmente. Se esse cache ficar desatualizado ou corrompido, seu servidor pode rejeitar novas postagens de instâncias anteriormente confiáveis. Limpar o cache força seu servidor a buscar novamente as informações da instância.
Etapas de Diagnóstico para Restaurar a Linha do Tempo Federada
Siga estas etapas em ordem. Cada etapa isola uma camada específica do problema. Pare quando a linha do tempo começar a atualizar novamente.
- Forçar um recarregamento completo da página
Pressione Ctrl+F5 no Windows ou Cmd+Shift+R no Mac. Isso ignora o cache do navegador e busca os dados mais recentes da página do servidor. Se a linha do tempo atualizar após esta etapa, o problema era um cache local desatualizado. - Verificar a linha do tempo inicial para postagens recentes
Clique no ícone da casa para ver sua linha do tempo inicial. Se você vir novas postagens de pessoas que segue, sua conta e conexão com o servidor estão funcionando. O problema está limitado à linha do tempo federada e provavelmente é do lado do servidor. - Testar com um cliente Mastodon diferente
Abra a mesma linha do tempo federada em um aplicativo diferente, como Tusky no Android ou Ivory no iOS. Se a linha do tempo atualizar lá, mas não na interface web, o problema é específico do navegador. Limpe cookies e dados do site para o domínio da sua instância. - Verificar a conectividade do servidor com uma ferramenta externa
Use um serviço como Mastodon Instance Checker (mastodon-checker.glitch.me) para ver se sua instância está acessível pela internet pública. Digite o domínio da sua instância. Se a verificação falhar, seu servidor pode estar atrás de um firewall ou enfrentando uma interrupção de DNS. - Inspecionar a saúde da fila do Sidekiq
Navegue até Preferências > Administração > Sidekiq (ou vá diretamente para /admin/sidekiq na sua instância). Observe os números de Ocupados e Enfileirados. Se a contagem de Ocupados estiver no máximo de workers permitidos, ou se a contagem de Enfileirados para a fila pull estiver acima de 1000, o servidor está sobrecarregado. Reinicie o Sidekiq pelo terminal do servidor:sudo systemctl restart mastodon-sidekiq. - Limpar o cache da instância
Se o Sidekiq estiver saudável, mas a linha do tempo ainda não mostrar novas postagens, limpe o cache da instância remota. Execute este comando no seu servidor:RAILS_ENV=production bin/tootctl cache clear. Isso remove metadados de instância em cache e força o Mastodon a buscar novamente dados remotos. Após a conclusão do comando, aguarde 5 minutos e atualize a linha do tempo federada. - Verificar bloqueios de conexão de saída
Se seu servidor estiver atrás de um firewall corporativo ou VPN, conexões de saída para as portas 80 e 443 em servidores remotos podem estar restritas. Execute um teste do terminal do servidor:curl -I https://mastodon.social. Se o comando não retornar resposta, sua rede está bloqueando HTTPS de saída. Entre em contato com seu provedor de hospedagem ou administrador de rede.
Se o Mastodon Ainda Mostrar uma Linha do Tempo Federada Congelada
A linha do tempo mostra apenas postagens de uma ou duas instâncias
Isso indica que seu servidor foi parcialmente bloqueado por outras instâncias. Verifique se sua instância aparece em alguma lista de bloqueio da comunidade, como a lista de bloqueio do oliphant.social ou spam.blocklist. Se sua instância estiver listada, o administrador deve entrar em contato com o mantenedor da lista para solicitar a remoção.
A linha do tempo atualiza após reiniciar o servidor, mas para novamente dentro de uma hora
Esse padrão aponta para um vazamento de memória no Sidekiq ou no processo web. Verifique o uso de memória pelo terminal do servidor com htop. Se os processos mastodon-web ou mastodon-sidekiq consumirem mais de 1 GB de RAM cada, aumente a memória do servidor ou reduza o número de workers do Sidekiq. Edite .env.production e diminua o valor de SIDEKIQ_CONCURRENCY para 5.
A linha do tempo federada funciona em dados móveis, mas não no Wi-Fi
Sua rede Wi-Fi pode estar bloqueando tráfego ActivityPub. Algumas redes Wi-Fi públicas bloqueiam protocolos peer-to-peer. Use uma VPN no seu dispositivo para contornar a restrição. Se a linha do tempo atualizar com a VPN ativa, a rede Wi-Fi é a causa.
Comparação de Ferramentas de Diagnóstico da Linha do Tempo do Mastodon
| Item | Atualização de Cache do Navegador | Painel do Sidekiq | Comandos do Terminal do Servidor |
|---|---|---|---|
| Melhor para | Verificação rápida do lado do cliente | Análise da fila de trabalhos do servidor | Diagnóstico profundo de cache e rede |
| Tempo para concluir | 10 segundos | 2 minutos | 10 a 30 minutos |
| Requer acesso ao servidor | Não | Não (painel de administração) | Sim |
| Corrige cache desatualizado | Sim | Não | Sim |
| Corrige Sidekiq sobrecarregado | Não | Sim (identifica o problema) | Sim (reiniciar ou reconfigurar) |
Use a atualização de cache do navegador como primeiro passo. Se isso não ajudar, vá para o painel do Sidekiq. Use comandos do terminal do servidor apenas quando os dois primeiros métodos não mostrarem problema.
Agora você pode diagnosticar uma linha do tempo federada congelada verificando o cache do navegador, a saúde da fila do Sidekiq e a conectividade do servidor nessa ordem. Comece com o recarregamento forçado e o teste da linha do tempo inicial. Se esses passarem, vá para o painel do Sidekiq em /admin/sidekiq. Uma dica avançada: configure um alerta de monitoramento na fila pull do Sidekiq usando uma ferramenta como Uptime Kuma para ser notificado antes que a linha do tempo pare de atualizar novamente.