Cuando migras tu cuenta de Mastodon de una instancia a otra, la nueva instancia debe verificar tu cuenta antigua a través de Webfinger. Este paso de verificación confirma que controlas la cuenta antigua antes de que se transfieran los seguidores. Sin una verificación exitosa, el proceso de migración falla y deja a tus seguidores varados en la instancia antigua. Este artículo explica por qué falla la verificación de Webfinger y proporciona soluciones paso a paso para resolver el problema.
Puntos clave: Solucionar la verificación de Webfinger durante la migración de Mastodon
- Preferences > Account > Move from a different account: Inicia el protocolo de enlace de verificación de Webfinger entre las instancias antigua y nueva de Mastodon.
- Old instance account settings > Account > Move to a different account: Genera el alias de migración y el código de redirección que Webfinger verifica.
- DNS TXT record for webfinger domain: Necesario cuando la instancia antigua utiliza un dominio personalizado para garantizar que la resolución de Webfinger funcione correctamente.
Por qué falla la verificación de Webfinger durante la migración de Mastodon
Webfinger es un protocolo que permite a las instancias de Mastodon buscar información sobre un usuario mediante su dirección con formato de correo electrónico (usuario@instancia.com). Durante la migración de la cuenta, la nueva instancia envía una solicitud de Webfinger a la instancia antigua para confirmar que la cuenta antigua existe y pertenece a la persona que inicia la migración. Si la instancia antigua no está disponible, devuelve un error o no reconoce el alias, la verificación falla.
Las causas principales suelen clasificarse en tres categorías:
Instancia inaccesible o fallo en la resolución de DNS
Si la instancia antigua se ha cerrado, está detrás de un firewall o su nombre de dominio ya no resuelve a la dirección IP correcta, la nueva instancia no puede enviar la solicitud de Webfinger. Esto es común al migrar desde una instancia pequeña o mal mantenida que se ha desconectado.
Configuración de alias faltante o incorrecta en la instancia antigua
El proceso de migración requiere que configures un alias de cuenta en la instancia antigua. Este alias le indica a la instancia antigua que tu cuenta se ha movido a la nueva dirección. Sin este alias, la respuesta de Webfinger de la instancia antigua no incluirá la información de redirección, lo que provocará que la verificación falle.
El endpoint de Webfinger no responde correctamente
Algunas instancias de Mastodon tienen configuraciones personalizadas o proxies inversos de terceros que bloquean o modifican las solicitudes de Webfinger. Si el endpoint /.well-known/webfinger no es accesible, devuelve un 404 o sirve un JSON incorrecto, la nueva instancia no puede completar la verificación.
Pasos para solucionar la verificación de Webfinger durante la migración de cuenta
Sigue estos pasos en orden. No omitas ningún paso, ya que cada uno se basa en el anterior.
- Verifica que la instancia antigua siga en línea
Abre un navegador y navega a la página de inicio de la instancia antigua. Si la página carga, la instancia es accesible. Si devuelve un error 502 o 503, la instancia puede estar temporalmente caída. Espera 24 horas e inténtalo de nuevo. Si el dominio muestra un error de DNS o la página está en blanco, es probable que la instancia esté permanentemente fuera de línea. En ese caso, no puedes realizar una migración estándar y debes contactar al administrador de la instancia antigua o usar métodos alternativos para notificar a tus seguidores manualmente. - Configura el alias de cuenta en la instancia antigua
Inicia sesión en tu cuenta antigua de Mastodon. Ve a Preferences > Account > Move from a different account. En realidad, la configuración del alias está en Preferences > Account > Account settings > Move to a different account. Ingresa la dirección completa de tu nueva cuenta (usuario@nuevainstancia.com). Guarda los cambios. Esto crea un alias compatible con Webfinger que apunta a tu nueva cuenta. - Inicia la migración en la nueva instancia
Inicia sesión en tu nueva cuenta de Mastodon. Ve a Preferences > Account > Move from a different account. Ingresa la dirección completa de tu cuenta antigua (usuario@instanciaantigua.com). La nueva instancia enviará una solicitud de Webfinger a la instancia antigua. Si el alias está configurado correctamente y la instancia antigua es accesible, verás un mensaje de confirmación. Haz clic en el botón de confirmación para continuar. - Verifica manualmente la resolución de Webfinger
Si la migración falla, prueba el endpoint de Webfinger manualmente. Abre un navegador y visitahttps://oldinstance.com/.well-known/webfinger?resource=acct:username@oldinstance.com. Reemplazaoldinstance.comyusernamecon el dominio y el nombre de usuario reales. La respuesta debe ser un objeto JSON que contenga un camposubjecty un arraylinkscon un alias que apunte a tu nueva cuenta. Si ves un 404 o un JSON vacío, el alias no está configurado correctamente. Vuelve al paso 2 y verifica el alias. - Configura el DNS si usas un dominio personalizado
Si tu instancia antigua usa un dominio personalizado (no el dominio predeterminado de la instancia), debes agregar un registro TXT de DNS para verificar la propiedad del dominio. Inicia sesión en el panel de control de tu registrador de dominios. Agrega un registro TXT para_mastodoncon el valoroldinstance.com. Espera la propagación del DNS, que puede tardar hasta 48 horas. Luego reintenta la migración desde la nueva instancia. - Contacta al administrador de la instancia antigua si los problemas persisten
Si el endpoint de Webfinger devuelve un error o la instancia no es accesible pero no está permanentemente fuera de línea, contacta al administrador de la instancia. Pídele que revise los registros del servidor en busca de solicitudes de Webfinger y que se asegure de que el proxy inverso (si lo hay) no esté bloqueando/.well-known/webfinger. El administrador también puede forzar manualmente una actualización de la caché de Webfinger reiniciando el servicio web de Mastodon.
Si Webfinger sigue fallando después de la solución principal
La solicitud de Webfinger agota el tiempo de espera
Un tiempo de espera agotado indica que la instancia antigua es accesible pero no responde con la suficiente rapidez. Esto suele ocurrir con instancias sobrecargadas. Espera 30 minutos y vuelve a intentarlo. Si el tiempo de espera persiste, es posible que la instancia esté limitando la tasa de solicitudes de Webfinger. Usa la prueba manual de Webfinger del paso 4 para confirmar que el endpoint funciona. Si la prueba manual tiene éxito pero la migración agota el tiempo de espera, pide al administrador de la instancia antigua que desactive temporalmente la limitación de tasa para tu cuenta.
Webfinger devuelve un error 404
Un error 404 significa que el endpoint de Webfinger no existe o que no se encuentra el recurso. Verifica que la URL del paso 4 use el formato correcto. Si el endpoint devuelve 404 para todas las cuentas, es posible que la instancia haya deshabilitado Webfinger o use una ruta no estándar. Contacta al administrador para habilitar el endpoint estándar de Webfinger en /.well-known/webfinger.
La migración se realiza correctamente pero los seguidores no se transfieren
Incluso si la verificación de Webfinger pasa, la migración de seguidores puede no completarse de inmediato. Mastodon pone en cola las transferencias de seguidores y las procesa por lotes. Espera hasta 24 horas. Si no aparece ningún seguidor, revisa la lista de seguidores de tu cuenta antigua. Si los seguidores siguen ahí, es posible que la migración no se haya procesado por completo. Reintenta la migración desde la nueva instancia. Si el problema continúa, es posible que la instancia antigua tenga un error en su controlador de migración. Informa el problema al administrador con el mensaje de error exacto de los registros del servidor.
| Elemento | Verificación de Webfinger exitosa | Fallo en la verificación de Webfinger |
|---|---|---|
| Estado de la instancia antigua | En línea y accesible | Fuera de línea, error de DNS o limitación de tasa |
| Configuración del alias | Configurado correctamente en la instancia antigua | Alias faltante o incorrecto |
| Endpoint de Webfinger | Devuelve JSON válido con alias | Devuelve 404, tiempo de espera agotado o datos incorrectos |
| Configuración de DNS para dominio personalizado | Registro TXT agregado y propagado | Registro TXT faltante |
Ahora puedes diagnosticar y solucionar fallos de verificación de Webfinger durante la migración de cuentas de Mastodon. Comienza verificando que la instancia antigua esté en línea y que el alias esté configurado. Si las pruebas manuales de Webfinger fallan, contacta al administrador de la instancia. Para problemas persistentes, verifica los registros DNS para dominios personalizados. Este enfoque resuelve la gran mayoría de los problemas de verificación de migración.