Como Federar o Mastodon com Instâncias Fork do Akkoma de Forma Suave

Usuários do Mastodon frequentemente descobrem que postagens de instâncias fork do Akkoma aparecem quebradas ou não carregam na timeline federada. Isso acontece porque o Akkoma e seus forks como Pleroma e Honk usam uma versão diferente do protocolo de federação em comparação com o Mastodon. Este artigo explica como ajustar as configurações do seu servidor Mastodon e o comportamento do cliente para que a federação com forks do Akkoma funcione de forma confiável.

Por que o Mastodon e os Forks do Akkoma Têm Problemas de Federação

O Akkoma é um fork do Pleroma, um servidor ActivityPub leve. O Akkoma e seus forks implementam o ActivityPub versão 1.0.2, enquanto o Mastodon implementa a versão 1.0.1. A diferença de versão faz com que o Mastodon rejeite algumas atividades ou as exiba incorretamente.

A incompatibilidade mais comum está no objeto Create. Os forks do Akkoma enviam uma atividade Create com um campo summary para avisos de conteúdo. O Mastodon espera o campo summary apenas em objetos Note, não na atividade Create que os envolve. Essa incompatibilidade faz com que o Mastodon descarte a postagem completamente ou a exiba sem o aviso de conteúdo.

Outra diferença está no tratamento de mídia. Os forks do Akkoma armazenam anexos de mídia em um caminho de URL diferente do Mastodon. Quando o Mastodon busca a URL da mídia, recebe um erro 404 e exibe um placeholder de imagem quebrada.

Diferença de Versão do Protocolo de Federação

O Mastodon usa ActivityPub 1.0.1, que define um esquema estrito para atividades. Os forks do Akkoma usam ActivityPub 1.0.2, que adiciona campos opcionais como source e context. O Mastodon ignora campos desconhecidos, mas falha quando um campo obrigatório está ausente ou em uma posição inesperada.

Diferenças nas URLs de Anexos de Mídia

O Mastodon espera que as URLs de anexos de mídia sigam o padrão /media/attachments/files/.... Os forks do Akkoma usam /media/... ou um caminho personalizado. Quando o Mastodon tenta fazer proxy ou cache da mídia, não consegue resolver a URL e exibe uma imagem quebrada.

Passos para Habilitar a Federação Suave entre Mastodon e Forks do Akkoma

Estes passos exigem acesso de administrador do servidor. Se você é um usuário em uma instância compartilhada do Mastodon, peça ao seu administrador para aplicar essas alterações.

1. Adicione domínios de forks do Akkoma à lista de permissões da instância
   No painel de administração do Mastodon, vá em Servidor > Federação > Lista de permissões. Insira o domínio da instância fork do Akkoma, por exemplo akkoma.example.com. Clique em Adicionar. Isso instrui o Mastodon a aceitar atividades desse domínio mesmo se a verificação de versão do protocolo falhar.
2. Desative o modo de federação estrito para o domínio do fork do Akkoma
   No painel de administração do Mastodon, vá em Servidor > Federação > Bloqueios de domínio. Adicione o domínio do fork do Akkoma com a ação definida como “Desativar federação estrita”. Essa configuração faz o Mastodon aceitar atividades que tenham pequenas diferenças na ordem dos campos.
3. Ative o proxy de mídia para instâncias externas
   No painel de administração do Mastodon, vá em Servidor > Mídia > Proxy. Ative “Proxy de mídia de instâncias externas”. Isso força o Mastodon a baixar e armazenar em cache a mídia dos forks do Akkoma, resolvendo o erro 404 causado por diferenças nos caminhos de URL.
4. Reinicie os serviços do Mastodon
   Execute systemctl restart mastodon-web mastodon-sidekiq mastodon-streaming no servidor. Isso recarrega a configuração de federação.
5. Teste a federação a partir de um cliente Mastodon
   Abra seu cliente Mastodon. Pesquise uma postagem conhecida da instância fork do Akkoma. Se a postagem carregar com seu aviso de conteúdo e mídia, a federação está funcionando. Caso contrário, verifique os logs do servidor em /var/log/mastodon/ para erros.

Solução Alternativa no Lado do Cliente para Usuários Sem Acesso de Administrador

Se você não puder alterar as configurações do servidor, ajuste suas preferências de cliente. Na interface web do Mastodon, vá em Preferências > Federação > Modo estrito e desative-o. Isso exibe postagens que falham na validação estrita, mas pode exibi-las sem avisos de conteúdo ou com mídia quebrada.

Problemas Comuns de Federação entre Mastodon e Forks do Akkoma

Postagens do Fork do Akkoma Mostram “Esta postagem não está disponível”

Isso acontece quando o Mastodon rejeita a atividade Create porque o campo summary está no local errado. A correção é adicionar o domínio do fork do Akkoma à lista de permissões e desativar a federação estrita, conforme descrito nos passos 1 e 2 acima.

Imagens de Mídia do Fork do Akkoma Aparecem como Links Quebrados

O Mastodon não consegue buscar a mídia porque o caminho da URL não corresponde ao padrão esperado. Ative o proxy de mídia conforme descrito no passo 3. Se o proxy já estiver ativo, limpe o cache de mídia executando systemctl restart mastodon-media-cache.

Avisos de Conteúdo do Fork do Akkoma Estão Ausentes

O Mastodon não consegue analisar o aviso de conteúdo da atividade Create. A postagem aparece sem o CW. Desative a federação estrita para o domínio para aceitar a atividade como está. O aviso de conteúdo será exibido, mas a formatação da postagem pode estar ligeiramente incorreta.

Mastodon vs Fork do Akkoma: Comparação de Compatibilidade de Federação

Item	Mastodon	Fork do Akkoma
Versão do ActivityPub	1.0.1	1.0.2
Localização do campo de aviso de conteúdo	Dentro do objeto Note apenas	Dentro do wrapper da atividade Create
Padrão de URL de anexo de mídia	/media/attachments/files/...	/media/... ou personalizado
Modo de federação estrito	Ativado por padrão	Não suportado
Suporte a lista de permissões	Sim	Sim

Agora você pode ajustar as configurações do seu servidor Mastodon para aceitar atividades de instâncias fork do Akkoma. Comece adicionando o domínio do fork à lista de permissões e desativando a federação estrita. Para problemas persistentes de mídia, ative o proxy de mídia e limpe o cache. Como dica avançada, monitore os logs do sidekiq do Mastodon com journalctl -u mastodon-sidekiq -f para ver exatamente quais atividades estão sendo rejeitadas e por quê.