Você precisa exportar sua lista de bloqueio de domínios do Mastodon para compartilhar com outra instância ou fazer backup das configurações de moderação. O Mastodon armazena esses bloqueios em um arquivo JSON contendo todos os domínios que sua instância silenciou, suspendeu ou limitou. Este artigo explica exatamente como gerar esse arquivo de exportação no painel de administração do Mastodon e o que cada tipo de bloqueio significa.
O recurso de exportação está presente em todas as instâncias do Mastodon versão 3.0 ou superior. Você precisa ter o papel de Administrador ou Moderador na instância para acessar a função de exportação. O processo leva cerca de 30 segundos e produz um arquivo para download que pode ser importado em qualquer outra instância do Mastodon.
Principais Pontos: Exportação de Bloqueio de Domínios no Mastodon
- Administração > Servidor > Bloqueios de Domínio > Exportar: Gera um arquivo JSON contendo todos os domínios silenciados, suspensos e limitados.
- Estrutura do arquivo JSON: Cada entrada inclui o domínio, a gravidade do bloqueio (silenciar, suspender, limitar) e configurações opcionais de notas e ofuscação.
- Compatibilidade de importação: O arquivo JSON exportado pode ser importado em qualquer instância do Mastodon rodando versão 3.0 ou superior usando o botão Importar correspondente.
O que a Exportação de Bloqueio de Domínios Contém
O arquivo de exportação de bloqueio de domínios é um documento JSON que lista todos os domínios que sua instância bloqueou ativamente. O Mastodon aplica três níveis de gravidade aos bloqueios de domínio:
Silenciar: As postagens do domínio ficam ocultas da linha do tempo pública e da linha do tempo local. Os usuários precisam seguir manualmente contas desse domínio para ver o conteúdo.
Suspender: Todo o conteúdo do domínio é removido da sua instância. Nenhuma conta desse domínio pode interagir com seus usuários.
Limitar: Uma restrição mais suave que reduz a visibilidade do conteúdo do domínio nas linhas do tempo federadas. É menos severo que silenciar.
Cada entrada de bloqueio na exportação também inclui campos opcionais, como uma nota pública explicando por que o bloqueio foi aplicado e uma configuração de ofuscação que oculta o nome de domínio completo de usuários não administradores. A exportação não inclui nenhum dado de usuário, conteúdo de postagens ou informações privadas.
Antes de exportar, verifique se sua instância está rodando Mastodon versão 3.0 ou superior. Versões mais antigas não possuem o recurso de exportação. Você pode verificar sua versão em Administração > Servidor > Sobre.
Passos para Exportar a Lista de Bloqueio de Domínios
Siga estes passos exatamente para baixar sua lista de bloqueio de domínios do painel de administração do Mastodon.
- Faça login na sua instância do Mastodon como administrador ou moderador
Abra a URL da sua instância em um navegador web. Insira seu e-mail e senha. Apenas contas com o papel de Admin ou Moderador podem ver o menu Administração. - Navegue até o painel de Administração
Clique no ícone do menu hambúrguer (três linhas horizontais) no canto superior direito da página. Selecione Administração no menu suspenso. Se você não vir esta opção, sua conta não tem as permissões necessárias. - Abra a seção Servidor
Na barra lateral esquerda do painel de Administração, clique em Servidor. Isso expande um submenu com opções para configurações, sobre, bloqueios de domínio e mais. - Clique em Bloqueios de Domínio
Na seção Servidor, selecione Bloqueios de Domínio. Esta página exibe uma tabela de todos os domínios que sua instância bloqueou, junto com o nível de gravidade e quaisquer notas. - Clique no botão Exportar
Acima da tabela de bloqueios de domínio, localize o botão Exportar. É um botão azul rotulado como Exportar. Clique nele para iniciar o download do arquivo. - Salve o arquivo JSON
Seu navegador baixará um arquivo chamadodomain_blocks.json. Salve-o em um local seguro. O arquivo não contém senhas ou dados de usuário, mas trate-o como sensível, pois revela sua política de moderação.
Após o download ser concluído, você pode abrir o arquivo JSON em qualquer editor de texto para visualizar a lista de bloqueios. Cada entrada segue esta estrutura:
{
"domain": "exemplo-ruim.com",
"severity": "suspend",
"public_comment": "Spam e assédio",
"obfuscate": true
}O campo obfuscate, quando definido como true, oculta os caracteres do meio do domínio de usuários não administradores na interface de administração.
Erros Comuns e Limitações ao Exportar Bloqueios de Domínio
Botão Exportar está desabilitado ou ausente
Se o botão Exportar aparecer desabilitado ou não estiver visível, sua versão do Mastodon é anterior à 3.0. Atualize sua instância para a versão estável mais recente. Durante o processo de atualização, os bloqueios de domínio são preservados, mas o recurso de exportação só aparece após a conclusão da atualização.
Arquivo baixado não contém entradas
Se o arquivo JSON exportado mostrar um array vazio [], sua instância não possui bloqueios de domínio configurados. O Mastodon exporta apenas bloqueios ativos. Para verificar, veja a página Bloqueios de Domínio no painel de administração. Se a tabela estiver vazia, não há bloqueios para exportar.
Falha ao importar o arquivo em outra instância
O JSON exportado deve corresponder ao esquema exato esperado pelo Mastodon. Se você editou o arquivo manualmente e introduziu erros de sintaxe, a importação falhará. Para corrigir, exporte uma cópia nova sem modificações. Certifique-se também de que a instância de destino esteja rodando Mastodon versão 3.0 ou superior. Instâncias mais antigas não reconhecem o formato de importação.
Notas de bloqueio ausentes após a importação
A exportação inclui o campo public_comment, mas o processo de importação na instância de destino pode truncar notas que excedam 255 caracteres. Mantenha seus comentários públicos abaixo desse limite para garantir que sejam transferidos completamente.
Exportação de Bloqueio de Domínios do Mastodon vs Lista Manual
| Item | Arquivo JSON de Exportação | Cópia Manual |
|---|---|---|
| Formato | JSON estruturado com gravidade, notas e configurações de ofuscação | Lista de texto simples com nomes de domínio |
| Compatibilidade de importação | Importação direta no painel de administração do Mastodon | Deve ser reinserido manualmente no formulário de bloqueio, um domínio por vez |
| Velocidade | 30 segundos para exportar, 30 segundos para importar | Minutos a horas, dependendo do tamanho da lista de bloqueio |
| Risco de erro | Baixo — o esquema é validado durante a importação | Alto — erros de digitação ou domínios esquecidos |
| Inclui notas | Sim, até 255 caracteres por bloqueio | Apenas se digitadas manualmente |
Use o método de exportação sempre que precisar transferir bloqueios entre instâncias ou criar um backup. O método manual é útil apenas para revisar a lista sem baixar um arquivo.
Agora você pode exportar sua lista de bloqueio de domínios do Mastodon como um arquivo JSON a partir da página Administração > Servidor > Bloqueios de Domínio. Use o arquivo exportado para fazer backup de suas regras de moderação ou compartilhá-las com outro administrador de instância. Para um fluxo de trabalho avançado, combine a exportação com o recurso de importação no mesmo painel para sincronizar listas de bloqueio entre várias instâncias que você gerencia.