Como Migrar uma Conta do Mastodon com Domínio Personalizado

Mover uma conta do Mastodon para uma nova instância é simples para a maioria dos usuários, mas adicionar um domínio personalizado exige etapas extras. Seu domínio está vinculado aos registros do servidor da instância antiga, e o processo de migração precisa atualizar esses registros para apontar para a nova casa. Se você pular essas etapas, seus seguidores podem ver seu perfil antigo ou encontrar erros ao visitar seu domínio personalizado. Este artigo explica o processo completo para migrar sua conta do Mastodon mantendo seu domínio ativo e redirecionando o tráfego corretamente.

Por que um Domínio Personalizado Complica a Migração de Conta do Mastodon

O Mastodon usa o WebFinger, um protocolo aberto, para descobrir contas em instâncias federadas. Quando alguém pesquisa seu identificador @voce@social.exemplo.com, o servidor Mastodon consulta social.exemplo.com/.well-known/host-meta para encontrar sua instância real. Se você mover sua conta sem atualizar os registros DNS e o endpoint WebFinger, o domínio antigo continuará apontando para a instância antiga. Isso causa erros de federação, links de perfil quebrados e perda de atualizações de seguidores.

O processo de migração tem duas partes independentes. A primeira parte é a mudança no nível da conta: você diz ao Mastodon para transferir seguidores, listas e configurações da sua conta antiga para uma nova conta em uma instância diferente. A segunda parte é a atualização no nível do domínio: você altera o DNS e a configuração do servidor web para que seu domínio personalizado resolva para a nova instância. Ambas as partes devem ser bem-sucedidas para uma transição suave.

Passos para Migrar Sua Conta do Mastodon Mantendo um Domínio Personalizado

Complete estas etapas em ordem. Não inicie a migração da conta até que você tenha acesso às contas antiga e nova do Mastodon e possa editar as configurações de DNS do seu domínio personalizado.

Passo 1: Preparar a Nova Conta do Mastodon

1. Crie uma conta na instância de destino.
   Cadastre-se na nova instância do Mastodon para onde deseja migrar. Essa instância pode ser um servidor diferente ou uma instância auto-hospedada com um domínio diferente.
2. Ative a migração de conta na nova conta.
   Vá em Preferências > Conta > Mudar de uma conta diferente. Copie o código de migração exibido nesta página. Este código é um token de uso único que prova que você controla a nova conta.

Passo 2: Iniciar a Mudança de Conta a Partir da Conta Antiga

1. Faça login na sua conta antiga do Mastodon.
   Use a conta que atualmente possui seu domínio personalizado.
2. Navegue até Preferências > Conta > Mudar para uma conta diferente.
   Cole o código de migração copiado da nova conta no campo de texto. Digite sua senha da conta antiga para confirmar a mudança.
3. Envie a solicitação de migração.
   O Mastodon enviará um e-mail de confirmação para o endereço associado à sua conta antiga. Clique no link de confirmação dentro de 24 horas. Após a confirmação, a conta antiga exibirá um aviso de redirecionamento em seu perfil e as solicitações de seguidores serão enviadas para a nova conta.

Passo 3: Atualizar os Registros DNS do Seu Domínio Personalizado

1. Acesse seu registrador de domínio ou provedor de DNS.
   Este é o serviço onde você gerencia os registros DNS do seu domínio personalizado, como Cloudflare, Namecheap ou seu painel de hospedagem.
2. Localize o registro CNAME ou A existente para o subdomínio do seu domínio personalizado.
   Se seu domínio personalizado for social.exemplo.com, encontre o registro CNAME que atualmente aponta para sua instância antiga do Mastodon. Se você usa um registro A, anote o endereço IP atual.
3. Altere o registro CNAME para apontar para o hostname da nova instância.
   Substitua o destino antigo pelo domínio da nova instância, como nova-instancia.social. Se sua nova instância usar um endereço IP diferente para um registro A, atualize o IP. Salve o registro. A propagação de DNS pode levar até 48 horas, mas geralmente ocorre em minutos.

Passo 4: Configurar a Nova Instância para Servir o Domínio Personalizado

