Migração de Conta Mastodon com Handle de Domínio Personalizado: Configuração

Você tem uma conta Mastodon em uma instância e quer migrar para uma nova mantendo seu handle de domínio personalizado. O Mastodon suporta migração de conta, mas usar um handle de domínio personalizado adiciona etapas extras de DNS e configuração. Este artigo explica como configurar um handle de domínio personalizado na sua nova instância Mastodon e migrar seus seguidores, postagens e dados de perfil da sua conta antiga. Você aprenderá os registros DNS exatos a adicionar, o processo de migração e como verificar se tudo funciona corretamente.

O Que é um Handle de Domínio Personalizado no Mastodon e Por Que Você Precisa de Configuração DNS

Um handle de domínio personalizado permite que você use seu próprio nome de domínio como parte da sua identidade no Mastodon. Em vez de @username@mastodon.social, você pode ter @username@seudominio.com. Isso é útil para indivíduos e empresas que desejam uma identidade online consistente em várias plataformas.

Para usar um handle de domínio personalizado, sua instância Mastodon deve suportá-lo. A maioria das instâncias auto-hospedadas permite isso, mas instâncias gerenciadas podem não permitir. O requisito principal é que seu domínio personalizado aponte para o servidor da instância Mastodon via DNS. O Mastodon usa o domínio para verificar se você controla o domínio personalizado antes de permitir que o handle apareça no seu perfil.

A configuração DNS envolve criar um registro CNAME que mapeia seu domínio personalizado para o nome do host do servidor da instância. Esse registro informa ao Mastodon e a outros servidores federados que o domínio personalizado pertence à sua instância. Sem esse registro, o handle não será resolvido e a migração falhará.

Pré-requisitos para Migração com Handle de Domínio Personalizado

Antes de começar, confirme que você tem o seguinte:

• Uma conta Mastodon existente em qualquer instância (a conta antiga).
• Uma nova conta Mastodon em uma instância diferente (a nova conta) que suporte handles de domínio personalizado.
• Acesso ao seu registrador de domínio ou provedor de hospedagem DNS para adicionar registros DNS.
• Acesso administrativo à nova instância Mastodon, ou a capacidade de solicitar ao administrador da instância que adicione seu domínio personalizado à lista de aliases permitidos.

Passos para Configurar Handle de Domínio Personalizado e Migrar Sua Conta Mastodon

O processo tem três fases: configuração DNS, configuração de alias na instância e o handshake de migração.

Fase 1: Configurar DNS para Seu Handle de Domínio Personalizado

1. Acesse seu provedor DNS
   Vá ao painel de controle do seu registrador de domínio ou provedor de hospedagem DNS. Provedores comuns incluem Namecheap, Cloudflare, GoDaddy ou Google Domains.
2. Crie um registro CNAME para o domínio personalizado
   Adicione um novo registro CNAME com os seguintes valores:
   – Nome: @ (ou a raiz do seu domínio)
   – Alvo: o nome do host da sua nova instância Mastodon (por exemplo, mastodon.suainstancia.com)
   – TTL: 3600 (ou deixe o padrão)
   Esse registro informa aos servidores que seu domínio personalizado é um alias para o servidor da sua instância.
3. Aguarde a propagação do DNS
   As alterações de DNS podem levar de alguns minutos a 48 horas. Use uma ferramenta como whatsmydns.net para verificar quando o registro CNAME estiver visível globalmente.

Fase 2: Adicionar Alias de Domínio Personalizado na Configuração da Instância Mastodon

Esta etapa requer acesso ao servidor da instância. Se você não for o administrador da instância, envie as instruções a seguir para seu administrador.

1. Acesse o arquivo de configuração do Mastodon
   No servidor da instância, abra o arquivo .env.production localizado no diretório do Mastodon (geralmente /home/mastodon/live/.env.production).
