Ao sair de uma instância do Mastodon, você pode baixar um arquivo com seus dados, incluindo publicações, mídias e listas. No entanto, simplesmente enviar esse arquivo para uma nova instância não carrega automaticamente seu conteúdo antigo na timeline ativa. O arquivo do Mastodon foi projetado para portabilidade e backup, não como uma ferramenta de importação ao vivo que mescla publicações na nova conta. Este artigo explica o que o arquivo de exportação realmente contém, como restaurá-lo usando os recursos de importação integrados e quais limitações você encontrará após a restauração.
Principais Conclusões: Restaurar um Arquivo de Exportação do Mastodon
- Preferências > Importar e exportar > Importar: Envie seus arquivos CSV para listas de seguindo, bloqueios, silenciamentos e bloqueios de domínio.
- Formato do arquivo baixado: O Mastodon fornece um arquivo ZIP contendo arquivos CSV e uma pasta de mídia, não um snapshot completo do banco de dados.
- Publicações não são restauradas: O arquivo inclui suas publicações antigas em um arquivo HTML para visualização local apenas; elas não podem ser reinseridas na timeline da nova instância.
O que o Arquivo de Exportação do Mastodon Contém e Suas Limitações
Ao solicitar uma exportação de dados do Mastodon em Preferências > Importar e exportar > Exportar dados, o servidor gera um arquivo ZIP. Dentro, você encontrará vários arquivos CSV e um arquivo HTML chamado “outbox.html” que contém todas as suas publicações públicas em formato legível. Os arquivos CSV incluem listas de contas que você segue, contas que seguem você, contas bloqueadas, contas silenciadas e bloqueios de domínio. Uma pasta separada chamada “media_attachments” contém as imagens e vídeos que você enviou em suas publicações.
A limitação crítica é que o arquivo outbox.html não está em um formato importável. O sistema de importação do Mastodon processa apenas arquivos CSV. Isso significa que seus toots, boosts e respostas antigos permanecem no arquivo como um registro estático. Eles não aparecerão na timeline pública, perfil ou resultados de busca da sua nova instância. Os anexos de mídia também não são restaurados automaticamente; eles são armazenados localmente no arquivo para sua referência, mas não são enviados para o novo servidor.
O que Você Pode Restaurar
Você pode restaurar as seguintes listas importando seus arquivos CSV correspondentes:
- Lista de seguindo (quem você seguia)
- Lista de seguidores (quem seguia você — é apenas informativa; a nova instância não pode forçar seguidores antigos a seguirem você)
- Contas bloqueadas
- Contas silenciadas
- Bloqueios de domínio
O CSV de seguidores é útil para encontrar e reconectar manualmente com pessoas que seguiam você, mas o Mastodon não restabelece essas conexões automaticamente. Cada usuário precisa segui-lo novamente na sua nova instância.
O que Você Não Pode Restaurar
Os seguintes itens não podem ser importados para uma nova instância a partir do arquivo:
- Suas publicações, boosts e respostas antigas
- Anexos de mídia de publicações antigas
- Mensagens diretas (elas não estão incluídas na exportação)
- Seu nome de exibição, biografia, imagem de cabeçalho e avatar
- Seus favoritos e listas (as associações de lista não são exportadas)
Passos para Importar o Arquivo de Exportação em uma Nova Instância do Mastodon
- Faça login na sua nova instância do Mastodon
Abra seu navegador e acesse a instância onde você criou sua nova conta. Insira seu e-mail e senha para acessar o painel da conta. - Navegue até as configurações de importação
Clique no ícone de engrenagem ou no avatar do perfil para abrir Preferências. No menu à esquerda, selecione Importar e exportar e depois clique na aba Importar. - Escolha o tipo de dado a importar
No menu suspenso “Tipo de importação”, selecione a categoria que corresponde ao arquivo CSV que você deseja enviar. As opções incluem Lista de seguindo, Lista de bloqueios, Lista de silenciamentos e Lista de bloqueios de domínio. Você deve repetir esse processo para cada arquivo CSV separadamente. - Envie o arquivo CSV
Clique no botão Escolher arquivo e localize o arquivo CSV correspondente do seu arquivo extraído. Por exemplo, para restaurar quem você seguia, selecione o arquivo following_accounts.csv. Após selecionar o arquivo, clique no botão Enviar. - Confirme o comportamento de mesclagem
Uma caixa de diálogo pergunta se você deseja mesclar a lista importada com a lista atual ou substituí-la completamente. Escolha Mesclar para adicionar as contas importadas à sua lista existente, ou Substituir para substituir a lista atual pela importada. Clique em Confirmar para iniciar a importação. - Aguarde a conclusão da importação
O Mastodon processa importações como uma tarefa em segundo plano. Dependendo do tamanho da lista, pode levar de alguns segundos a vários minutos. Uma notificação aparece quando a importação termina. Não feche a aba do navegador durante o processamento. - Repita para cada arquivo CSV
Volte à aba Importar e repita os passos 3 a 6 para blocking_accounts.csv, muting_accounts.csv e domain_blocks.csv, se desejar restaurar essas listas também. - Restaure manualmente seu perfil e mídia
Vá em Preferências > Aparência para definir seu nome de exibição e biografia. Envie seu avatar e imagem de cabeçalho da pasta media_attachments do seu arquivo. Essas configurações não são importadas automaticamente.
Problemas Comuns ao Restaurar um Arquivo do Mastodon
Erros de Formato do Arquivo CSV Durante a Importação
Se o Mastodon rejeitar seu arquivo CSV, a causa mais comum é uma incompatibilidade nos cabeçalhos das colunas. O sistema de importação espera nomes de colunas específicos. Abra o arquivo CSV em um editor de texto simples e verifique se a primeira linha contém exatamente: Account address, Show boosts. Cada linha subsequente deve conter o endereço ActivityPub completo da conta, como @usuario@instancia.social. Remova colunas extras ou linhas vazias antes de reenviar.
Lista de Seguidores Não Restaura Conexões
Muitos usuários esperam que importar o CSV de seguidores faça automaticamente com que essas contas os sigam na nova instância. Isso não é suportado. O CSV de seguidores é fornecido apenas para referência. Para reconectar com seus seguidores antigos, publique um post na sua nova conta anunciando a mudança e peça para eles seguirem você lá. Alternativamente, use o recurso Mover conta em Preferências > Conta > Mover para outra conta se você ainda tiver acesso à sua instância antiga.
Anexos de Mídia Não Visíveis Após a Importação
A pasta media_attachments do seu arquivo contém suas imagens e vídeos antigos, mas o Mastodon não oferece um mecanismo de upload em massa para esses arquivos. Para adicionar mídia a novas publicações, você deve enviar cada arquivo individualmente através da caixa de composição. Não há como anexar mídia antiga a publicações antigas, pois essas publicações não foram importadas.
Processo de Importação Travado ou Falha Silenciosa
Se o botão de importação não responder ou a página atualizar sem uma mensagem de sucesso, o arquivo CSV pode ser grande demais para o limite de upload da sua instância. Divida o CSV em arquivos menores de 500 linhas cada e importe um de cada vez. Certifique-se também de que seu navegador permite pop-ups e notificações do domínio da instância, pois o aviso de conclusão pode ser bloqueado.
| Item | Download do Arquivo | Importação para Nova Instância |
|---|---|---|
| Lista de seguindo | Exportada como following_accounts.csv | Importada via Preferências > Importar |
| Lista de seguidores | Exportada como followers.csv | Não importável; apenas referência |
| Contas bloqueadas | Exportada como blocking_accounts.csv | Importada via Preferências > Importar |
| Contas silenciadas | Exportada como muting_accounts.csv | Importada via Preferências > Importar |
| Bloqueios de domínio | Exportada como domain_blocks.csv | Importada via Preferências > Importar |
| Publicações antigas | Exportadas como outbox.html | Não importável |
| Anexos de mídia | Exportados como pasta media_attachments | Não importável; enviar manualmente |
Após concluir as etapas de importação, sua nova instância refletirá as listas de seguindo, bloqueios, silenciamentos e bloqueios de domínio da sua conta antiga. Suas publicações antigas permanecem acessíveis apenas no arquivo outbox.html no seu computador local. Para preservar seu histórico de publicações para referência futura, mantenha o arquivo em um local seguro. Se quiser que seus seguidores antigos o encontrem, considere usar o recurso Mover conta da sua instância antiga antes que ela se torne inacessível. Esse recurso envia uma notificação única para todos os seus seguidores com o endereço da sua nova conta.