Ao migrar sua conta do Mastodon para uma nova instância, a transferência de seguidores é automática, mas os filtros personalizados que você configurou para bloquear ou silenciar palavras, frases e usuários não acompanham. Esses filtros ficam armazenados localmente na instância antiga e não fazem parte do processo padrão de migração de conta. Este artigo explica por que os filtros ficam para trás e fornece as etapas exatas para reaplicá-los na nova instância, restaurando seu ambiente de moderação de conteúdo.
Principais Conclusões: Reaplicando Filtros do Mastodon Após Migração de Instância
- Preferências > Filtros > Importar: Use a ferramenta de importação integrada para enviar um arquivo CSV com todos os seus filtros antigos.
- Exporte os filtros antes de sair da instância antiga: Você deve exportar seus filtros da conta antiga antes de iniciar o processo de migração.
- Formato CSV para importação de filtros: Cada linha deve incluir a palavra-chave ou frase, o sinalizador de palavra inteira e a data de expiração para importar corretamente.
Por que os Filtros do Mastodon Não Migram com Sua Conta
A migração de conta do Mastodon transfere seguidores, seguidos, listas e bloqueios para a nova instância. Os filtros são excluídos desse processo porque são considerados configurações específicas da instância, vinculadas ao banco de dados local do servidor que você está deixando. O recurso de migração foi projetado para mover conexões sociais, não regras pessoais de moderação de conteúdo. Isso significa que, após concluir a migração, sua nova instância começa com zero filtros. Você deve recriá-los manualmente ou usar o recurso de importação/exportação se tiver se preparado com antecedência.
O que a Migração Realmente Transfere
Ao iniciar uma migração da sua conta antiga para uma nova, o Mastodon transfere automaticamente os seguintes dados:
- Todos os seguidores (eles recebem uma solicitação de seguir para a nova conta)
- Todas as contas que você segue
- Todas as listas que você criou
- Todos os bloqueios (usuários silenciados e bloqueados)
- Seu nome de exibição, biografia e avatar do perfil
Os filtros não estão nesta lista. Eles permanecem na instância antiga mesmo após a conta ser excluída ou redirecionada. Se você não exportá-los antes de iniciar a migração, os perde permanentemente.
Passos para Reaplicar Filtros na Sua Nova Instância do Mastodon
Você tem duas opções para restaurar seus filtros: exportar da instância antiga e importar para a nova, ou recriá-los manualmente. O método de exportação-importação é mais rápido e recomendado se você ainda tiver acesso à sua conta antiga.
Método 1: Exportar Filtros da Instância Antiga Antes da Migração
- Acesse sua conta antiga do Mastodon
Abra sua instância antiga em um navegador e faça login com suas credenciais. - Navegue até Preferências > Importar e Exportar > Exportar
Clique no ícone do menu no canto superior direito, selecione Preferências e depois clique em Importar e Exportar na barra lateral esquerda. Na guia Exportar, localize a seção chamada Filtros. - Baixe o arquivo CSV dos filtros
Clique no botão Exportar ao lado de Filtros. Seu navegador baixa um arquivo CSV chamado filters.csv. Salve este arquivo em um local seguro no seu computador. - Prossiga com a migração da sua conta
Conclua o processo de migração da sua conta antiga para a nova instância. Após a conclusão da migração, faça login na sua nova instância.
Método 2: Importar Filtros para a Nova Instância
- Acesse sua nova conta do Mastodon
Abra sua nova instância em um navegador e faça login. - Vá para Preferências > Importar e Exportar > Importar
Clique no ícone do menu, selecione Preferências e depois clique em Importar e Exportar. Mude para a guia Importar. - Escolha o arquivo CSV dos filtros
Clique no botão Escolher Arquivo e selecione o arquivo filters.csv que você exportou da sua instância antiga. - Defina o tipo de importação como Filtros
No menu suspenso intitulado O que você deseja importar, selecione Filtros. - Selecione o modo de mesclagem
Escolha Mesclar para adicionar os filtros importados a quaisquer filtros existentes na nova instância. Escolha Substituir para substituir todos os filtros existentes pelos importados. Para uma instância nova sem filtros, qualquer opção funciona. - Clique em Enviar
O Mastodon processa o arquivo CSV e aplica os filtros. Uma mensagem de confirmação aparece quando a importação é concluída.
Método 3: Recriar Filtros Manualmente na Nova Instância
Se você não exportou seus filtros antes de sair da instância antiga, deve recriá-los manualmente. Isso é demorado, mas necessário.
- Abra Preferências > Filtros
Na sua nova instância, clique no ícone do menu, selecione Preferências e depois clique em Filtros na barra lateral esquerda. - Clique em Adicionar novo filtro
Um formulário é aberto onde você pode definir a palavra-chave ou frase do filtro. - Digite a palavra-chave ou frase
Digite a palavra ou frase exata que deseja filtrar. Marque a caixa Palavra inteira se quiser corresponder apenas ocorrências isoladas. - Defina o contexto do filtro
Escolha onde o filtro se aplica: Início e listas, Notificações, Linha do tempo pública ou Conversas. Selecione todas as opções aplicáveis. - Defina uma data de expiração (opcional)
Se o filtro for temporário, insira uma data de expiração. Deixe em branco para filtros permanentes. - Clique em Salvar
O filtro é adicionado imediatamente. Repita para cada filtro que precisar recriar.
Problemas Comuns ao Reaplicar Filtros Após a Migração
Importação CSV Mostra Erro ou Nenhum Filtro Aparece
O arquivo CSV exportado da sua instância antiga deve seguir um formato específico. Abra o CSV em um editor de texto para verificar a linha de cabeçalho. As colunas necessárias são: keyword, whole_word, expires_at, context, filter_action. Se alguma coluna estiver faltando ou o arquivo estiver corrompido, a importação falha. Baixe uma exportação nova da instância antiga, se possível. Se a conta antiga não estiver mais acessível, você deve recriar os filtros manualmente.
Filtros Aplicados, mas Não Funcionando na Nova Instância
Após a importação, os filtros podem não entrar em vigor imediatamente se a nova instância executar uma versão diferente do Mastodon. Verifique se sua nova instância está atualizada para pelo menos a versão 4.0 do Mastodon. Versões mais antigas não suportam a coluna filter_action. Se a instância estiver desatualizada, atualize-a ou entre em contato com o administrador. Você também pode excluir os filtros importados e recriá-los usando o método manual, que sempre funciona independentemente da versão.
Filtros Exportados Incluem Dados Específicos da Instância Antiga
O arquivo CSV pode conter filtros que fazem referência a usuários ou servidores da sua instância antiga. Esses filtros ainda funcionam porque correspondem a texto, não a IDs de instância. No entanto, se você tinha filtros direcionados a usuários específicos pelo handle da conta, esses handles permanecem válidos apenas se os usuários ainda estiverem ativos nas mesmas instâncias. Atualize handles desatualizados após a importação editando o filtro em Preferências > Filtros.
| Item | Exportar e Importar | Recriação Manual |
|---|---|---|
| Tempo necessário | 5 minutos | 30 minutos a várias horas, dependendo da quantidade de filtros |
| Requer acesso à conta antiga | Sim | Não |
| Risco de perda de dados | Baixo se o CSV for salvo corretamente | Nenhum |
| Compatibilidade com a versão da instância antiga | O formato CSV deve corresponder à versão atual do Mastodon | Funciona com qualquer versão |
Agora você pode restaurar seu ambiente de moderação de conteúdo do Mastodon após migrar para uma nova instância. Antes de iniciar sua próxima migração, exporte seus filtros primeiro para economizar tempo. Para gerenciamento avançado, considere usar a API do Mastodon para script de importação em lote de filtros, se você tiver muitos filtros para reaplicar.