Cómo evitar entradas de películas duplicadas después de cambiar las rutas de almacenamiento
Evita las películas duplicadas haciendo que las rutas antiguas y nuevas sean mutuamente excluyentes antes de que el servidor multimedia escanee la biblioteca migrada.
Una migración de almacenamiento puede mostrar la misma película mediante dos montajes bind, dos raíces de biblioteca, una copia temporal o un registro obsoleto de la base de datos que permanece después de eliminar la ruta antigua. El flujo de trabajo más seguro consiste en pausar los escaneos automáticos, hacer una copia de seguridad de la base de datos de la aplicación, asignar las rutas antiguas y nuevas exactas, mover o copiar los archivos multimedia durante una ventana controlada, eliminar la fuente obsoleta de la biblioteca y ejecutar un único reescaneo deliberado solo después de que el servidor pueda ver una ubicación canónica.
Asigna todas las rutas que pueden llegar a la misma película
Enumera las raíces de la biblioteca, los montajes bind de Docker, los enlaces simbólicos, los sistemas de archivos combinados, los montajes de red y las carpetas temporales de migración. Resuelve la ruta real de una película tanto desde el host como desde el contenedor.
Los duplicados suelen aparecer porque el escáner recibe el mismo archivo mediante una ruta nueva mientras el elemento antiguo de la base de datos sigue siendo válido. Un informe de migración de Jellyfin reprodujo el problema cuando mover las carpetas de la biblioteca creó duplicados.
Elige una ruta canónica de contenedor, como /media/movies, y mantenla estable aunque cambie la fuente de almacenamiento del host. Una ruta de contenedor estable reduce futuros cambios en la base de datos, ya que la aplicación no necesita aprender una ubicación nueva para cada migración de grupo de almacenamiento o unidad.
Pausa los escaneos automáticos antes de copiar o cambiar el nombre de los archivos multimedia
Desactiva la supervisión en tiempo real y los escaneos programados de la biblioteca durante la migración. De lo contrario, el servidor podría indexar copias incompletas, ver ambas ubicaciones o registrar el mismo título mientras las carpetas se cambian de nombre por etapas.
Haz una copia de seguridad de la configuración y la base de datos del servidor multimedia antes de cambiar las rutas. Esto protege el estado de reproducción, las selecciones de carátulas, las colecciones, los usuarios y los identificadores de los proveedores, que una reconstrucción de la biblioteca desde cero podría no reproducir exactamente.
Copia o mueve primero una carpeta de prueba pequeña, verifica las sumas de comprobación o los tamaños de los archivos y deja intacta la fuente antigua hasta que el servicio pueda leer la nueva ubicación. No permitas que ambas rutas sigan siendo raíces activas de la biblioteca durante este periodo de verificación.
Elimina la ruta antigua de la biblioteca antes de escanear la nueva
Una vez verificada la ruta nueva, elimina la carpeta obsoleta de la configuración de la biblioteca o reasigna la ruta existente del contenedor a la nueva fuente del host. Confirma que ya no se pueda acceder a la ruta antigua mediante otra biblioteca o un enlace simbólico.
Eliminar una ruta no siempre purga de inmediato todos los registros asociados. Un problema de Jellyfin informa que los metadatos vinculados a rutas eliminadas persistieron, por lo que debes verificar la limpieza de las rutas en lugar de darla por hecha.
Ejecuta la limpieza de biblioteca compatible con la aplicación o un escaneo completo solo después de que la fuente antigua deje de estar disponible. Evita editar manualmente la base de datos, a menos que tengas una copia de seguridad probada y un plan de recuperación específico para la versión.
Conserva la identidad de los archivos multimedia mientras se trasladan
Mantén coherentes los nombres de las carpetas de películas, los nombres de archivo, los indicadores de año, las etiquetas de edición, los identificadores de proveedores y los archivos de metadatos locales. Una película cuyo nombre cambie durante la misma migración puede tratarse como un elemento diferente aunque sus datos de vídeo no hayan cambiado.
Almacena intencionadamente los metadatos y las carátulas locales. Si hay identificadores como los de TMDB o IMDb incrustados en los nombres o archivos NFO, consérvalos para que la nueva ruta resuelva la misma identidad de película en lugar de crear una segunda coincidencia ambigua.
El flujo de trabajo de migración de datos NAS de ZimaSpace es la comprobación complementaria para proteger los datos de origen y validar los permisos antes de eliminar la copia antigua.
Distingue entre dos rutas y dos versiones o ediciones
Abre ambas entradas duplicadas y compara sus rutas de archivo, la información multimedia, los identificadores de proveedores, la duración, las etiquetas de edición y la disponibilidad. Dos entradas pueden ser el mismo archivo mediante dos rutas, dos copias físicas o versiones legítimas que se agruparon incorrectamente.
Los registros obsoletos pueden seguir siendo accesibles después de que desaparezca una ruta. Un informe de Jellyfin los denomina entradas fantasma, que no deben confundirse con un segundo archivo de película real.
Si ambas entradas apuntan a rutas activas, elimina de la biblioteca la ruta no deseada. Si una ruta ya no existe, utiliza el proceso de limpieza compatible y verifica que el registro desaparezca. Si los archivos son ediciones intencionadas, aplica las reglas compatibles de nomenclatura y agrupación del servidor multimedia en lugar de eliminar una a ciegas.
| Patrón del duplicado | Causa probable | Acción correcta |
|---|---|---|
| Dos entradas, dos rutas activas | Se escanearon las raíces antigua y nueva | Conserva una única ruta canónica |
| Dos entradas, una ruta inexistente | Registro obsoleto de la base de datos | Limpia la biblioteca después de hacer una copia de seguridad |
| Dos archivos, el mismo título | La copia de migración sigue presente | Verifica y retira la copia antigua |
| Dos ediciones intencionadas | Desajuste de nomenclatura o agrupación | Usa la nomenclatura de ediciones compatible |
Esta clasificación evita que una limpieza de la base de datos elimine una versión alternativa legítima o una versión de mayor calidad.
Ejecuta un único reescaneo controlado y verifica el estado
Vuelve a activar los escaneos solo después de montar la ruta canónica, eliminar la ruta antigua y confirmar que el usuario del servicio puede leer la nueva ubicación. Inicia un único escaneo completo y observa los eventos de eliminación y adición relacionados con la película migrada.
Algunas bibliotecas no han eliminado archivos después de un traslado de almacenamiento, incluso tras borrar la ruta antigua de la configuración. Un informe de Jellyfin documenta que los archivos eliminados permanecieron en la biblioteca, por lo que la comprobación final debe comparar las entradas de la base de datos con las rutas reales.
Verifica que cada película aparezca una sola vez, se abra desde la ruta nueva, conserve el estado de reproducción y las colecciones, y siga disponible después de reiniciar el servicio. Mantén el almacenamiento antiguo desconectado, pero intacto, hasta que finalice esta auditoría; después, retíralo según el plan de copias de seguridad y migración.
Productos recomendados
Soporte y Consejos
Más para leer
¿Puede Plex compartir una GPU con otro contenedor de Docker?
Plex y otro contenedor suelen poder acceder a la misma GPU, pero debes probar la compatibilidad de los controladores, la asignación de dispositivos, la...
Cómo saber si un error de Plex proviene del cliente o del servidor
Reproduce el mismo elemento en otro cliente, compara la ruta de la sesión y recopila pruebas del servidor solo después de que el alcance...
Cómo configurar la caché de Plex y el almacenamiento temporal para la transcodificación
Protege el estado persistente de Plex mientras colocas los archivos temporales de transcodificación en un almacenamiento local adecuado; después, verifica la limpieza, el espacio...
