Como Criar um Backup Automático do Mastodon para o S3

O Mastodon armazena seus dados, incluindo publicações, mídias e seguidores, no servidor que você escolheu. Se perder o acesso a esse servidor ou ele for desativado, seus dados podem desaparecer. A exportação manual pela interface web cria um arquivo de backup, mas você precisa baixá-lo toda vez e armazená-lo localmente. Este artigo … Leia mais

Verificação de Exportação do Mastodon: Como Confirmar que Nenhuma Postagem Foi Perdida

Após exportar seu arquivo do Mastodon, você pode se preocupar que algumas postagens foram omitidas durante o processo. A ferramenta de exportação gera um arquivo JSON contendo os status, mas interrupções de rede ou limites de taxa do servidor podem truncar os dados. Este artigo explica como verificar a integridade da sua exportação do Mastodon, conferindo contagens de posts, timestamps e integridade do arquivo. … Leia mais

Como Exportar Campos do Perfil do Mastodon com Token da API

Você quer exportar os campos do seu perfil do Mastodon — os rótulos e valores personalizados que você definiu nas configurações — para fazer backup ou reutilizá-los em outra instância. O Mastodon não oferece uma exportação com um clique para campos de perfil na interface web. No entanto, você pode recuperá-los programaticamente usando seu token de API e uma chamada simples. Este artigo explica como gerar o token, chamar o endpoint correto e salvar os campos como um arquivo JSON estruturado.

Configuração de Cron Job para Exportação de Backup do Mastodon

Como administrador de um servidor Mastodon, você precisa de uma estratégia de backup confiável para proteger dados de usuários, arquivos de mídia e configurações. Exportações manuais consomem tempo e estão sujeitas a erros humanos, especialmente ao gerenciar uma instância em crescimento. Este artigo explica como configurar um cron job automatizado que executa uma exportação do Mastodon em um agendamento, criando backups regulares sem intervenção manual.

Como Restaurar um Arquivo de Exportação do Mastodon em uma Nova Instância

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 contém, como restaurá-lo usando os recursos de importação integrados e quais limitações você encontrará após a restauração.

Exportar Posts Fixados do Mastodon: Como Lidar Separadamente

Quando você exporta os dados da sua conta do Mastodon, o arquivo padrão inclui suas postagens, arquivos de mídia e lista de seguidores. Mas os posts fixados — aqueles que você fixou manualmente no topo do seu perfil — não são incluídos como um item separado na exportação padrão. Isso pode ser confuso se você quiser preservá-los ao migrar para uma nova instância ou fazer backup da estrutura do seu perfil. A ferramenta de exportação do Mastodon não oferece uma opção dedicada para posts fixados porque eles são tratados como um sinalizador de metadados anexado a postagens individuais. Este artigo explica como localizar seus posts fixados dentro do arquivo de exportação e como extraí-los manualmente para tratamento separado.

Principais Conclusões: Extraindo Posts Fixados de uma Exportação do Mastodon

  • Preferências > Importar e Exportar > Exportar: Gera um arquivo ZIP com seus dados do Mastodon, mas os posts fixados não são listados separadamente.
  • Arquivo outbox.json dentro do arquivo: Contém todas as postagens que você fez, cada uma com um campo type que distingue posts fixados de posts comuns.
  • Filtro manual de JSON ou extensão de navegador: Os únicos métodos confiáveis para isolar posts fixados para um backup ou migração separada.

Por que os Posts Fixados Não São Exportados Separadamente

O Mastodon não trata posts fixados como um tipo de conteúdo distinto. Quando você fixa uma postagem, o servidor adiciona um sinalizador pinned aos metadados da postagem no banco de dados. O processo de exportação padrão — acessado através de Preferências > Importar e Exportar > Exportar — coleta todas as postagens, arquivos de mídia, seguidores e outros dados da conta em um único arquivo ZIP. O arquivo contém um arquivo outbox.json que lista cada postagem no formato ActivityPub. Cada objeto de postagem inclui um campo type. Para posts fixados, o valor de type é Add em vez de Create para postagens comuns. Essa diferença sutil é a única maneira de identificar posts fixados na exportação.

