La solución oficial al problema de origen es sencilla: Jellyfin se instaló con la variable de entorno del contenedor TZ=Europe/London, pero el usuario vivía en Estados Unidos. Zima-Jerry le indicó que reemplazara el valor por un identificador de zona horaria IANA adecuado, como America/New_York. El usuario lo cambió y confirmó de inmediato que funcionaba.
Este es un problema de configuración del contenedor, no una razón para reinstalar Jellyfin ni para cambiar el reloj del host de ZimaOS. Los ejemplos actuales de contenedores de Jellyfin siguen utilizando una variable de entorno TZ con valores regionales, como America/Los_Angeles.
Cambiar la variable de entorno TZ
Abre la configuración de la aplicación Jellyfin en ZimaOS, busca la variable de entorno denominada TZ y reemplaza el valor por el identificador IANA correcto de región/ciudad.
Algunos ejemplos son:
-
America/New_York; -
America/Chicago; -
America/Denver; -
America/Los_Angeles; -
Europe/London; -
Asia/Tokyo.
Usa nombres de región/ciudad, no un desplazamiento UTC fijo
Una zona horaria IANA entiende las transiciones al horario de verano y los cambios históricos de las reglas. Un valor fijo como UTC-5 puede ser incorrecto durante parte del año en lugares que aplican el horario de verano.
Guarda la configuración de la aplicación y permite que el contenedor se reinicie
Las variables de entorno se inyectan cuando se inicia el contenedor. Después de cambiar TZ, guarda la configuración de la aplicación y permite que Jellyfin se reinicie o se vuelva a crear según lo requiera ZimaOS.
Después, confirma la hora en los registros de Jellyfin, las tareas programadas y cualquier interfaz cuyo contenido dependa de la fecha.
No cambies el reloj del sistema de ZimaOS solo para corregir un contenedor
Si el panel de ZimaOS ya muestra la hora correcta, pero Jellyfin no, cambia primero la zona horaria del contenedor de Jellyfin. La configuración de NTP y hora del host, y la hora mostrada por el contenedor, son capas independientes.
Las asignaciones de puertos personalizadas del problema de origen no formaban parte de la solución de TZ
Las asignaciones de dispositivos GPU son un problema independiente de Jellyfin
Los ejemplos actuales de Docker para Jellyfin utilizan el mismo patrón de TZ
La documentación actual de contenedores de Jellyfin incluye configuraciones de entorno como:
TZ=America/Los_Angeles
Consulta el patrón actual de entorno de contenedor de Jellyfin.
Por qué la zona horaria es importante más allá de la visualización del reloj
Jellyfin utiliza la información horaria para los registros, el mantenimiento programado, las tareas de la biblioteca, el historial de actividad y otros comportamientos que dependen de la fecha. Por lo tanto, un valor incorrecto de TZ puede hacer que un servidor en buen estado resulte confuso, aunque la reproducción multimedia funcione correctamente.
Después de cambiar la variable, verifica al menos la marca de tiempo de una tarea programada o una entrada reciente del registro para asegurarte de que el contenedor, y no solo el navegador, ve ahora la zona prevista.
Preguntas frecuentes sobre la zona horaria de Jellyfin
¿Cambiar TZ solucionó el problema del usuario de origen?
Sí. El usuario confirmó explícitamente que funcionaba.
¿El valor debería ser EST o PST?
Es preferible utilizar una región IANA, como America/New_York o America/Los_Angeles, para que las reglas del horario de verano se gestionen correctamente.
¿Es necesario cambiar la configuración de puertos o GPU de Jellyfin para solucionar la zona horaria?
No. Esas configuraciones son independientes de la variable de entorno TZ.
