A correção original é simples e oficial: o Jellyfin foi instalado com a variável de ambiente do contentor TZ=Europe/London, mas o utilizador vivia nos Estados Unidos. O Zima-Jerry indicou-lhe que substituísse o valor por um identificador de fuso horário IANA adequado, como America/New_York. O utilizador alterou-o e confirmou imediatamente que funcionava.
Este é um problema de configuração do contentor, não uma razão para reinstalar o Jellyfin ou alterar o relógio do anfitrião ZimaOS. Os exemplos atuais de contentores Jellyfin continuam a utilizar uma variável de ambiente TZ com valores no formato região, como America/Los_Angeles.
Alterar a variável de ambiente TZ
Abra as definições da aplicação Jellyfin no ZimaOS, localize a variável de ambiente com o nome TZ e substitua o valor pelo identificador IANA correto de região/cidade.
Exemplos:
-
America/New_York; -
America/Chicago; -
America/Denver; -
America/Los_Angeles; -
Europe/London; -
Asia/Tokyo.
Utilizar nomes de região/cidade, não uma diferença fixa em relação ao UTC
Um fuso horário IANA compreende as mudanças para a hora de verão e as alterações históricas das regras. Um valor fixo como UTC-5 pode estar errado durante parte do ano em locais que adotam a hora de verão.
Guardar as definições da aplicação e deixar o contentor reiniciar
As variáveis de ambiente são injetadas quando o contentor é iniciado. Depois de alterar o TZ, guarde as definições da aplicação e permita que o Jellyfin reinicie/seja recriado conforme necessário no ZimaOS.
Em seguida, confirme a hora nos registos do Jellyfin, nas tarefas agendadas e em qualquer interface que dependa da data.
Não altere o relógio do sistema ZimaOS apenas para corrigir um contentor
Se o painel do ZimaOS já mostrar a hora correta, mas o Jellyfin não, altere primeiro o fuso horário do contentor do Jellyfin. As definições de NTP/hora do anfitrião e a apresentação da hora no contentor são camadas distintas.
Os mapeamentos de portas personalizados do caso original não faziam parte da correção do TZ
Os mapeamentos de dispositivos GPU são um problema separado do Jellyfin
Os exemplos atuais de Docker do Jellyfin utilizam o mesmo padrão TZ
A documentação atual de contentores do Jellyfin inclui definições de ambiente como:
TZ=America/Los_Angeles
Consulte o padrão atual de ambiente de contentor do Jellyfin.
Porque é que o fuso horário é importante para além da apresentação do relógio
O Jellyfin utiliza informações de hora nos registos, na manutenção agendada, nas tarefas da biblioteca, no histórico de atividade e noutros comportamentos dependentes da data. Um valor TZ incorreto pode, por isso, fazer com que um servidor saudável pareça confuso, mesmo quando a reprodução multimédia funciona.
Depois de alterar a variável, verifique pelo menos um carimbo de data/hora de uma tarefa agendada ou uma entrada recente do registo, para confirmar que é o contentor — e não apenas o navegador — que vê agora o fuso pretendido.
Perguntas frequentes sobre o fuso horário do Jellyfin
A alteração do TZ resolveu o problema do utilizador original?
Sim. O utilizador respondeu explicitamente que funcionou.
O valor deve ser EST ou PST?
Prefira uma região IANA, como America/New_York ou America/Los_Angeles, para que as regras da hora de verão sejam aplicadas corretamente.
É necessário alterar as definições de portas ou da GPU do Jellyfin para corrigir o fuso horário?
Não. Essas definições são independentes da variável de ambiente TZ.
