Una lista de comprobación previa a la actualización de contenedores y dependencias de Jellyfin
Antes de actualizar un contenedor de Jellyfin, conserva ambos componentes de la implementación: el estado persistente de Jellyfin y la definición exacta del contenedor que sabe cómo acceder a él. Descargar una imagen nueva es fácil; recuperar una base de datos migrada, un montaje modificado o una asignación de dispositivo olvidada, no.
Sigue la lista de comprobación en el orden de las dependencias. Primero, comprueba que puedes recuperar los datos; después, registra la imagen y los ajustes actuales del entorno de ejecución; luego, consulta la ruta de actualización y, solo entonces, sustituye la imagen. Después, prueba las mismas bibliotecas, los mismos usuarios, los modos de reproducción, las tareas programadas y el comportamiento tras el reinicio antes de eliminar la copia de respaldo para volver atrás.
Registra la última imagen y definición de contenedor que funcionaban
Guarda la etiqueta de imagen actual de Jellyfin y, cuando sea posible, su digest. Exporta o copia el archivo Compose o la definición de la aplicación que contiene los puertos, las redes, los montajes, los valores del entorno, la política de reinicio, la asignación de usuarios, los grupos suplementarios, los dispositivos GPU y cualquier relación con el proxy inverso.
La documentación oficial de los contenedores de Jellyfin distingue las etiquetas móviles, como latest, de las etiquetas explícitas de versión mayor, menor y de parche. Comportamiento de las etiquetas de imagen de Jellyfin Es más fácil volver a una versión anterior si conoces la versión exacta que funcionaba, en lugar de recordar solo que «ayer funcionaba latest».
No elimines la imagen anterior ni borres la definición guardada hasta que la nueva versión haya superado todo el período de validación. Si la actualización falla antes de afectar a los datos persistentes, conservar la imagen y la definición ofrece la vía de recuperación menos invasiva.
Crea una copia de seguridad recuperable del estado de Jellyfin
Protege los directorios de datos y configuración de Jellyfin antes de cambiar la imagen. La copia de seguridad debe estar fuera de la ruta activa de la aplicación y poder leerse de forma independiente; una segunda copia o una instantánea en el mismo conjunto de datos solo resulta útil si entiendes de qué tipo de fallo te protege.
La documentación de Jellyfin sobre copias de seguridad advierte que las actualizaciones pueden requerir restaurar los datos, ya que no existe un mecanismo general para volver a una versión anterior después de aplicar las migraciones. También documenta las copias de seguridad integradas y el requisito de detener limpiamente el servicio antes de copiar archivos manualmente. Instrucciones de Jellyfin para hacer copias de seguridad y restaurar
En un flujo de trabajo con contenedores, ZimaSpace cubre el mismo principio con su flujo de trabajo de puntos de reversión previos a la actualización. Detente aquí si no puedes identificar las rutas persistentes o verificar el contenido de la copia de seguridad.
Registra los montajes, UID/GID y las dependencias de hardware
Enumera todos los montajes enlazados y volúmenes con nombre, e indica si son de solo lectura o de lectura y escritura. Anota el UID/GID en tiempo de ejecución, las pertenencias a grupos y la propiedad de los directorios de datos de Jellyfin. Registra también las asignaciones de GPU o dispositivos de renderizado si está habilitada la aceleración por hardware.
La guía de contenedores de Jellyfin muestra que los archivos multimedia, la configuración y la caché se montan por separado, y que el contenedor puede ejecutarse con un UID/GID especificado. rutas persistentes y asignación de usuarios Estos valores son dependencias, no adornos: un contenedor recreado puede iniciarse correctamente y, aun así, encontrar vacío el directorio de configuración o perder los permisos de un dispositivo.
Compara la definición guardada con el contenedor que se ejecuta realmente, no solo con una plantilla que crees que está actualizada. Si el entorno de ejecución tiene cambios manuales que no están en Compose ni en la definición de la aplicación del NAS, corrige esa discrepancia antes de actualizar para que la implementación anterior se pueda reproducir.
Comprueba la ruta de actualización admitida y los riesgos para los complementos
Lee las notas de cada versión para todos los límites entre la versión actual y la de destino. Busca versiones intermedias obligatorias, migraciones de bases de datos, cambios de configuración, compatibilidad de complementos, requisitos de FFmpeg o tareas de inicio prolongadas.
La documentación de actualización de Jellyfin hace hincapié repetidamente en las copias de seguridad y explica por qué los cambios de esquema pueden hacer imposible una reversión sencilla. límites de actualización y reversión Las notas de las versiones principales pueden añadir requisitos previos específicos de cada versión, así que no deduzcas que es seguro saltar versiones solo porque existe la imagen del contenedor.
Si un complemento es esencial, confirma que haya una versión compatible disponible antes de actualizar el servidor. Si un complemento es opcional y en ocasiones ha impedido el inicio, anota su versión actual y prepárate para desactivar solo ese complemento si los registros del nuevo servidor lo identifican como la causa del fallo.
Realiza la actualización sin cambiar los límites del estado
Detén Jellyfin correctamente, descarga la imagen prevista y vuelve a crear solo el servicio de Jellyfin con las mismas rutas persistentes verificadas y las mismas dependencias de ejecución. No combines la actualización con una migración de almacenamiento, un rediseño de UID/GID, una reconfiguración del proxy inverso y una reconfiguración de la GPU, salvo que esos cambios sean el propósito real del mantenimiento.
Vigila el registro del primer inicio. Es posible que una migración tarde un tiempo razonable con una biblioteca grande, mientras que un mensaje inmediato de «permiso denegado», base de datos vacía, ruta inexistente o esquema incompatible apunta a otro problema. No reinicies repetidamente una migración solo porque la interfaz no esté disponible de inmediato.
Si el contenedor se inicia como un servidor nuevo, detenlo antes de configurar nada. Ese síntoma suele indicar que el nuevo servicio apunta a un estado persistente incorrecto. Corrige primero la asignación de montajes; configurar una instancia nueva y vacía puede crear archivos que dificulten la recuperación.
Valida la nueva versión antes de eliminar los recursos para la reversión
Verifica la identidad original del servidor, los usuarios, las bibliotecas, los metadatos y los ajustes importantes. Reproduce un elemento con Direct Play y otro con transcodificación representativa; después, ejecuta u observa una tarea programada importante para tu configuración. Comprueba si hay errores recurrentes de migración, base de datos, permisos y FFmpeg en los registros.
Reinicia el contenedor una vez después de la primera sesión correcta. La nueva versión no se considera totalmente validada hasta que pueda volver a abrir los mismos datos y dispositivos tras una recreación o un reinicio limpios. Esto permite detectar la dependencia accidental de un montaje temporal o del estado del entorno de ejecución.
Conserva la copia de seguridad previa a la actualización, la referencia a la imagen anterior y la definición guardada hasta que el servidor haya superado su período normal de carga de trabajo. Si es necesario revertir después de una migración de la base de datos, sigue el límite de restauración documentado por Jellyfin en lugar de apuntar una imagen anterior a un estado que ya se migró.
Productos recomendados
Soporte y consejos
Más para leer
Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...
Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...
Cómo programar un agente de programación en Open WebUI en un servidor doméstico
Configura una automatización de agente de programación solo para informes en Open WebUI, selecciona su terminal y espacio de trabajo, y verifica los permisos,...
