Migração do Mastodon para Akkoma: Passos para Verificar a Compatibilidade

Você quer migrar sua conta do Mastodon para uma instância Akkoma, mas teme que recursos como migração de seguidores ou federação de conteúdo possam quebrar. Mastodon e Akkoma implementam ActivityPub, mas diferem em endpoints de API, manipulação de mídia e ferramentas de moderação. Este artigo explica as verificações de compatibilidade exatas que você deve executar antes e depois da migração, cobrindo movimentação de conta, handshake de seguidores e funcionalidade da timeline.

Sem essas verificações, você corre o risco de perder seguidores, não ver postagens na sua timeline inicial ou encontrar incorporações de mídia quebradas. As etapas abaixo ajudam a verificar se sua nova instância Akkoma aceita a solicitação de mudança do Mastodon e se sua antiga instância Mastodon redireciona corretamente os seguidores. Você também aprenderá a testar a federação e a entrega de mídia entre as duas plataformas.

Ao final, você terá uma lista de verificação clara para confirmar que sua migração foi bem-sucedida e que todos os recursos principais funcionam conforme esperado no Akkoma.

Por que Mastodon e Akkoma Diferem na Compatibilidade de Migração

Mastodon e Akkoma são plataformas de microblogging baseadas em ActivityPub, mas não são idênticas. Akkoma é um fork do Pleroma com suas próprias extensões de API e pipeline de mídia. O protocolo ActivityPub central garante a federação básica, mas o recurso de migração de conta depende de endpoints específicos da API do Mastodon que o Akkoma pode implementar de forma diferente.

O processo de migração do Mastodon funciona enviando uma atividade Move da conta antiga para a nova. A nova conta deve aceitar essa atividade e então notificar os seguidores da conta antiga para seguirem a nova. O Akkoma suporta o tipo de atividade Move, mas pode rejeitar ou ignorar a solicitação se a etapa de verificação de alias não for concluída corretamente.

O Akkoma também lida com anexos de mídia e avisos de conteúdo com pequenas variações. Uma postagem que é exibida corretamente no Mastodon pode aparecer com mídia quebrada ou rótulos de aviso de conteúdo ausentes no Akkoma. Verificar esses aspectos após a migração evita confusão para seus seguidores.

Principais Diferenças Técnicas

O Mastodon usa uma API RESTful com tokens OAuth, enquanto o Akkoma usa a API do Mastodon para compatibilidade, mas adiciona seus próprios endpoints para tarefas administrativas. A atividade Move é processada por ambas as plataformas, mas o Akkoma pode exigir que a conta antiga seja explicitamente aliada em seu banco de dados antes de aceitar o handshake. Algumas instâncias Akkoma desabilitam a atividade Move por razões de segurança, então você deve confirmar com o administrador da sua instância que ela está habilitada.

O processamento de mídia é outra área de divergência. O Mastodon usa libvips para redimensionamento de imagens, enquanto o Akkoma usa ImageMagick. Isso significa que certos formatos de imagem ou dados EXIF podem se comportar de forma diferente. Vídeos podem ser transcodificados com codecs diferentes, levando a problemas de reprodução na outra plataforma.

Passos para Verificar a Compatibilidade Antes e Depois da Migração

Siga estas etapas em ordem. Não pule nenhuma, pois cada uma testa uma parte crítica do processo de migração.

1. Verifique se sua instância Akkoma suporta a atividade Move
   Faça login na sua instância Akkoma e abra a página de informações da instância. Procure pelo campo features na resposta JSON em https://sua-instancia-akkoma/api/v1/instance. A lista deve incluir "move" ou "account_migration". Se estiver faltando, entre em contato com o administrador da sua instância para habilitar o recurso no arquivo de configuração do Akkoma.
2. Crie o alias na sua conta do Mastodon
   Na sua antiga instância Mastodon, vá em Preferências > Conta > Mover para uma conta diferente. Insira o handle completo da sua nova conta Akkoma, por exemplo @voce@instancia-akkoma.social. O Mastodon gerará um arquivo de alias em https://sua-antiga-instancia-mastodon/@voce. Não exclua esta conta até que a migração esteja completa.
3. Inicie a mudança na sua conta Akkoma
   Na sua nova conta Akkoma, vá em Preferências > Conta > Mover de uma conta diferente. Insira o handle completo da sua antiga conta Mastodon. O Akkoma verificará o arquivo de alias na conta antiga. Se o alias estiver ausente ou malformado, a mudança falhará. Aguarde até 30 minutos para o handshake ser concluído.
4. Verifique a contagem de seguidores após 24 horas
   Após a mudança, verifique sua contagem de seguidores no Akkoma. Pode levar até 24 horas para que todos os seguidores refaçam o follow. Se a contagem permanecer zero, a atividade Move provavelmente foi rejeitada. Verifique os logs do Akkoma ou peça ao administrador para revisar a atividade Move no painel de moderação.
