Rozwiązanie społecznościowe

Napraw strefę czasową Jellyfin w ZimaOS: ustaw zmienną środowiskową TZ na region IANA

A short November 2025 support thread where a new Jellyfin user in the United States saw TZ set to Europe/London. Zima-Jerry said to change the TZ environment variable to a valid region such as America/New_York. The original poster immediately confirmed the change worked.

Rozwiązanie problemu ze źródła jest proste i oficjalne: Jellyfin został zainstalowany ze zmienną środowiskową kontenera TZ=Europe/London, ale użytkownik mieszkał w Stanach Zjednoczonych. Zima-Jerry zalecił zastąpienie tej wartości odpowiednim identyfikatorem strefy czasowej IANA, takim jak America/New_York. Użytkownik zmienił wartość i natychmiast potwierdził, że to zadziałało.

To problem z konfiguracją kontenera, a nie powód do ponownej instalacji Jellyfin ani zmiany zegara hosta ZimaOS. Aktualne przykłady kontenerów Jellyfin nadal wykorzystują zmienną środowiskową TZ z wartościami w formacie region/miasto, takimi jak America/Los_Angeles.

Ustawienia aplikacji Jellyfin w ZimaOS pokazujące zmienną środowiskową TZ ustawioną na Europe/London
Problem ze źródła jest bezpośrednio widoczny w ustawieniach aplikacji: zmienna TZ kontenera Jellyfin była ustawiona na niewłaściwy region.

Zmień zmienną środowiskową TZ

Otwórz ustawienia aplikacji Jellyfin w ZimaOS, znajdź zmienną środowiskową o nazwie TZ i zastąp jej wartość prawidłowym identyfikatorem regionu/miasta IANA.

Przykłady:

  • America/New_York;
  • America/Chicago;
  • America/Denver;
  • America/Los_Angeles;
  • Europe/London;
  • Asia/Tokyo.

Używaj nazw region/miasto, a nie stałego przesunięcia względem UTC

Strefa czasowa IANA uwzględnia zmiany czasu na letni oraz historyczne zmiany reguł. Stała wartość, taka jak UTC-5, może być nieprawidłowa przez część roku w miejscach, w których obowiązuje czas letni.

Zapisz ustawienia aplikacji i pozwól kontenerowi uruchomić się ponownie

Zmienne środowiskowe są przekazywane podczas uruchamiania kontenera. Po zmianie wartości TZ zapisz ustawienia aplikacji i pozwól Jellyfinowi uruchomić się ponownie lub zostać odtworzonym zgodnie z wymaganiami ZimaOS.

Następnie sprawdź czas w logach Jellyfin, zaplanowanych zadaniach oraz elementach interfejsu zależnych od daty.

Nie zmieniaj zegara systemowego ZimaOS tylko po to, by naprawić jeden kontener

Jeśli panel ZimaOS pokazuje już prawidłowy czas, ale Jellyfin nie, najpierw zmień strefę czasową kontenera Jellyfin. Ustawienia NTP/czasu hosta i sposób prezentowania czasu w kontenerze to osobne warstwy.

Niestandardowe mapowania portów ze źródła nie były związane z poprawką TZ

Ustawienia aplikacji Jellyfin w ZimaOS pokazujące mapowania portów hosta na kontener, w tym 8097 na 8096
Źródło zawierało również niestandardowe porty, ale Zima-Jerry nie wskazał tych mapowań jako przyczyny nieprawidłowej strefy czasowej.

Mapowania urządzeń GPU to osobna kwestia dotycząca Jellyfin

Ustawienia Jellyfin w ZimaOS pokazujące mapowania urządzeń GPU i wideo, w tym /dev/dri
Urządzenia używane do transkodowania sprzętowego nie wpływają na zmienną środowiskową TZ; należy je diagnozować oddzielnie.

Aktualne przykłady konfiguracji Docker dla Jellyfin używają tego samego schematu TZ

Aktualna dokumentacja kontenerów Jellyfin zawiera ustawienia środowiskowe takie jak:

TZ=America/Los_Angeles

Zobacz aktualny schemat środowiska kontenera Jellyfin.

Dlaczego strefa czasowa ma znaczenie wykraczające poza wyświetlanie zegara

Jellyfin wykorzystuje informacje o czasie w logach, zaplanowanych zadaniach konserwacyjnych, zadaniach biblioteki, historii aktywności i innych funkcjach zależnych od daty. Nieprawidłowa wartość TZ może więc sprawić, że sprawny serwer będzie wydawał się problematyczny, nawet jeśli odtwarzanie multimediów działa poprawnie.

Po zmianie zmiennej sprawdź co najmniej sygnaturę czasową jednego zaplanowanego zadania lub ostatni wpis w logu, aby upewnić się, że zamierzona strefa jest widoczna nie tylko w przeglądarce, ale także w kontenerze.

Często zadawane pytania dotyczące strefy czasowej Jellyfin

Czy zmiana TZ rozwiązała problem użytkownika ze źródła?

Tak. Użytkownik wyraźnie potwierdził, że rozwiązanie zadziałało.

Czy wartość powinna być ustawiona na EST lub PST?

Preferuj strefę IANA, taką jak America/New_York lub America/Los_Angeles, aby reguły czasu letniego były obsługiwane prawidłowo.

Czy ustawienia portów lub GPU Jellyfin trzeba zmienić, aby naprawić strefę czasową?

Nie. Te ustawienia są niezależne od zmiennej środowiskowej TZ.