Ao administrar um servidor Mastodon e tentar re-federar um perfil de usuário pelo painel admin, você pode ver o erro “Could not re-federate profile”. Esse erro significa que o servidor falhou ao enviar os dados do perfil para outras instâncias no fediverso. A causa geralmente é um problema temporário de rede, um bloqueio de domínio mal configurado ou um problema com o estado da conta do usuário no banco de dados. Este artigo explica por que esse erro ocorre e fornece correções passo a passo que você pode aplicar pela linha de comando e pela interface admin.
Principais conclusões: Corrigindo o erro de re-federation no admin do Mastodon
- Admin > Moderação > Contas > Pesquisar usuário > Re-federar: O botão que aciona a ação de re-federation; ele falha quando o servidor não consegue se conectar a outras instâncias.
- Inspeção da fila do Sidekiq: Verifique a fila “Push” em busca de jobs travados que bloqueiam a re-federation do perfil.
- Comando CLI
tootctl accounts refresh: Força uma atualização completa do perfil do usuário e o re-federate pela linha de comando.
Por que a ação de re-federate perfil falha no admin do Mastodon
O recurso de re-federate envia os dados do perfil do usuário para todas as instâncias remotas conhecidas via ActivityPub. Quando você clica em “Re-federar” no painel admin, o Mastodon enfileira um job em segundo plano no Sidekiq. Se esse job falhar, a interface admin exibe a mensagem de erro.
Problemas de conectividade de rede
O servidor Mastodon precisa alcançar instâncias remotas via HTTPS. Se o seu servidor tiver uma falha temporária de DNS, uma regra de firewall bloqueando conexões de saída ou um limite de taxa de um servidor remoto, o job de re-federation falha. Esta é a causa mais comum.
Bloqueios de domínio ou regras de silêncio
Se sua instância tiver um bloqueio de domínio ou regra de silêncio que afete a instância remota, o job de re-federation não consegue entregar o perfil. O painel admin nem sempre avisa sobre bloqueios existentes durante a re-federation.
Estado de conta corrompido no banco de dados
O registro da conta do usuário pode ter uma flag “suspended” desatualizada ou uma chave pública ausente. Isso impede que o servidor assine corretamente o payload do ActivityPub. A inconsistência no banco de dados pode ocorrer após uma migração falha ou uma importação parcial.
Passos para corrigir o erro de re-federate perfil no admin do Mastodon
Siga estes passos em ordem. Comece com a correção mais simples e prossiga para os comandos mais avançados apenas se necessário.
- Verifique as filas do Sidekiq em busca de jobs push travados
Abra seu painel do Sidekiq emhttps://suainstancia.com/sidekiq/queues. Olhe para a fila “push”. Se você vir muitos jobs em retry ou dead, clique em “Limpar retries” ou “Limpar dead” para removê-los. Depois volte para Admin > Moderação > Contas, pesquise o usuário e clique em “Re-federar” novamente. - Verifique bloqueios de domínio e regras de silêncio
Em Admin > Moderação > Bloqueios de domínio, verifique se você tem algum bloqueio ou regra de silêncio para as instâncias remotas que devem receber o perfil. Se encontrar um bloqueio, remova-o ou defina como “Nenhuma ação” para que a re-federation funcione. Após remover o bloqueio, tente re-federar novamente pela página da conta do usuário. - Reinicie o processo do Sidekiq
Acesse seu servidor via SSH. Executesudo systemctl restart sidekiq. Isso limpa quaisquer processos de jobs travados. Aguarde 30 segundos e tente novamente a ação de re-federate no painel admin. - Atualize a conta do usuário pela linha de comando
Se a interface admin ainda falhar, use a CLI do Mastodon. Acesse seu servidor via SSH como usuário mastodon:sudo -u mastodon bash. Depois executeRAILS_ENV=production bin/tootctl accounts refresh USERNAME, onde USERNAME é o handle completo incluindo o domínio (ex.:@usuario@exemplo.com). Este comando reconstrói o perfil do usuário e o envia para todas as instâncias remotas conhecidas. - Verifique o log do Mastodon para erros detalhados
Executesudo journalctl -u mastodon-sidekiq -n 50para ver as últimas 50 linhas do log do Sidekiq. Procure por linhas contendo “Re-federate” ou “PushService”. Se você vir um erro específico como “Net::OpenTimeout” ou “OpenSSL::SSL::SSLError”, isso aponta para um problema de rede. Se vir “ActiveRecord::RecordInvalid”, os dados da conta estão corrompidos e você precisa restaurar a partir de um backup. - Re-federe todos os perfis na instância como último recurso
Se apenas um usuário falhar e os passos acima não funcionarem, executeRAILS_ENV=production bin/tootctl accounts refresh --all. Isso re-federate todos os perfis da sua instância. Pode levar vários minutos. Após terminar, verifique se o usuário problemático agora funciona.
Se o Mastodon ainda mostrar o erro de re-federate após essas correções
Botão “Re-federar” está desabilitado ou ausente
O botão só aparece para usuários locais. Se você estiver olhando o perfil de um usuário remoto, não é possível re-federá-lo. A interface admin só suporta re-federation para usuários que se registraram na sua instância.
Outros usuários na mesma instância também falham ao re-federar
Se vários usuários falharem, o problema provavelmente é global. Verifique a conectividade de saída do seu servidor executando curl -I https://mastodon.social a partir do seu servidor. Se falhar, corrija as configurações de firewall ou DNS. Verifique também se sua instância está sendo limitada por servidores remotos grandes.
Re-federation funciona, mas seguidores não veem atualizações
A ação de re-federate apenas envia o perfil, não todo o histórico de postagens. Se os seguidores não virem novas postagens após a re-federation, o usuário pode ter a conta configurada como “Conta bloqueada”. Vá em Preferências > Conta > Privacidade e segurança e desmarque “Exigir solicitações de seguimento”. Depois re-federe novamente.
Erro de re-federate perfil: Painel admin vs Comando CLI
| Item | Painel Admin (botão Re-federar) | Comando CLI (tootctl accounts refresh) |
|---|---|---|
| Interface | Interface web | Linha de comando |
| Escopo | Usuário único | Usuário único ou todos os usuários |
| Feedback de erro | Genérico “Could not re-federate profile” | Saída de erro detalhada no terminal |
| Dependência do Sidekiq | Sim, enfileira um job em segundo plano | Não, executa de forma síncrona |
| Acesso necessário | Conta admin | Acesso SSH e usuário mastodon |
O comando CLI oferece mais controle e melhores mensagens de erro. Use-o quando o painel admin falhar repetidamente. O painel admin é mais rápido para verificações pontuais, mas fornece menos informações de diagnóstico.
Agora você pode resolver o erro “Could not re-federate profile” verificando as filas do Sidekiq, removendo bloqueios de domínio ou usando o comando de atualização via CLI. Comece com a inspeção da fila do Sidekiq, pois ela resolve a maioria dos casos sem exigir acesso SSH. Se você gerencia vários servidores Mastodon, considere configurar um script de monitoramento que execute tootctl accounts refresh automaticamente para contas que não foram re-federadas nas últimas 24 horas.