2. Adicione o domínio personalizado à lista de aliases permitidos
   Encontre a linha que começa com WEB_DOMAIN ou LOCAL_DOMAIN. Adicione uma nova linha:
   WEB_DOMAIN=seudominio.com
   Se a linha já existir, substitua seu valor pelo seu domínio personalizado. Em seguida, adicione:
   ALLOWED_ALIASES=seudominio.com
   Se vários aliases forem necessários, separe-os com vírgulas.
3. Reinicie os serviços do Mastodon
   Execute os seguintes comandos no servidor:
   cd /home/mastodon/live
   RAILS_ENV=production bin/tootctl cache clear
   systemctl restart mastodon-web mastodon-sidekiq mastodon-streaming
   Isso recarrega a configuração e limpa o cache.

Fase 3: Iniciar a Migração de Conta a Partir da Nova Conta

1. Faça login na sua nova conta Mastodon
   Abra a nova instância no seu navegador e faça login com a conta que receberá os seguidores.
2. Navegue até as preferências da conta
   Clique no ícone de engrenagem ou na sua foto de perfil e selecione Preferências no menu suspenso.
3. Abra as configurações de Movimentação
   Na barra lateral esquerda, clique em Conta e depois em Mover de uma conta diferente.
4. Insira o handle da sua conta antiga
   No campo rotulado Handle da conta antiga, digite o handle completo da sua conta antiga, incluindo o domínio. Por exemplo: @usuarioantigo@instanciaantiga.social.
5. Crie e insira um código de migração
   Na sua conta antiga, vá em Preferências > Conta > Mover para uma conta diferente. Clique em Criar código de migração. Copie o código gerado. Volte para a página da nova conta e cole o código no campo Código de migração.
6. Confirme a migração
   Clique no botão Mover seguidores. O Mastodon enviará um e-mail de confirmação para o endereço de e-mail da sua conta antiga. Abra o e-mail e clique no link de confirmação para finalizar a migração.

Se a Migração Falhar ou o Handle de Domínio Personalizado Não Aparecer

Handle de domínio personalizado aparece como não verificado

Se seu perfil ainda mostrar o domínio da instância antiga em vez do seu domínio personalizado, o registro CNAME do DNS pode não ter propagado. Verifique o registro usando uma ferramenta de consulta DNS. Além disso, confirme que o administrador da instância adicionou o domínio personalizado à linha ALLOWED_ALIASES. Sem esse alias, o Mastodon não associará o domínio personalizado à sua conta.

Código de migração inválido ou expirado

Os códigos de migração expiram após um curto período. Se você vir um erro, gere um novo código na conta antiga e tente novamente. Certifique-se de copiar o código inteiro exatamente, incluindo hífens ou caracteres especiais.

Seguidores não são movidos após a migração

A migração de seguidores não é instantânea. Pode levar até 24 horas para que todos os seguidores apareçam na nova conta. Se os seguidores ainda estiverem ausentes após 24 horas, verifique se a conta antiga ainda existe e não foi excluída. O Mastodon exige que a conta antiga permaneça ativa para que a migração seja concluída.

Handle de Domínio Personalizado vs Handle Padrão do Mastodon

Item	Handle de Domínio Personalizado	Handle Padrão do Mastodon
Descrição	Usa seu próprio domínio como sufixo do handle	Usa o domínio da instância como sufixo do handle
Configuração DNS necessária	Sim, registro CNAME apontando para o servidor da instância	Não
Ação do administrador da instância necessária	Sim, deve adicionar o domínio aos aliases permitidos	Não
Portabilidade entre instâncias	Exige reconfiguração de DNS e alias a cada vez	Migração simples sem configuração extra
Valor de marca	Alto, mostra seu próprio domínio	Baixo, vinculado ao domínio da instância

Agora você pode migrar uma conta Mastodon com um handle de domínio personalizado configurando DNS, atualizando o alias da instância e executando o handshake de migração. Após a migração, verifique se seu perfil exibe o domínio personalizado e se os seguidores foram movidos. Para uma próxima migração mais suave, mantenha um registro das suas configurações de DNS e das alterações de configuração da instância para que possa reutilizá-las em uma nova instância.