Cuando compartes un enlace en una publicación de Mastodon, la plataforma normalmente obtiene los metadatos de la página de destino y muestra una tarjeta de vista previa con un título, una descripción y una imagen. Si esa tarjeta de vista previa no aparece, la publicación parece incompleta y puede reducir la interacción de los seguidores. Este problema suele ocurrir porque la URL compartida no contiene las etiquetas Open Graph necesarias, la caché del servidor de Mastodon tiene datos obsoletos o la instancia bloquea las vistas previas de enlaces externos. Este artículo explica las causas principales de la ausencia de vistas previas de enlaces y proporciona soluciones paso a paso tanto para la persona que comparte el enlace como para el administrador de la instancia de Mastodon.
Puntos clave: Cómo solucionar las vistas previas de enlaces en Mastodon
- Etiquetas meta Open Graph en la página de origen: Sin las etiquetas og:title, og:description y og:image, Mastodon no puede generar una tarjeta de vista previa.
- Vaciado de la caché del servidor de Mastodon: Los administradores pueden usar la consola de Rails para eliminar las tarjetas de vista previa obsoletas y forzar una nueva obtención.
- Configuración de privacidad de la instancia: Algunas instancias desactivan las vistas previas de enlaces para todas las publicaciones; revisar la política de privacidad del servidor resuelve esto.
Por qué Mastodon no genera una vista previa de enlace
Mastodon genera una vista previa de enlace enviando una solicitud HTTP en segundo plano a la URL que pegas en el cuadro de redacción. El servidor lee el HTML de la página de destino y busca etiquetas meta específicas definidas por el protocolo Open Graph. Estas etiquetas incluyen og:title, og:description, og:image y og:url. Si la página de destino no incluye estas etiquetas, Mastodon recurre a la etiqueta title del HTML y a una descripción genérica. Si incluso faltan los datos de respaldo o el servidor no puede acceder a la URL, no aparece ninguna tarjeta de vista previa.
La segunda causa común es el almacenamiento en caché del lado del servidor. Una vez que Mastodon obtiene una vista previa de una URL, almacena ese resultado en caché. Si la página de origen cambia posteriormente sus metadatos, la vista previa antigua permanece hasta que la caché caduque o se borre manualmente. La duración predeterminada de la caché es de 24 horas para las obtenciones exitosas y más tiempo para las fallidas.
La tercera causa se relaciona con las políticas de la instancia. Algunos administradores de instancias de Mastodon desactivan por completo las vistas previas de enlaces para reducir la carga del servidor o proteger la privacidad de los usuarios. En ese caso, ninguna URL generará una tarjeta de vista previa, independientemente del contenido de la página de origen.
Pasos para solucionar las vistas previas de enlaces en tus propias publicaciones
- Verifica que la URL sea correcta y accesible
Escribe o pega la URL completa en un navegador y confirma que se carga sin redirecciones ni errores. Mastodon no seguirá redirecciones de JavaScript ni páginas que requieran autenticación. - Revisa la página de origen en busca de etiquetas Open Graph
Abre el código fuente de la página en tu navegador presionando Ctrl+U en Windows o Cmd+U en macOS. Busca og:title. Si encuentras una línea como<meta property="og:title" content="Your Page Title" />, las etiquetas existen. Si faltan, el autor de la página debe agregarlas. - Usa un acortador de URL como solución alternativa
Si no puedes editar la página de origen, pega la URL en un servicio como TinyURL o Bitly. Mastodon obtendrá la vista previa del dominio del acortador, que normalmente incluye etiquetas Open Graph adecuadas. Esta es una solución temporal. - Fuerza a Mastodon a volver a obtener la URL
En la interfaz web de Mastodon, elimina la URL del cuadro de redacción y pégala de nuevo. Espera 10 segundos. Si no aparece ninguna vista previa, la caché aún conserva los datos antiguos. Para obtener una vista previa nueva, agrega un parámetro de consulta que no afecte a la página, como?refresh=1. Ejemplo:https://example.com/page?refresh=1. - Prueba con una URL que se sabe que funciona
Pega una URL de un sitio de noticias importante comohttps://www.bbc.com/news. Si esa URL genera una vista previa, el problema está en la URL original. Si no, el problema está del lado de la instancia de Mastodon.
Pasos para que el administrador restaure las vistas previas de enlaces
Si varios usuarios de tu instancia informan de vistas previas faltantes para varias URL, es probable que el problema se origine en la configuración del servidor o en la caché. Los siguientes pasos requieren acceso por shell al servidor de Mastodon y familiaridad con la consola de Rails.
- Revisa la configuración de vista previa de enlaces en el panel de administración
Inicia sesión como administrador. Ve a Preferencias > Administración > Configuración del servidor > Retención de contenido. Asegúrate de que la opción “Habilitar vistas previas de enlaces” esté marcada. Si no lo está, márcala y haz clic en Guardar. - Vacía la caché de tarjetas de vista previa mediante la consola de Rails
Accede por SSH a tu servidor. Ejecutacd /home/mastodon/livey luegoRAILS_ENV=production bundle exec rails c. En la consola, introducePreviewCard.where.not(url: nil).delete_all. Esto elimina todas las tarjetas de vista previa en caché. Sal conexit. Mastodon volverá a obtener las vistas previas en la próxima publicación que contenga una URL. - Verifica que el trabajador de sidekiq esté en ejecución
La obtención de vistas previas de enlaces la gestiona la cola de sidekiqLinkCrawlWorker. Ejecutasudo systemctl status mastodon-sidekiq. Si el servicio está inactivo, reinícialo consudo systemctl restart mastodon-sidekiq. - Revisa el firewall y el DNS de la instancia
Mastodon debe poder realizar solicitudes HTTPS salientes. Ejecutacurl -I https://example.comdesde el servidor. Si el comando agota el tiempo de espera, el servidor no puede acceder a URL externas. Actualiza las reglas del firewall para permitir el tráfico saliente en el puerto 443.
Si las vistas previas de enlaces siguen sin aparecer
La tarjeta de vista previa muestra solo el nombre de dominio sin imagen
Esto ocurre cuando la página de origen tiene og:title pero carece de og:image o usa una imagen demasiado pequeña. Mastodon requiere que la imagen tenga al menos 200 por 200 píxeles. El autor de la página debe agregar una etiqueta og:image más grande.
La vista previa aparece en la interfaz web pero no en las aplicaciones
Algunas aplicaciones de Mastodon de terceros no muestran tarjetas de vista previa. Prueba la misma publicación en la interfaz web oficial de Mastodon. Si la vista previa aparece allí, la aplicación es el factor limitante. Actualiza la aplicación o contacta a su desarrollador.
La tarjeta de vista previa muestra información desactualizada
El servidor de Mastodon almacenó en caché la vista previa antes de que la página de origen actualizara sus metadatos. El administrador debe vaciar la caché como se describe en la sección anterior. Para una sola URL, el usuario puede agregar un parámetro de consulta para forzar una nueva obtención.
Vista previa de enlaces de Mastodon vs. vista previa de tarjetas de Twitter
| Elemento | Vista previa de enlaces de Mastodon | Vista previa de tarjetas de Twitter |
|---|---|---|
| Formato de metadatos | Open Graph (etiquetas og:) | Twitter Card (etiquetas twitter:) |
| Comportamiento de respaldo | Usa la etiqueta title del HTML y la meta descripción | Usa la etiqueta title del HTML y la meta descripción |
| Requisito de tamaño de imagen | Mínimo 200×200 píxeles | Mínimo 120×120 píxeles |
| Duración de la caché | 24 horas para obtenciones exitosas | 7 días para obtenciones exitosas |
| Control del administrador | Puede desactivar las vistas previas o vaciar la caché | Sin control directo del administrador en terceros |
Mastodon se basa exclusivamente en las etiquetas Open Graph, mientras que Twitter también admite sus propias etiquetas de tarjeta. Si una página solo tiene como objetivo las etiquetas de tarjeta de Twitter, Mastodon no generará una vista previa. Los autores de páginas deben incluir tanto etiquetas og: como twitter: para lograr la máxima compatibilidad.
Conclusión
Ahora puedes diagnosticar y solucionar las vistas previas de enlaces faltantes en Mastodon revisando la página de origen en busca de etiquetas Open Graph, agregando un parámetro de consulta para omitir la caché o ajustando la configuración del servidor. Si eres administrador de una instancia, recuerda vaciar la tabla PreviewCard en la consola de Rails y verificar que la cola de sidekiq LinkCrawlWorker esté activa. Para una solución a largo plazo, anima a los creadores de contenido a incluir las etiquetas og:title, og:description y og:image en sus páginas. Esto garantiza que las vistas previas funcionen en Mastodon y otras plataformas que siguen el estándar Open Graph.