Como Ver Quais Instâncias Federam com Sua Instância do Mastodon

Você administra uma instância do Mastodon e precisa confirmar quais outros servidores se comunicam com ela. Por padrão, o Mastodon não exibe uma lista de amigos simples. O painel de federação fornece um diretório de instâncias remotas conhecidas, status de conexão e atividade recente. Este artigo explica como acessar esse painel e interpretar os dados que ele fornece.

O que o Painel de Federação Mostra

O painel de federação é uma página administrativa do lado do servidor. Ele lista todas as instâncias remotas do Mastodon, Pleroma ou outros servidores ActivityPub com os quais sua instância já se comunicou. A comunicação inclui receber uma postagem, enviar um seguir ou compartilhar um impulsionar. O painel não requer ferramentas externas ou serviços de terceiros.

Apenas administradores da instância do Mastodon podem acessar o painel de federação. Usuários comuns não podem ver a lista completa. Se você não for o administrador, peça ao proprietário do servidor para verificar para você.

O painel fornece estas colunas para cada instância remota:

• Domínio: O nome de host completo do servidor remoto, por exemplo mastodon.social.
• Software: O software que a instância remota executa, como Mastodon, Pleroma ou Friendica.
• Versão: A versão do software informada pela instância remota.
• Status de conexão: Se a instância está atualmente acessível, suspensa ou limitada.
• Último contato: A data e hora da última comunicação bem-sucedida.

Pré-requisitos para Acessar o Painel

Você precisa de uma conta de administrador na sua instância do Mastodon. A conta de administrador padrão é a criada durante a configuração inicial do servidor. Se houver vários administradores, cada um pode visualizar o painel de forma independente.

Sua instância deve estar executando Mastodon versão 3.0 ou posterior. Versões mais antigas usavam um layout de painel administrativo diferente, mas os dados de federação ainda estão disponíveis através da API.

Passos para Acessar o Painel de Federação

1. Faça login na sua instância do Mastodon como administrador.
   Abra a URL da sua instância no navegador e faça login com as credenciais da conta de administrador. Você verá a linha do tempo inicial após o login.
2. Abra o menu Administração.
   Clique no ícone de engrenagem ou no ícone do seu perfil no canto superior direito. Selecione Administração no menu suspenso. O painel de administração será exibido.
3. Clique em Servidor na barra lateral esquerda.
   A seção Servidor contém configurações para toda a instância. Inclui a opção Federação.
4. Clique em Federação.
   O Mastodon carrega o painel de federação. Você verá uma tabela paginada de todas as instâncias remotas com as quais seu servidor já se comunicou. A tabela mostra até 40 entradas por página por padrão.
5. Use a caixa de busca para verificar um domínio específico.
   Digite um nome de domínio como mastodon.social na caixa de busca acima da tabela. Pressione Enter. Se o domínio aparecer, sua instância federou com aquele servidor. Se nenhum resultado aparecer, sua instância nunca se comunicou com aquele domínio.
6. Filtre por status de conexão.
   O painel inclui um menu suspenso de filtro. Selecione Todos, Limitado, Suspenso ou Indisponível. Isso ajuda a identificar instâncias que estão bloqueadas ou inacessíveis no momento.

Usando o Endpoint de Pares da API

Se preferir recuperar a lista de federação programaticamente, o Mastodon oferece um endpoint público da API. O endpoint retorna um array JSON de strings de domínio. Nenhuma autenticação é necessária para este endpoint. Ele é somente leitura.

1. Abra um terminal ou cliente de API.
   Você pode usar curl, Postman ou qualquer cliente HTTP que suporte requisições GET.
2. Envie uma requisição GET para o endpoint de pares.
   Use esta estrutura de URL: https://suainstancia.com/api/v1/instance/peers. Substitua suainstancia.com pelo seu domínio real.
3. Analise a resposta JSON.
   A resposta é um array simples de strings. Exemplo: ["mastodon.social","pleroma.example","friendica.space"]. Cada string é um domínio com o qual sua instância federou.

O endpoint de pares não inclui status de conexão ou versão do software. Para esses dados, você deve usar o painel administrativo ou a API administrativa autenticada.

Problemas Comuns ao Visualizar a Lista de Federação

Painel de Federação Não Mostra Nenhuma Instância

Se o painel de federação estiver vazio, sua instância pode ser nova e ainda não ter comunicação externa. O Mastodon só registra instâncias que enviaram ou receberam pelo menos uma atividade. Publique publicamente e aguarde algumas horas. Verifique o painel novamente. Se continuar vazio, confirme se sua instância está configurada corretamente para federar. Verifique as configurações do servidor em Administração > Servidor > Configurações. Certifique-se de que a opção Habilitar federação esteja ativada.

Algumas Instâncias Aparecem como Limitadas ou Suspensas

Uma instância limitada significa que seu servidor restringiu seu conteúdo devido a regras de moderação. Uma instância suspensa significa que toda comunicação está bloqueada. Esses status não removem a instância da lista. Eles apenas alteram a coluna de status de conexão. Para remover uma instância completamente da lista, você deve excluí-la do banco de dados, o que não é recomendado para administração normal.

API Retorna um Array Vazio

O endpoint da API de pares pode retornar um array vazio se sua instância nunca federou com ninguém. Se você sabe que sua instância se comunicou com outros servidores, verifique se há erros de digitação na URL do endpoint. Certifique-se de usar HTTPS. Algumas versões antigas do Mastodon exigem autenticação para o endpoint de pares. Tente adicionar um token de acesso como token Bearer no cabeçalho da requisição.

Painel de Federação vs Endpoint de Pares da API

Item	Painel de Federação	Endpoint de Pares da API
Método de acesso	Navegador web, login de administrador necessário	Requisição HTTP GET, sem autenticação necessária
Formato dos dados	Tabela HTML com paginação	Array JSON de strings de domínio
Status de conexão	Sim, inclui limitado/suspenso/indisponível	Não, apenas nomes de domínio
Versão do software	Sim, mostra software e versão remotos	Não
Busca por domínio	Sim, caixa de busca no painel	Não diretamente, é necessário percorrer o array
Capacidade de exportação	Nenhum botão de exportação nativo	Sim, copiar JSON ou redirecionar para um arquivo

Use o painel de federação para verificações visuais rápidas e ações de moderação. Use o endpoint da API quando precisar automatizar o monitoramento ou integrar a lista com ferramentas externas.

O que Fazer com a Lista de Federação

Depois de ver quais instâncias federam com seu servidor, você pode tomar decisões de moderação informadas. Por exemplo, se um domínio aparecer como limitado, você pode revisar suas postagens recentes e decidir se remove o limite. Se um domínio aparecer como indisponível, você pode verificar se está temporariamente fora do ar ou permanentemente extinto. Você também pode usar a lista para identificar instâncias que estão executando software desatualizado e incentivar seus administradores a atualizarem.

Se quiser bloquear um domínio específico, vá para Administração > Servidor > Federação, clique no nome do domínio e selecione Suspender. O domínio permanece na lista, mas seu status de conexão muda para Suspenso. Para remover completamente um domínio, você deve excluí-lo do banco de dados via console Rails, o que é uma operação avançada.

Revisar regularmente a lista de federação ajuda a manter uma rede saudável. Verifique mensalmente para identificar conexões inesperadas ou instâncias que ficaram offline. O endpoint da API pode ser usado com um cron job para registrar mudanças ao longo do tempo.