근본적인 해결 방법은 간단하고 공식적입니다. Jellyfin이 컨테이너 환경 변수 TZ=Europe/London으로 설치되어 있었지만, 사용자는 미국에 거주하고 있었습니다. Zima-Jerry는 America/New_York와 같은 적절한 IANA 시간대 식별자로 값을 바꾸라고 안내했습니다. 사용자는 값을 변경한 직후 정상적으로 작동한다고 확인했습니다.
이는 컨테이너 구성 문제이므로 Jellyfin을 다시 설치하거나 ZimaOS 호스트 시계를 변경할 필요가 없습니다. 현재 Jellyfin 컨테이너 예시에서도 America/Los_Angeles와 같은 지역 형식의 값을 사용하는 TZ 환경 변수를 계속 사용합니다.
TZ 환경 변수 변경
ZimaOS에서 Jellyfin 앱 설정을 열고 TZ라는 환경 변수를 찾아 올바른 IANA 지역/도시 식별자로 값을 변경합니다.
예시는 다음과 같습니다.
-
America/New_York; -
America/Chicago; -
America/Denver; -
America/Los_Angeles; -
Europe/London; -
Asia/Tokyo.
고정 UTC 오프셋이 아닌 지역/도시 이름 사용
IANA 시간대는 일광 절약 시간제 전환과 과거의 규칙 변경을 반영합니다. UTC-5와 같은 고정 값은 일광 절약 시간을 적용하는 지역에서 연중 일부 기간에 잘못된 값이 될 수 있습니다.
앱 설정을 저장하고 컨테이너가 다시 시작되도록 하기
환경 변수는 컨테이너가 시작될 때 주입됩니다. TZ를 변경한 후 앱 설정을 저장하고 ZimaOS의 요구 사항에 따라 Jellyfin이 다시 시작되거나 다시 생성되도록 기다립니다.
그런 다음 Jellyfin 로그, 예약된 작업 및 날짜에 따라 달라지는 UI에서 시간이 올바른지 확인합니다.
컨테이너 하나를 수정하기 위해 ZimaOS 시스템 시계를 변경하지 않기
ZimaOS 대시보드에는 시간이 올바르게 표시되지만 Jellyfin에서만 잘못 표시된다면 먼저 Jellyfin의 컨테이너 시간대를 변경합니다. 호스트의 NTP/시간 설정과 컨테이너에 표시되는 시간은 서로 다른 계층입니다.
원문의 사용자 지정 포트 매핑은 TZ 수정과 관련이 없습니다
GPU 장치 매핑은 별도의 Jellyfin 문제입니다
현재 Jellyfin Docker 예시도 동일한 TZ 패턴 사용
Jellyfin의 최신 컨테이너 문서에는 다음과 같은 환경 설정이 포함되어 있습니다.
TZ=America/Los_Angeles최신 Jellyfin 컨테이너 환경 설정 패턴을 참조하세요.
시계 표시 외에도 시간대가 중요한 이유
Jellyfin은 로그, 예약된 유지 관리, 라이브러리 작업, 활동 기록 및 기타 날짜에 따라 달라지는 동작에 시간 정보를 사용합니다. 따라서 잘못된 TZ 값은 미디어 재생 자체가 정상적으로 작동하더라도 서버가 혼란스럽게 보이게 할 수 있습니다.
변수를 변경한 후 예약된 작업의 타임스탬프나 최근 로그 항목을 하나 이상 확인하여 브라우저뿐 아니라 컨테이너 자체에서도 의도한 시간대를 인식하는지 확인합니다.
Jellyfin 시간대 FAQ
TZ를 변경하면 원문 사용자의 문제가 해결되었나요?
예. 사용자는 문제가 해결되었다고 명시적으로 답변했습니다.
값을 EST 또는 PST로 설정해야 하나요?
일광 절약 시간제 규칙이 올바르게 처리되도록 America/New_York 또는 America/Los_Angeles와 같은 IANA 지역을 사용하세요.
시간대 문제를 해결하려면 Jellyfin 포트 또는 GPU 설정을 변경해야 하나요?
아니요. 해당 설정은 TZ 환경 변수와 별개입니다.
