Como Corrigir o Erro ‘Instance Not Reachable’ no Mastodon na Verificação de Federação

Ao executar uma verificação de federação em sua instância do Mastodon, a ferramenta pode retornar o erro “Instance Not Reachable” para outro servidor. Esse erro significa que sua instância não consegue estabelecer uma conexão com o servidor remoto. A causa geralmente é uma regra de firewall, uma configuração incorreta de DNS ou a instância remota bloqueando seu endereço IP. Este artigo explica os motivos técnicos por trás do erro e fornece correções passo a passo que você pode aplicar.

Por que a Verificação de Federação Retorna “Instance Not Reachable”

A verificação de federação no Mastodon testa se sua instância consegue se conectar a uma instância remota via HTTPS. A verificação envia uma solicitação HTTP GET simples ao endpoint da API da instância remota /api/v1/instance. Se o servidor remoto não responder dentro de um período de tempo limite, o Mastodon o marca como “Not Reachable.”

Existem três razões técnicas comuns para essa falha:

Firewall ou Filtro de Rede Bloqueia Tráfego de Saída

O firewall do seu servidor, um grupo de segurança do provedor de nuvem ou um filtro de rede corporativo pode bloquear o tráfego HTTPS de saída (porta 443) para o endereço IP remoto. Esta é a causa mais frequente. A verificação de federação nunca alcança a instância remota, resultando em tempo limite.

Falha na Resolução DNS do Domínio Remoto

Se seu servidor não conseguir resolver o nome de domínio da instância remota para um endereço IP, a conexão não pode ser estabelecida. Isso pode acontecer se o domínio remoto expirou, não possui registro A ou AAAA, ou se seu resolvedor DNS está mal configurado.

Instância Remota Bloqueia Seu Endereço IP

A instância remota pode ter implementado uma lista de bloqueio que inclui sua faixa de IP. Isso é comum quando sua instância foi sinalizada por spam ou abuso. O servidor remoto descarta a conexão antes de responder.

Passos para Diagnosticar e Corrigir o Erro

Siga estes passos em ordem. Cada passo isola uma causa potencial diferente.

1. Execute a verificação de federação para o domínio exato
   No painel de administração do Mastodon, vá em Preferências > Moderação > Federação. Na caixa de busca, digite o domínio da instância remota exatamente (por exemplo, mastodon.social). Clique no botão Verificar. Anote a mensagem de erro. Se disser “Instance Not Reachable,” prossiga para o próximo passo.
2. Teste a resolução DNS do seu servidor
   Abra um terminal no seu servidor Mastodon. Execute nslookup example.com ou dig example.com onde example.com é o domínio da instância remota. Se o comando não retornar nenhum endereço IP ou um erro SERVFAIL, o domínio não pode ser resolvido. Aguarde 24 horas para propagação de DNS ou entre em contato com o administrador da instância remota para confirmar que o domínio está ativo.
3. Verifique a conectividade de saída para o IP remoto
   Use o endereço IP da consulta DNS. Execute curl -I https://IP_ADDRESS do seu servidor. Se o comando travar ou retornar “Connection timed out,” seu firewall ou rede está bloqueando o tráfego HTTPS de saída. Revise suas regras de firewall (iptables, ufw ou grupo de segurança do provedor de nuvem) e permita TCP de saída na porta 443 para todos os destinos.
4. Verifique se a instância remota não está bloqueando seu IP
   De uma rede diferente (por exemplo, seu computador em casa), execute curl -I https://example.com. Se funcionar da outra rede, mas falhar do seu servidor Mastodon, a instância remota pode ter bloqueado o IP do seu servidor. Entre em contato com o administrador da instância remota para solicitar a remoção da lista de bloqueio.
5. Teste a validade do certificado HTTPS
   Um certificado TLS válido é necessário para a conexão. Execute openssl s_client -connect example.com:443 -servername example.com. Se a saída mostrar “Verify return code: 0 (ok)”, o certificado é válido. Qualquer outro código de retorno indica um problema de certificado na instância remota. Aguarde o administrador remoto corrigir ou adicione o domínio à lista de domínios permitidos da sua instância temporariamente.
6. Reinicie os serviços sidekiq e web do Mastodon
   Após aplicar qualquer correção de rede ou DNS, reinicie os serviços do Mastodon para limpar estados de conexão em cache. Execute systemctl restart mastodon-sidekiq mastodon-web do seu servidor. Aguarde 30 segundos e execute a verificação de federação novamente.

Se o Mastodon Ainda Mostrar o Erro Após a Correção Principal

Verificação de Federação Funciona Intermitentemente

Se a verificação funciona às vezes e falha em outras, a instância remota pode estar limitando a taxa de suas solicitações. Aguarde pelo menos 5 minutos entre as verificações. Limites de taxa geralmente são temporários e são redefinidos após um período de resfriamento.

Múltiplas Instâncias Mostram o Mesmo Erro

Se muitas instâncias remotas estão inacessíveis, o problema provavelmente está do seu lado. Revise as regras de firewall do seu servidor e certifique-se de que o HTTPS de saída não está restrito por um provedor upstream ou um proxy corporativo. Verifique também se sua instância Mastodon está rodando atrás de um proxy reverso mal configurado.

Erro Persiste Após Todos os Passos

Se o erro permanecer após verificações de DNS, firewall e certificado, a instância remota pode estar completamente offline. Use uma ferramenta de monitoramento de terceiros como UpDown.io para verificar a disponibilidade do domínio remoto. Se a instância remota estiver fora do ar, aguarde o administrador restaurar o serviço.

Item	Problema de Rede Local	Problema na Instância Remota
Resolução DNS	Resolvedor DNS do servidor mal configurado	Domínio remoto expirado ou registro A ausente
Firewall	Porta 443 de saída bloqueada	Instância remota bloqueia seu IP
Certificado	N/A	Certificado TLS expirado ou inválido
Status do serviço	Mastodon sidekiq ou web não reiniciados	Instância remota offline ou sobrecarregada

A verificação de federação é uma ferramenta crítica para manter uma instância Mastodon saudável. Seguindo os passos acima, você pode identificar se o problema está na sua rede ou no lado remoto. Após corrigir o problema, execute a verificação novamente para confirmar que a conexão foi bem-sucedida. Para casos persistentes, considere adicionar o domínio remoto à lista de permissões da sua instância como uma solução temporária enquanto investiga mais a fundo.