Você alterou sua foto de perfil na sua instância principal do Mastodon, mas a imagem antiga ainda aparece em outras instâncias. Isso acontece porque as instâncias do Mastodon armazenam dados de perfil em cache localmente para reduzir a carga no servidor. O cache não é atualizado automaticamente quando você muda seu avatar. Este artigo explica por que o cache bloqueia a atualização e mostra três métodos confiáveis para forçar a nova imagem a aparecer em todos os lugares.
Principais conclusões: Forçar a atualização da foto de perfil do Mastodon em todas as instâncias
- Ctrl + F5 (Windows) ou Cmd + Shift + R (Mac): Executa um hard refresh no cache do navegador para carregar o novo avatar do servidor.
- Configurações > Aparência > Avançado > Limpar cache: Limpa o cache local do aplicativo web do Mastodon para forçar um novo download dos dados do seu perfil.
- Limpeza de cache do servidor de terceiros: Administradores podem limpar o cache da instância remota usando a API do Mastodon ou um comando manual no servidor para propagar a atualização.
Por que as fotos de perfil do Mastodon ficam travadas em outras instâncias
Mastodon é uma rede federada. Quando você publica ou atualiza seu perfil, sua instância principal envia os novos dados para instâncias remotas. Essas instâncias remotas armazenam uma cópia local da sua foto de perfil para evitar solicitar a imagem da sua instância principal toda vez que alguém visualiza seu perfil. Essa cópia local é chamada de cache.
O tempo de expiração do cache depende da configuração da instância remota. Muitas instâncias mantêm a mídia em cache por 24 horas ou mais. Durante esse período, a instância remota exibe a imagem antiga para seus usuários. Sua instância principal mostra a nova imagem imediatamente porque não armazena em cache os dados de seus próprios usuários.
Outro fator é o cache do navegador no lado do visualizador. Quando um usuário visita seu perfil, o navegador salva a resposta da URL da imagem. Mesmo que a instância remota atualize seu cache, o navegador pode continuar servindo o arquivo antigo do armazenamento local. Isso cria um problema de cache duplo que torna a atualização invisível.
Passos para forçar a atualização da foto de perfil em todas as instâncias
Use os métodos abaixo em ordem. Comece com a correção rápida do navegador, depois limpe o cache do aplicativo web do Mastodon e, por fim, limpe o cache do servidor se você tiver acesso administrativo.
Método 1: Hard refresh no cache do navegador
Este método força o navegador a ignorar o cache local e solicitar a imagem diretamente do servidor.
- Abra sua página de perfil do Mastodon
Navegue até a URL do seu perfil em qualquer instância onde a imagem antiga ainda aparece. - Faça um hard refresh
Pressione Ctrl + F5 no Windows ou Cmd + Shift + R no Mac. A página recarrega e o navegador solicita todos os recursos do servidor sem usar o cache local. - Verifique a foto de perfil
Se a nova imagem aparecer, o problema era apenas o cache do navegador. Se ainda mostrar a imagem antiga, vá para o Método 2.
Método 2: Limpar o cache do aplicativo web do Mastodon
O Mastodon armazena alguns dados no navegador usando IndexedDB e armazenamento local. Limpar esse cache força o aplicativo web a buscar novamente os dados do seu perfil.
- Vá para as configurações do Mastodon
Clique no ícone de engrenagem na coluna direita da interface web do Mastodon para abrir as Configurações. - Abra as configurações de Aparência
Na barra lateral esquerda, clique em Aparência. - Expanda as opções avançadas
Role para baixo e clique em Mostrar opções avançadas. - Limpe o cache
Clique no botão Limpar cache. Uma caixa de diálogo de confirmação aparece. Clique em OK. - Recarregue a página
Pressione F5 para atualizar a página. Sua foto de perfil agora deve mostrar a versão atualizada.
Método 3: Limpar o cache do servidor na sua instância principal
Este método requer acesso administrativo à sua instância do Mastodon. Ele força a instância a reprocessar a mídia do seu perfil e enviar a atualização para servidores remotos.
- Abra um terminal ou sessão SSH
Faça login no seu servidor Mastodon como um usuário com privilégios sudo. - Execute o comando de limpeza de cache de mídia
Digite o seguinte comando:RAILS_ENV=production bin/tootctl media remove --days 0 --include-thumbnails
Isso remove todas as miniaturas em cache e força o Mastodon a regenerá-las na próxima solicitação. - Reenvie sua foto de perfil
Vá para Preferências > Perfil > Avatar e faça o upload da imagem novamente. Isso aciona um novo processo de processamento de mídia que cria miniaturas novas. - Aguarde a federação
Instâncias remotas podem levar até 24 horas para pegar a nova imagem. Você pode acelerar isso pedindo a usuários de outras instâncias que façam um hard refresh conforme descrito no Método 1.
Se a foto de perfil ainda não atualizar
Imagem antiga persiste em aplicativos de terceiros específicos
Aplicativos Mastodon de terceiros como Tusky, Mammoth ou Ivory geralmente armazenam fotos de perfil em cache separadamente. Feche o aplicativo completamente e reabra. Se o problema continuar, limpe o cache do aplicativo através das configurações do dispositivo. No Android, vá para Configurações > Aplicativos > [Nome do App] > Armazenamento > Limpar cache. No iOS, desinstale e reinstale o aplicativo, pois o iOS não oferece uma opção de limpeza de cache por aplicativo.
Imagem aparece atualizada em algumas instâncias, mas não em outras
Isso indica que algumas instâncias remotas têm um período de cache mais longo que outras. Não há como forçar uma instância remota a limpar seu cache, a menos que você seja o administrador. Aguarde o período padrão de 24 a 48 horas. Se a imagem ainda não atualizar em uma instância específica após 48 horas, entre em contato com o administrador da instância e peça para limpar o cache de mídia manualmente usando o comando tootctl media remove.
Nova imagem aparece quebrada ou ausente
Uma imagem quebrada geralmente significa que o upload do arquivo falhou ou o formato da imagem não é suportado. O Mastodon suporta JPEG, PNG, GIF e WebP. Reenvie a imagem em um desses formatos. Se o problema persistir, verifique o espaço em disco da sua instância. Um disco cheio impede que novas mídias sejam armazenadas. Peça ao seu administrador para executar df -h no servidor para verificar o espaço disponível.
Métodos de atualização de foto de perfil do Mastodon: Navegador vs Cache do App vs Limpeza de Servidor
| Item | Hard Refresh do Navegador | Limpeza de Cache do App Web | Limpeza de Cache de Mídia do Servidor |
|---|---|---|---|
| O que corrige | Cache do navegador do visualizador | Cache IndexedDB do Mastodon | Miniaturas do lado do servidor e cache remoto |
| Tempo para aplicar | 2 segundos | 30 segundos | 5 a 10 minutos |
| Requer acesso de administrador | Não | Não | Sim |
| Efeito em instâncias remotas | Nenhum | Nenhum | Força nova busca da sua instância |
| Taxa de sucesso | Baixa se o cache remoto estiver ativo | Média | Alta |
Agora você pode forçar a atualização da foto de perfil em instâncias do Mastodon usando o hard refresh do navegador, a limpeza de cache do aplicativo web ou a limpeza de mídia do servidor. Comece com o método do navegador, pois leva menos tempo. Se a imagem antiga permanecer, limpe o cache do Mastodon nas configurações de Aparência. Para problemas persistentes, peça ao administrador da sua instância para executar o comando tootctl media remove. Uma dica avançada útil é definir sua foto de perfil para uma URL que retorne um parâmetro de quebra de cache, como ?v=2, mas o Mastodon atualmente remove parâmetros de consulta de mídias enviadas. A abordagem mais confiável é reenviar a imagem após limpar o cache do servidor.