Os desenvolvedores do Mastodon escolheram esse design porque posts fixados não são uma entidade de dados separada. Eles são simplesmente postagens comuns com um sinalizador adicional. Quando você migra para uma nova instância usando a ferramenta de migração de conta padrão, seus posts fixados não são transferidos automaticamente. A ferramenta de migração copia seus seguidores, solicitações de seguimento, listas e contas silenciadas ou bloqueadas — mas não suas postagens ou posts fixados. Para preservar os posts fixados, você deve fixá-los manualmente novamente após a migração ou usar um método alternativo para extraí-los do arquivo de exportação.

Passos para Extrair Posts Fixados do Arquivo de Exportação do Mastodon

Siga estes passos para localizar e extrair seus posts fixados da exportação padrão do Mastodon. Você precisará de um editor de texto que possa lidar com arquivos JSON grandes, como Visual Studio Code, Notepad++ ou qualquer visualizador JSON.

  1. Gerar o arquivo de exportação
    Vá para Preferências > Importar e Exportar > Exportar. Clique no botão Solicitar seu arquivo. O Mastodon preparará um arquivo ZIP contendo seus dados da conta. Dependendo do tamanho da sua conta, isso pode levar alguns minutos. Quando o arquivo estiver pronto, você receberá um e-mail com um link de download. Baixe o arquivo ZIP para o seu computador.
  2. Extrair o arquivo ZIP
    Use a ferramenta de extração de arquivos do seu sistema operacional para descompactar o arquivo baixado. Dentro, você verá pastas chamadas media_attachments, avatar, header e um arquivo chamado outbox.json. O arquivo outbox.json contém todas as suas postagens em formato JSON.
  3. Abrir outbox.json em um visualizador JSON
    Abra outbox.json em um editor de texto ou visualizador JSON. A estrutura do arquivo começa com um campo @context e type. Role para baixo até o array orderedItems. Cada objeto neste array representa uma postagem.
  4. Encontrar os posts fixados
    Procure por objetos onde o campo type é Add. Estes são seus posts fixados. Cada objeto Add contém um campo object com os dados completos da postagem, incluindo o conteúdo, URL e URLs de anexos. Copie o objeto Add inteiro para cada post fixado.
  5. Criar um arquivo JSON separado para posts fixados
    Abra um novo arquivo no seu editor de texto. Cole os objetos Add copiados neste arquivo. Salve o arquivo como pinned-posts.json. Este arquivo agora contém apenas seus posts fixados e pode ser usado para fixação manual ou fins de arquivamento.
  6. Fixar manualmente na nova instância
    Se você estiver migrando para uma nova instância do Mastodon, precisará recriar cada post fixado manualmente. Use as URLs do campo object para localizar as postagens originais na sua instância antiga. Se a instância antiga ainda estiver acessível, você pode copiar o conteúdo e os anexos e criar novas postagens na nova instância. Em seguida, fixe cada nova postagem clicando no menu de três pontos na postagem e selecionando Fixar.

Problemas Comuns ao Lidar com Posts Fixados em Exportações

Posts fixados não aparecem na exportação

Se o seu arquivo de exportação não contiver nenhum objeto do tipo Add, verifique se você gerou o arquivo após fixar as postagens. A exportação captura o estado da sua conta no momento em que você a solicita. Se você fixou posts após a exportação ser gerada, eles não aparecerão. Solicite uma nova exportação após fixar. Verifique também se os posts ainda estão fixados no seu perfil. Posts desafixados não aparecerão como objetos Add.

O arquivo outbox.json é muito grande para abrir

