Ao tentar migrar seguidores de uma conta antiga do Mastodon para uma nova, a opção de configuração de alias necessária às vezes não aparece nas configurações da conta antiga. Essa opção ausente impede o início do handshake de migração. A causa geralmente é uma diferença nas versões do software Mastodon ou um recurso de migração desabilitado na instância antiga. Este artigo explica por que a opção de alias pode estar ausente e fornece as etapas exatas para corrigi-lo, permitindo concluir a migração da conta.
Principais Conclusões: Restaurando a Configuração de Alias Ausente para Migração de Conta no Mastodon
- Preferências > Conta > Mover de uma conta diferente: Inicia o handshake de migração de seguidores da nova conta para a conta antiga.
- Preferências > Conta > Alias: Configuração necessária na conta antiga que deve estar visível e configurada antes da migração.
- Administrador da instância ou atualização de software: A opção de alias pode estar oculta devido a versões desatualizadas do Mastodon ou flags de recurso no nível da instância que precisam ser ativadas.
Por que a Opção de Alias Está Ausente na Sua Conta Antiga do Mastodon
A migração de conta do Mastodon usa um handshake de duas etapas. Primeiro, você define um alias na conta antiga que aponta para a nova conta. Segundo, você usa a opção Mover seguidores na nova conta para puxar os seguidores da conta antiga. Se a opção de alias estiver ausente na conta antiga, o handshake não pode começar.
A causa raiz mais comum é que a instância antiga do Mastodon executa uma versão de software anterior à 3.5.0. O recurso de alias foi introduzido no Mastodon v3.5.0. Instâncias executando versões mais antigas não possuem essa configuração. Outra causa é que o administrador da instância desabilitou o recurso de migração de conta através do painel de administração. Algumas instâncias restringem a migração para evitar spam ou abuso.
Uma terceira causa é um problema de cache do navegador. Após sua instância ser atualizada para uma versão que suporta aliases, seu navegador pode ainda mostrar a interface antiga sem a opção de alias. Limpar o cache do navegador para o domínio da instância resolve isso.
Etapas para Corrigir a Configuração de Alias Ausente na Conta Antiga
Siga estas etapas em ordem. Após cada etapa, verifique se a opção de alias aparece em Preferências > Conta na conta antiga.
- Verifique a versão do Mastodon da instância antiga
Abra a instância antiga em um navegador. Role até o rodapé de qualquer página. Procure o número da versão, como v4.0.2 ou v3.4.1. Se a versão for inferior a 3.5.0, a opção de alias não existe nesse software. Você deve contatar o administrador da instância e pedir que atualizem o Mastodon para pelo menos v3.5.0. - Limpe o cache e cookies do navegador para o domínio da instância antiga
No Chrome ou Edge, clique no ícone de cadeado ao lado da URL. Selecione Cookies e dados do site > Gerenciar cookies e dados do site. Exclua todos os cookies para o domínio da instância. Em seguida, pressione Ctrl+F5 para forçar um recarregamento completo da página. No Firefox, clique no ícone de cadeado, depois em Limpar cookies e dados do site. Recarregue a página e navegue até Preferências > Conta. A opção de alias pode agora aparecer. - Tente um navegador diferente ou modo anônimo
Abra a instância antiga em uma janela de navegação privada. Faça login na sua conta antiga. Vá para Preferências > Conta. Se a opção de alias aparecer, o problema é o cache do navegador. Use o navegador limpo ou mude para a janela privada para as etapas de migração. - Verifique as flags de recurso no nível da instância
Se a opção de alias ainda não aparecer, o administrador da instância pode ter desabilitado a migração de conta. Envie uma mensagem direta ou e-mail para o administrador. Pergunte: O recurso de migração de conta está habilitado nesta instância? Se não, solicite que o habilite. O administrador pode verificar no painel de administração em Configurações do servidor > Recursos. - Use a API como solução temporária
Se o administrador não puder atualizar a instância ou habilitar o recurso, você pode definir o alias através da API do Mastodon. Abra um navegador e vá para: https://instanciaantiga.exemplo.com/api/v1/accounts/update_credentials. Substitua a URL pelo domínio real da sua instância. Faça login se solicitado. No editor JSON, adicione este campo: “alias”: “https://novainstancia.exemplo.com/@seudonovousuario”. Substitua os valores pela URL da sua nova conta. Clique em Enviar. Isso contorna a interface ausente e define o alias diretamente. Em seguida, prossiga com a etapa Mover seguidores na nova conta.
Se o Alias Ainda Não Aparecer Após Essas Etapas
Configuração de alias ainda ausente após atualizar a versão do Mastodon
Se a instância foi atualizada para v3.5.0 ou posterior, mas a opção de alias permanece oculta, o administrador pode precisar executar migrações de banco de dados. Peça ao administrador para executar: RAILS_ENV=production bin/rails db:migrate no terminal do servidor. Isso aplica quaisquer alterações pendentes no esquema do banco de dados que habilitam o recurso de alias.
Erro ao definir alias via API
Se a API retornar um erro 422, o formato do alias está incorreto. Certifique-se de que o valor do alias seja a URL completa do seu novo perfil do Mastodon, incluindo https:// e o domínio da instância. Exemplo: https://novainstancia.social/@seudonome. Não inclua uma barra no final.
Opção Mover seguidores ausente na nova conta
Após definir o alias na conta antiga, vá para a nova conta. Abra Preferências > Conta > Mover de uma conta diferente. Se esta opção estiver ausente, a nova instância também pode estar desatualizada ou ter a migração desabilitada. Aplique as mesmas verificações de versão e contato com o administrador para a nova instância.
Migração de Conta do Mastodon: Requisitos da Instância Antiga vs Nova
| Item | Instância Antiga | Nova Instância |
|---|---|---|
| Versão necessária do Mastodon | v3.5.0 ou posterior | v3.5.0 ou posterior |
| Configuração necessária | Alias (definido na conta antiga) | Mover de uma conta diferente (usado na nova conta) |
| Flag de recurso necessária | Migração de conta habilitada pelo admin | Migração de conta habilitada pelo admin |
| Requisito do navegador | Cache limpo ou janela privada | Cache limpo ou janela privada |
| Solução alternativa via API disponível | Sim, via endpoint update_credentials | Sim, via endpoint update_credentials para Mover |
Definir o alias na conta antiga é o primeiro passo. A opção Mover seguidores na nova conta puxa os seguidores. Ambas as instâncias devem atender aos requisitos de versão e flag de recurso.
Depois de definir o alias usando um dos métodos acima, prossiga para a nova conta. Abra Preferências > Conta > Mover de uma conta diferente. Insira o nome de usuário da conta antiga e o domínio da instância. Confirme a ação. Os seguidores da conta antiga começarão a migrar para a nova conta nos próximos minutos. Se você usou a solução alternativa da API, a etapa Mover funciona da mesma forma, pois o alias já está armazenado no servidor da conta antiga. A configuração de alias ausente agora está corrigida e a migração pode ser concluída.