Tecnología · GUÍA PRÁCTICA
¿Desaparecieron tus listas de Jellyfin? Comprueba la visibilidad y los elementos antes de restaurar
Una lista que no aparece, una lista vacía y una ruta multimedia inaccesible requieren soluciones distintas. Conserva las pruebas y elige la recuperación adecuada.
Que una lista desaparezca de una pantalla de Jellyfin no demuestra que se hayan borrado sus elementos. Compara primero el mismo servidor y cuenta en la interfaz web y en el cliente afectado. Determina si la lista no aparece, existe pero está vacía, o contiene elementos que no se reproducen.
Esta guía ofrece una hoja de evidencias y una decisión de recuperación, no un script para reparar la base de datos. Sirve para listas ausentes o vacías tras una actualización o reinicio. Los informes históricos de 10.11 no prueban que tu instalación actual tenga el mismo fallo; Jellyfin 12 también cambió el almacenamiento de los elementos.
1. Conserva el estado antes de experimentar
Anota qué cambió, cuándo funcionó por última vez y cuándo falló. Guarda de forma privada los registros de inicio, migración, exploración y limpieza. Si la migración sigue en curso, observa su progreso: Jellyfin advierte que no se debe detener el servidor durante ella. No reinicies repetidamente para probar el síntoma.
Una vez terminada, sigue el procedimiento oficial de copia. La copia manual requiere detener el servidor y copiar sus directorios reales de datos y configuración. Separa este estado actual del respaldo intacto anterior a la actualización y anota la versión correspondiente a cada uno. Una copia posterior a la pérdida puede contener solo el estado dañado.
2. Comprueba si solo falla la visualización
Abre una sesión web limpia en el mismo servidor con la cuenta afectada. Compara las listas con el cliente de terceros, revisando los filtros de biblioteca y el servidor seleccionado. Registra una fila por lista: nombre, propietario o contexto de uso compartido, visibilidad, número mostrado y posibilidad de abrir los elementos.
Si la web contiene los elementos esperados y otro cliente no, investiga primero ese cliente. Un mantenedor de Feishin recomendó comparar su respuesta de listas con la web de Jellyfin, aunque no pudo reproducir el informe. Un administrador puede revisar la respuesta localmente, pero debe retirar tokens, cookies y rutas privadas antes de pedir ayuda públicamente.
3. Revisa el almacenamiento antes de limpiar
Si hay elementos pero no se reproducen, confirma que Jellyfin puede leer los archivos exactos a los que apuntan. En contenedores, anota el origen del host y el destino dentro del contenedor según el montaje activo. Un archivo visible en el host puede faltar en la ruta interna. La documentación de migración exige rutas coincidentes al trasladar una instalación existente a Docker.
La documentación de tareas advierte que la limpieza de colecciones y listas puede hacer perder listas cuando el contenido no está disponible; normalmente se ejecuta al arrancar. Recupera un acceso fiable antes de reiniciar deliberadamente o ejecutar la limpieza y revisa sus disparadores. Desactivar uno no recupera elementos perdidos ni garantiza resolver todos los problemas de exploración.
4. Inventaría lo que realmente queda
Examina copias del estado antiguo y actual sin editar la base de datos en uso. Para cada lista recuperable, registra la instantánea de origen, el número esperado y las referencias multimedia en orden. Conserva cada aparición repetida como una posición distinta. Si solo queda el nombre o no puedes interpretar el archivo, marca los elementos como desconocidos.
No apliques una receta SQL o XML antigua solo porque coincida el nombre del archivo. Jellyfin 12 guarda cada elemento como una fila independiente y permite pistas duplicadas. Una explicación basada en el antiguo LinkedChildren no describe universalmente el almacenamiento actual. Un XML conservado es una prueba útil, pero no demuestra que el servidor reconozca la lista o su propietario.
5. Elige una recuperación delimitada
Una diferencia exclusiva del cliente requiere investigar el cliente; una ruta ilegible requiere reparar el almacenamiento. Si faltan elementos y tienes un respaldo válido, prueba la restauración oficial sobre otra copia de trabajo y con la versión de aplicación correspondiente. Aíslala de los directorios de producción y de herramientas que puedan escribir sobre los archivos originales. No abras datos ya migrados con un servidor antiguo.
Si solo sobreviven pruebas parciales, reconstruye una lista nueva con archivos verificados mediante controles compatibles, conservando la evidencia original. No pongas a cero los identificadores de propietario, mezcles bases de datos ni sustituyas rutas masivamente como arreglo genérico. Cuando no puedas verificar propietario, orden o identidad, conserva esas filas pendientes y busca ayuda para esa versión.
6. Valida cada lista recuperada
Compara con la hoja el número esperado, cada elemento en orden, sus repeticiones y una muestra de reproducción. Comprueba también la visibilidad y edición con el usuario previsto. Nombres o cantidades coincidentes pueden ocultar pistas equivocadas, cambios de orden o permisos incorrectos. Los identificadores antiguos y nuevos deben conciliarse; no prueban automáticamente que sea el mismo archivo.
Cuando el almacenamiento esté disponible de forma fiable, verifica el resultado mediante un reinicio controlado y las exploraciones exigidas por las instrucciones de la versión aplicable. Conserva las copias hasta superar esas comprobaciones. Este procedimiento se basa en fuentes: no se realizó una migración ni restauración real de Jellyfin para el artículo y no puede recrear elementos ausentes de todas las copias supervivientes.
