Cambiaste tu foto de perfil en tu instancia principal de Mastodon, pero la imagen anterior aún se muestra en otras instancias. Esto ocurre porque las instancias de Mastodon almacenan en caché los datos del perfil localmente para reducir la carga del servidor. Los datos en caché no se actualizan automáticamente cuando cambias tu avatar. Este artículo explica por qué la caché bloquea la actualización y muestra tres métodos confiables para forzar que la nueva imagen aparezca en todas partes.
Puntos clave: Forzar la actualización de la foto de perfil de Mastodon entre instancias
- Ctrl + F5 (Windows) o Cmd + Shift + R (Mac): Realiza una actualización forzada de la caché del navegador para cargar el nuevo avatar desde el servidor.
- Configuración > Apariencia > Avanzado > Borrar caché: Borra la caché local de la aplicación web de Mastodon para forzar una descarga nueva de los datos de tu perfil.
- Vaciar la caché del servidor de terceros: Los administradores pueden vaciar la caché de la instancia remota utilizando la API de Mastodon o un comando manual del servidor para propagar la actualización.
Por qué las fotos de perfil de Mastodon se quedan atascadas en otras instancias
Mastodon es una red federada. Cuando publicas o actualizas tu perfil, tu instancia principal envía los nuevos datos a las instancias remotas. Esas instancias remotas almacenan una copia local de tu foto de perfil para evitar solicitar la imagen a tu instancia principal cada vez que alguien ve tu perfil. Esta copia local se llama caché.
El tiempo de expiración de la caché depende de la configuración de la instancia remota. Muchas instancias mantienen los medios en caché durante 24 horas o más. Durante ese período, la instancia remota sirve la imagen anterior a sus usuarios. Tu instancia principal muestra la nueva imagen de inmediato porque no almacena en caché los datos de sus propios usuarios.
Otro factor es la caché del navegador en el lado del espectador. Cuando un usuario visita tu perfil, su navegador guarda la respuesta de la URL de la imagen. Incluso si la instancia remota actualiza su caché, el navegador puede seguir sirviendo el archivo anterior desde el almacenamiento local. Esto crea un doble problema de caché que hace que la actualización parezca invisible.
Pasos para forzar la actualización de la foto de perfil entre instancias
Utiliza los métodos a continuación en orden. Comienza con la solución rápida del navegador, luego borra la caché de la aplicación web de Mastodon y finalmente vacía la caché del servidor si tienes acceso administrativo.
Método 1: Actualización forzada de la caché del navegador
Este método obliga a tu navegador a ignorar su caché local y solicitar la imagen directamente al servidor.
- Abre tu página de perfil de Mastodon
Navega a la URL de tu perfil en cualquier instancia donde la imagen anterior aún aparezca. - Realiza una actualización forzada
Presiona Ctrl + F5 en Windows o Cmd + Shift + R en Mac. La página se recarga y el navegador solicita todos los recursos al servidor sin usar la caché local. - Verifica la foto de perfil
Si la nueva imagen aparece, el problema era solo la caché del navegador. Si aún muestra la imagen anterior, continúa con el Método 2.
Método 2: Borrar la caché de la aplicación web de Mastodon
Mastodon almacena algunos datos en el navegador utilizando IndexedDB y el almacenamiento local. Borrar esta caché obliga a la aplicación web a volver a obtener los datos de tu perfil.
- Ve a la configuración de Mastodon
Haz clic en el icono de engranaje en la columna derecha de la interfaz web de Mastodon para abrir Configuración. - Abre la configuración de Apariencia
En la barra lateral izquierda, haz clic en Apariencia. - Expande las opciones avanzadas
Desplázate hacia abajo y haz clic en Mostrar opciones avanzadas. - Borra la caché
Haz clic en el botón Borrar caché. Aparece un diálogo de confirmación. Haz clic en Aceptar. - Recarga la página
Presiona F5 para actualizar la página. Tu foto de perfil debería mostrar ahora la versión actualizada.
Método 3: Vaciar la caché del servidor en tu instancia principal
Este método requiere acceso administrativo a tu instancia de Mastodon. Fuerza a la instancia a reprocesar los medios de tu perfil y enviar la actualización a los servidores remotos.
- Abre una terminal o sesión SSH
Inicia sesión en tu servidor de Mastodon como un usuario con privilegios sudo. - Ejecuta el comando para vaciar la caché de medios
Ingresa el siguiente comando:RAILS_ENV=production bin/tootctl media remove --days 0 --include-thumbnails
Esto elimina todas las miniaturas en caché y obliga a Mastodon a regenerarlas en la próxima solicitud. - Vuelve a subir tu foto de perfil
Ve a Preferencias > Perfil > Avatar y sube la imagen nuevamente. Esto activa un nuevo trabajo de procesamiento de medios que crea miniaturas nuevas. - Espera la federación
Las instancias remotas pueden tardar hasta 24 horas en recoger la nueva imagen. Puedes acelerar esto pidiendo a los usuarios de otras instancias que realicen una actualización forzada como se describe en el Método 1.
Si la foto de perfil aún no se actualiza
La imagen anterior persiste en aplicaciones de terceros específicas
Las aplicaciones de terceros de Mastodon como Tusky, Mammoth o Ivory a menudo almacenan en caché las fotos de perfil por separado. Cierra la aplicación por completo y vuelve a abrirla. Si el problema continúa, borra la caché de la aplicación a través de la configuración de tu dispositivo. En Android, ve a Configuración > Aplicaciones > [App Name] > Almacenamiento > Borrar caché. En iOS, desinstala y reinstala la aplicación porque iOS no ofrece una opción para borrar la caché por aplicación.
La imagen aparece actualizada en algunas instancias pero no en otras
Esto indica que algunas instancias remotas tienen un período de caché más largo que otras. No hay forma de forzar a una instancia remota a vaciar su caché a menos que seas el administrador. Espera las 24 a 48 horas estándar. Si la imagen aún no se actualiza en una instancia específica después de 48 horas, contacta al administrador de la instancia y pídele que vacíe manualmente su caché de medios usando el comando tootctl media remove.
La nueva imagen se muestra como rota o falta
Una imagen rota generalmente significa que la carga del archivo falló o que el formato de imagen no es compatible. Mastodon admite JPEG, PNG, GIF y WebP. Vuelve a subir la imagen en uno de estos formatos. Si el problema persiste, verifica el espacio en disco de tu instancia. Un disco lleno impide que se almacenen nuevos medios. Pide a tu administrador que ejecute df -h en el servidor para verificar el espacio disponible.
Métodos de actualización de la foto de perfil de Mastodon: Navegador vs Caché de la aplicación vs Vaciar el servidor
| Elemento | Actualización forzada del navegador | Borrar caché de la aplicación web de Mastodon | Vaciar caché de medios del servidor |
|---|---|---|---|
| Qué soluciona | Caché del navegador del espectador | Caché IndexedDB de Mastodon | Miniaturas del lado del servidor y caché remota |
| Tiempo para aplicar | 2 segundos | 30 segundos | 5 a 10 minutos |
| Requiere acceso de administrador | No | No | Sí |
| Efecto en instancias remotas | Ninguno | Ninguno | Fuerza una nueva obtención desde tu instancia |
| Tasa de éxito | Baja si la caché remota está activa | Media | Alta |
Ahora puedes forzar una actualización de la foto de perfil entre instancias de Mastodon utilizando la actualización forzada del navegador, el borrado de la caché de la aplicación web o el vaciado de medios del servidor. Comienza con el método del navegador porque es el que menos tiempo requiere. Si la imagen anterior permanece, borra la caché de Mastodon en la configuración de Apariencia. Para problemas persistentes, pide al administrador de tu instancia que ejecute el comando tootctl media remove. Un consejo avanzado útil es configurar tu foto de perfil con una URL que devuelva un parámetro de consulta que rompa la caché, como ?v=2, pero Mastodon actualmente elimina los parámetros de consulta de los medios subidos. El enfoque más confiable es volver a subir la imagen después de vaciar la caché del servidor.