5. Teste a federação com uma postagem do Mastodon
   Publique um status no Akkoma e depois pesquise essa postagem a partir de uma conta Mastodon em uma instância diferente. Use o campo de busca e cole a URL da postagem do Akkoma. Se a postagem não aparecer, a federação entre as duas instâncias está bloqueada. Verifique as configurações de federação da sua instância Akkoma e certifique-se de que as instâncias Mastodon não estão na lista de rejeição.
6. Teste a exibição de mídia entre plataformas
   Faça upload de uma imagem e um vídeo curto no Akkoma. Visualize a postagem a partir de uma conta Mastodon. Verifique se a imagem carrega e o vídeo reproduz. Se a mídia falhar ao carregar, peça ao administrador do Akkoma para verificar a configuração do proxy de mídia. O Mastodon espera que as URLs de mídia sejam proxy através do cache de mídia da instância, e o Akkoma pode servir URLs diretas.
7. Verifique os avisos de conteúdo e rótulos de mídia sensível
   Crie uma postagem com um aviso de conteúdo no Akkoma. Visualize-a a partir do Mastodon. O cliente Mastodon deve mostrar o banner de aviso de conteúdo. Se não mostrar, a instância Akkoma pode não estar enviando o campo spoiler_text corretamente. Esta é uma lacuna de compatibilidade conhecida que algumas versões do Akkoma corrigiram.

Se a Migração ou Federação Ainda Tiver Problemas

Contagem de seguidores permanece zero após 24 horas

A causa mais comum é que a atividade Move não foi aceita pelo Akkoma. Peça ao administrador do Akkoma para verificar o log move_activity no banco de dados. Se a atividade foi rejeitada porque o alias não foi encontrado, repita a etapa de criação de alias no Mastodon e certifique-se de que a conta antiga não está configurada como privada ou suspensa. Algumas instâncias Mastodon bloqueiam o arquivo de alias quando a conta está bloqueada, então defina a conta como pública temporariamente.

Postagens do Mastodon não aparecem na timeline federada do Akkoma

Isso indica que a instância Akkoma não está puxando conteúdo do Mastodon. Verifique o painel de administração do Akkoma em Federação > Instâncias conhecidas. Se a instância Mastodon estiver listada como “bloqueada” ou “rejeitada”, remova-a da lista de bloqueio. Verifique também se a instância Akkoma não está rodando em modo “restrito”, que só permite federação com instâncias aprovadas.

Incorporacões de mídia mostram imagens quebradas no Mastodon

Por padrão, o Akkoma serve mídia diretamente de seu backend de armazenamento, enquanto o Mastodon espera que a mídia seja proxy através do cache de mídia do Mastodon. Se sua instância Akkoma usa armazenamento de objetos como S3, as URLs de mídia podem ser assinadas e expirar. Configure o proxy de mídia do Akkoma para reescrever URLs com uma URL base estática. Defina media_proxy no config do Akkoma como true e defina o base_url.

Avisos de conteúdo não são exibidos no Mastodon

Versões do Akkoma anteriores a 2023.08 omitem o campo spoiler_text em algumas respostas da API. Atualize o Akkoma para a versão estável mais recente. Se o problema persistir, peça ao administrador para verificar o objeto Note no payload ActivityPub e garantir que summary esteja preenchido com o texto do aviso de conteúdo.

Comparação de Recursos de Migração: Mastodon vs Akkoma

Item	Mastodon	Akkoma
Suporte à atividade Move	Integrado, habilitado por padrão	Requer configuração explícita move: true
Método de verificação de alias	Arquivo de alias em /.well-known/webfinger	Mesmo endpoint da API do Mastodon, mas pode exigir que o alias seja armazenado no banco de dados local
Proxy de mídia	Automático via media_cache	Opcional, deve ser configurado em media_proxy
Campo de aviso de conteúdo	Sempre envia spoiler_text	Pode omitir spoiler_text em versões antigas
Lista de bloqueio de federação	Lista de bloqueio a nível de instância	Lista de bloqueio a nível de instância mais modo restrito

Após concluir todas as verificações, você pode confirmar que sua migração do Mastodon para o Akkoma é totalmente compatível. Se algum teste falhar, revise a etapa correspondente ou entre em contato com o administrador da sua instância. Para compatibilidade contínua, mantenha sua instância Akkoma atualizada com a versão mais recente e monitore o changelog da API do Mastodon em busca de mudanças que quebrem a compatibilidade. Um próximo passo útil é testar mensagens diretas e a renderização de emojis personalizados entre as duas plataformas, pois essas são áreas comuns onde pequenas diferenças aparecem.