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.
Principais Conclusões: Configuração de Migração de Conta Mastodon com Handle de Domínio Personalizado
- Preferências > Conta > Mover de uma conta diferente: Inicia o handshake de migração de seguidores para uma nova conta Mastodon.
- Registro DNS CNAME para handle de domínio personalizado: Aponta seu domínio personalizado para o servidor da instância Mastodon para permitir a verificação do handle.
- Configuração do administrador da instância para domínio personalizado: Exige que o administrador da instância adicione seu domínio personalizado à lista de aliases permitidos no arquivo de configuração do Mastodon.
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
- 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. - 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. - 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.
- 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). - 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. - 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
- 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. - 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. - Abra as configurações de Movimentação
Na barra lateral esquerda, clique em Conta e depois em Mover de uma conta diferente. - 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. - 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. - 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.