Se você tem milhares de postagens, o outbox.json pode exceder os limites de memória de editores de texto básicos. Use um analisador JSON de streaming ou uma ferramenta de linha de comando como jq para filtrar apenas os objetos Add. Por exemplo, execute jq '.orderedItems[] | select(.type == "Add")' outbox.json > pinned-posts.json em um terminal. Este comando extrai apenas os posts fixados sem carregar o arquivo inteiro na memória.

Posts fixados não são transferidos durante a migração de conta

A migração de conta no Mastodon move apenas seus seguidores, solicitações de seguimento, listas e configurações de silenciamento ou bloqueio. Suas postagens, incluindo posts fixados, permanecem na instância antiga. Para preservar os posts fixados, você deve exportá-los manualmente conforme descrito acima ou manter a instância antiga ativa como um arquivo somente leitura. Após a migração, você pode fixar manualmente os posts na nova instância usando o conteúdo da exportação.

Item Exportação Padrão Extração Manual de Posts Fixados
Dados incluídos Todas as postagens, mídia, seguidores, solicitações de seguimento, listas, listas de silenciamento/bloqueio Apenas posts fixados identificados por type: Add no outbox.json
Formato do arquivo Arquivo ZIP com outbox.json e pastas de mídia Arquivo JSON personalizado contendo apenas objetos de posts fixados
Facilidade de uso Exportação com um clique a partir de Preferências Requer filtragem manual de JSON ou ferramenta de linha de comando
Compatibilidade com migração Seguidores e listas transferidos automaticamente; postagens não Deve recriar posts manualmente na nova instância

A exportação padrão do Mastodon não separa posts fixados porque eles são sinalizadores de metadados em vez de entidades de dados independentes. Para lidar com posts fixados separadamente, você deve extraí-los do arquivo outbox.json filtrando por objetos type: Add. Este método fornece um arquivo limpo e portátil contendo apenas os posts que você fixou. Após migrar para uma nova instância, use este arquivo para recriar e fixar cada post. Para backups futuros, considere usar uma extensão de navegador como Mastodon Pinned Post Exporter, que automatiza o processo de extração diretamente da sua página de perfil.

Como Exportar Emojis Personalizados do Mastodon como Conjunto de Imagens

Instâncias do Mastodon geralmente incluem centenas de emojis personalizados que você não pode usar em outros servidores. Talvez você queira fazer backup desses emojis para uso pessoal ou migrá-los para outra instância. O recurso de exportação nativo do Mastodon não inclui emojis personalizados. Este artigo explica como usar um script de navegador e um método manual … Leia mais

Como Ler o JSON de Exportação de Configurações da Conta do Mastodon

Ao exportar as configurações da sua conta no Mastodon, a plataforma gera um arquivo JSON contendo seu perfil, preferências e outros dados de configuração. Muitos usuários exportam esse arquivo para backup ou migração, mas têm dificuldade em interpretar a estrutura JSON bruta. Este artigo explica as principais seções do arquivo JSON de exportação do Mastodon e mostra como ler cada campo. Você aprenderá quais configurações são armazenadas, como os valores são formatados e onde residem dados críticos como sua biografia e URL do avatar.

Como Descriptografar o Arquivo de Códigos de Backup 2FA Exportado do Mastodon

Ao ativar a autenticação de dois fatores no Mastodon, o servidor fornece um conjunto de códigos de backup. Esses códigos permitem recuperar o acesso caso você perca seu aplicativo autenticador. O arquivo exportado contendo esses códigos é criptografado para proteger sua conta. Este artigo explica como descriptografar esse arquivo e recuperar seus códigos de backup. O arquivo criptografado … Leia mais

Exportação vs Migração de Conta no Mastodon: Quando Escolher Cada Uma

Quando você precisa sair de uma instância do Mastodon ou reorganizar sua conta, duas ferramentas estão disponíveis: exportação de dados e migração de conta. Muitos usuários confundem essas opções ou escolhem a errada para sua situação. A exportação cria um arquivo baixável com suas postagens, mídias e listas. A migração de conta transfere seus seguidores e informações do perfil para … Leia mais