1. Adicione o domínio personalizado à configuração do servidor web da nova instância.
   Se você gerencia uma instância auto-hospedada, edite a configuração do Nginx ou Apache para incluir um bloco de servidor para social.exemplo.com. Aponte o diretório raiz para o diretório público do Mastodon. Se você usa uma instância hospedada, entre em contato com o administrador da instância para adicionar seu domínio personalizado como um alias.
2. Configure SSL/TLS para o domínio personalizado.
   Obtenha um certificado Let’s Encrypt para social.exemplo.com no novo servidor. Use o Certbot ou a ferramenta SSL do seu painel de hospedagem. Sem HTTPS, os clientes Mastodon e outras instâncias rejeitarão a conexão.
3. Verifique se o endpoint WebFinger responde corretamente.
   Abra um navegador e acesse https://social.exemplo.com/.well-known/host-meta. Você deve ver uma resposta XML contendo o link para a API do Mastodon. Se você vir um erro 404 ou um redirecionamento para a instância antiga, a configuração do servidor web está incompleta.

Passo 5: Testar a Migração

1. Pesquise sua conta a partir de uma instância diferente do Mastodon.
   Faça login em qualquer instância do Mastodon que não seja a antiga ou a nova. Na barra de pesquisa, digite @voce@social.exemplo.com. A pesquisa deve retornar o perfil da sua nova conta, não o antigo.
2. Envie uma solicitação de seguimento de teste.
   Da mesma instância externa, tente seguir sua conta. A solicitação deve chegar nas solicitações de seguimento da sua nova conta. Se for para a conta antiga, o DNS ou WebFinger ainda está apontando para a instância antiga.
3. Verifique o perfil da conta antiga.
   Visite o perfil da conta antiga na instância original. Deve exibir um banner informando que a conta foi movida para o seu novo domínio. A mensagem de redirecionamento confirma que a migração no nível da conta foi bem-sucedida.

Problemas Comuns na Migração de Domínio Personalizado do Mastodon

Seguidores Não São Transferidos Após a Mudança

Se seus seguidores permanecerem na conta antiga, o código de migração pode ter sido inserido incorretamente ou o e-mail de confirmação não foi clicado. Refaça as etapas da seção 2. Certifique-se de usar o código de migração correto da nova conta e confirme o e-mail dentro de 24 horas. Se o código expirou, gere um novo e repita a mudança.

Domínio Personalizado Exibe Perfil Antigo Após Atualização de DNS

Atrasos na propagação de DNS podem causar isso. Aguarde até 48 horas e limpe o cache DNS local usando ipconfig /flushdns no Windows ou sudo dscacheutil -flushcache no macOS. Se o problema persistir, seu servidor web pode ainda estar servindo o conteúdo da instância antiga. Verifique se o proxy reverso na nova instância encaminha corretamente as solicitações do domínio personalizado para o processo do Mastodon.

WebFinger Retorna 404 ou Instância Errada

Isso indica que o servidor web da nova instância não está configurado para lidar com o caminho .well-known para o domínio personalizado. Verifique se o bloco de servidor para social.exemplo.com inclui um bloco de localização para /.well-known/ que faz proxy para o backend do Mastodon. A configuração padrão do Nginx do Mastodon inclui esse bloco. Se você usa uma instância hospedada, peça ao administrador para adicionar seu domínio personalizado como um alias no arquivo de configuração do Mastodon.

Migração de Domínio Personalizado do Mastodon vs Migração Padrão

Item	Migração Padrão	Migração com Domínio Personalizado
Alterações de DNS necessárias	Não	Sim — atualizar registro CNAME ou A para a nova instância
Configuração do WebFinger	Gerenciada pelo domínio da instância	Deve ser configurada no proxy reverso da nova instância
Certificado SSL/TLS	Fornecido pela instância	Deve ser obtido para o domínio personalizado no novo servidor
Etapas de mudança de conta	Mesmas: usar código de migração e confirmar e-mail	Mesmas: usar código de migração e confirmar e-mail
Transferência de seguidores	Automática após a mudança	Automática após a mudança, mas o DNS deve resolver para a nova instância para novos seguidores

Migrar uma conta do Mastodon com um domínio personalizado exige atenção tanto à mudança no nível da conta quanto à configuração de DNS e servidor web no nível do domínio. A mudança de conta transfere seus seguidores, enquanto a atualização de DNS garante que futuras solicitações de federação cheguem à sua nova instância. Teste a configuração minuciosamente após concluir ambas as partes.