Jellyfin에서 HDR 콘텐츠를 재생할 때 분홍색, 녹색 또는 크게 왜곡된 색상이 나타나는 경우는 대개 서버가 HDR 또는 Dolby Vision 콘텐츠를 트랜스코딩하고 있지만 톤 매핑 경로가 제대로 작동하지 않는다는 의미입니다. 2025년 2월 IceWhale 커뮤니티 스레드에서는 Jellyfin 하드웨어 가속이 활성화된 Intel N100 및 16GB RAM 탑재 ZimaCube에서 이 문제가 발생했습니다.
IceWhale 팀원은 톤 매핑이 정상적으로 작동하는 것을 재현하고 소스가 Dolby Vision임을 확인했으며, 당시 ZimaOS App Store에서 제공되던 Jellyfin 버전에 색상 변환 문제가 있는 것으로 보인다고 설명했습니다. 커뮤니티에서 제시한 해결 방법은 Intel Quick Sync Video 설정과 함께 다른 Jellyfin 컨테이너 이미지를 사용하는 것이었습니다. 원 게시자는 나중에 이 방법으로 문제가 해결되었다고 확인했습니다. 따라서 이 스레드는 유용하지만, 정확한 컨테이너 이미지와 스크린샷은 과거 자료입니다. 정상적으로 작동하는 최신 App Store 설치본을 교체하기 전에 현재 Jellyfin 릴리스와 하드웨어 가속 지침을 확인해야 합니다.
Jellyfin HDR 화면이 분홍색이나 녹색으로 변하는 이유
원래 보고된 문제는 하드웨어 가속과 톤 매핑이 관련된 경우에만 HDR 콘텐츠가 분홍색이나 녹색 화면으로 표시되는 것이었습니다. 소스 형식을 확인한 후 IceWhale의 답변에서는 해당 파일이 일반적인 SDR 비디오가 아니라 Dolby Vision 콘텐츠라고 결론 내렸습니다.
HDR-SDR 재생은 단일 작업이 아닙니다. Jellyfin은 다음 작업이 필요할 수 있습니다.
- 10비트 HEVC 또는 Dolby Vision 소스를 디코딩합니다.
- HDR 또는 Dolby Vision 색상 정보를 SDR 출력으로 변환합니다.
- 비디오 크기를 조정하거나 자막을 추가합니다.
- 재생 장치가 지원하는 형식으로 결과를 인코딩합니다.
GPU 디코딩 단계는 정상적으로 작동하더라도 톤 매핑 런타임, 드라이버 또는 컨테이너 이미지에 문제가 있으면 스트림은 재생되면서도 색상이 눈에 띄게 잘못 표시될 수 있습니다.
2025년형 ZimaCube N100 케이스
커뮤니티 테스트 시스템은 Intel N100 프로세서와 16GB RAM을 탑재한 ZimaCube였습니다. 이 하드웨어 세부 정보가 중요한 이유는 Intel 통합 GPU가 하드웨어 비디오 디코딩을 지원하지만, 성능과 소프트웨어 지원은 코덱, 톤 매핑 방식, 커널, 드라이버, Jellyfin FFmpeg 빌드에 따라 달라지기 때문입니다.
기존 ZimaCube 제품군을 위한 현재 가장 자연스러운 제품 경로는 현재 ZimaCube 2 개인용 클라우드 NAS입니다. 현재 하드웨어 구성이 이 2025년 커뮤니티 테스트에 사용된 N100 시스템과 동일하다고 가정하지 마세요.
커뮤니티에서 공유된 Intel QSV 설정
커뮤니티에서 검증된 설정에서는 Jellyfin 하드웨어 가속 방식으로 Intel QuickSync (QSV)을 선택했습니다. 스크린샷에는 일반적인 코덱의 하드웨어 디코딩이 활성화되어 있었고, Intel 저전력 H.264 인코딩도 활성화되어 있었습니다.
모든 코덱 체크박스를 무작정 선택하지 마세요. 현재 Jellyfin의 Intel GPU 하드웨어 가속 가이드에서는 설치된 GPU가 실제로 디코딩할 수 있는 코덱만 활성화할 것을 권장합니다. 또한 현재 Jellyfin은 모니터가 연결되지 않은 헤드리스 Linux 시스템에서도 Intel QSV와 VA-API를 사용할 수 있다고 안내합니다.
올바른 톤 매핑 방법 활성화
두 번째 커뮤니티 스크린샷에서는 해당 구성에서 Jellyfin의 톤 매핑 기능이 활성화되어 있었고 VPP 톤 매핑은 비활성화된 상태였습니다.
현재 Jellyfin 문서에서는 지원되는 시스템에서 Intel 톤 매핑을 사용하는 두 가지 주요 경로를 설명합니다.
- OpenCL 톤 매핑: Dolby Vision 프로필 5를 지원하고 세부적인 조정이 가능하지만, Linux에서는 OpenCL 런타임을 수동으로 설치해야 할 수 있습니다.
- QSV VPP 톤 매핑: 전력 소비가 적고 고정 기능 하드웨어를 사용할 수 있지만, 지원하는 GPU 모델이 적고 조정 옵션도 제한적입니다.
Jellyfin은 하드웨어 가속 HDR 및 Dolby Vision의 SDR 톤 매핑을 사용하려면 10비트 HEVC 디코딩이 가능한 GPU가 필요하다고도 설명합니다. 사용 가능한 두 가지 톤 매핑 방법을 모두 활성화하면 Jellyfin이 지원되는 HDR10 워크플로에서 VPP를 우선 사용할 수 있으므로, 정확한 조합은 소스 형식과 GPU에 맞춰야 합니다.
Dolby Vision에는 기본 디코더 옵션이 필요할 수 있습니다
현재 Jellyfin Intel 문서에는 2025년 스크린샷에서 놓치기 쉬웠던 세부 사항이 추가되어 있습니다. Dolby Vision을 지원하려면 해당 Intel 워크플로에서 OS 기본 DXVA 또는 VA-API 하드웨어 디코더 선호 옵션을 활성화해야 합니다.
일반 HDR10 톤 매핑은 작동하지만 Dolby Vision에서 여전히 색상이 잘못 표시된다면 다음을 확인하세요.
- 파일에 실제로 지원되는 Dolby Vision 프로필이 포함되어 있습니다.
- GPU가 10비트 HEVC 디코딩을 지원합니다.
- 현재 Jellyfin FFmpeg 빌드가 사용되고 있습니다.
- Intel 미디어 드라이버와 OpenCL 런타임을 컨테이너 내부에서 사용할 수 있습니다.
- 현재 Jellyfin 지침에서 요구하는 기본 디코더 우선 사용 옵션이 활성화되어 있습니다.
ZimaOS 앱 스토어 이미지 문제는 2025년에만 해당하는 발견이었습니다
2025년 2월 28일, IceWhale 팀원은 당시 ZimaOS 앱 스토어에서 제공되던 Jellyfin 버전에 색상 톤 변환 문제가 있는 것으로 보인다며 다음을 권장했습니다. nyanmisaka/jellyfin 제공된 사용자 지정 설치 YAML 파일과 함께 Docker 이미지를 사용했습니다.
첨부된 과거 구성은 다음과 같았습니다.
원래 커뮤니티 답변에서 공유된 Jellyfin.yaml.
이 권장 사항은 원래 사용자의 문제를 해결했지만, 이를 “현재 ZimaOS Jellyfin 앱 스토어 패키지가 고장 났다”라고 일반화해서는 안 됩니다. 2025년 2월 이후 컨테이너 이미지, Jellyfin FFmpeg, Intel 드라이버, ZimaOS 앱 정의가 변경되었습니다. 현재 설치 환경에서는 컨테이너를 교체하기 전에 최신 패키지와 로그를 통해 문제를 확인하세요.
하드웨어 가속이 실제로 작동하는지 확인하는 방법
하드웨어 가속 드롭다운만 보고 판단하지 마세요. 트랜스코딩을 시작한 뒤 Jellyfin의 재생 정보 또는 FFmpeg 트랜스코딩 로그를 확인하세요. 하드웨어 디코딩, 톤 매핑 필터, 하드웨어 인코딩이 모두 예상대로 사용되고 있는지 확인해야 합니다.
현재 Jellyfin 문서에서는 번들로 제공되는 jellyfin-ffmpegJellyfin에서 예상하는 패치와 GPU 통합이 포함되어 있습니다. 하드웨어 파이프라인이 부분적으로만 작동하면 비용이 큰 한 단계가 CPU에서 처리되어 대시보드에서 QSV를 선택했더라도 성능이 저하될 수 있습니다.
성공적인 재생은 어떤 모습이었나
IceWhale의 답변에는 이미지를 변경하고 QSV 설정을 적용한 후의 Dolby Vision 재생 결과가 공유되었습니다. 재생 정보에는 다이렉트 플레이가 아닌 트랜스코딩이 활성화된 것으로 표시되었습니다.
IceWhale 테스터는 N100의 내장 그래픽이 그다지 강력하지 않으며, 해당 설정에서는 약 4K 30fps 이하에서만 Dolby Vision 변환이 원활했다고 덧붙였습니다. 이는 모든 파일, 비트레이트, 자막 유형 또는 현재 Jellyfin 릴리스에 보장되는 성능 사양이 아니라, 과거의 한 테스트 결과로 받아들여야 합니다.
Jellyfin을 탓하기 전에 현재 Intel 드라이버 및 커널 문제를 확인하세요
Jellyfin의 현재 알려진 문제 문서에는 Intel Linux의 여러 특수 사례가 기록되어 있습니다. 드라이버 또는 커널 버그가 톤 매핑과 저전력 인코딩에 영향을 줄 수 있으며, 일부 플랫폼에서는 더 최신 펌웨어나 커널이 필요합니다. 최신 Jellyfin 이미지에서도 현재 설치 환경의 색상이 잘못 표시된다면 Jellyfin 하드웨어 가속 알려진 문제 페이지를 확인하세요.
정상적으로 작동하는 NAS에서 커널, 펌웨어 또는 GPU 드라이버를 무분별하게 업그레이드하지 마세요. 중요한 데이터를 백업하고, 해결하려는 문제가 문서에 명시된 플랫폼 및 버전 범위와 실제로 일치하는지 확인하세요.
Jellyfin HDR 톤 매핑 문제 해결 체크리스트
- 문제가 직접 재생이 아니라 트랜스코딩 중에만 발생하는지 확인하세요.
- 소스가 HDR10, HLG 또는 Dolby Vision인지 확인하세요.
- Intel GPU가 소스 코덱과 비트 심도를 디코딩할 수 있는지 확인하세요.
- 현재 Jellyfin FFmpeg 빌드와 최신 컨테이너 패키지를 사용하세요.
- Intel QSV 또는 호스트에 적합한 가속 방식을 선택하세요.
- 필요한 Intel 미디어 및 OpenCL 런타임에 컨테이너 내부에서 액세스할 수 있는지 확인하세요.
- 소스에 적합한 현재 Jellyfin 톤 매핑 옵션을 활성화하세요.
- Dolby Vision의 경우 Jellyfin의 현재 기본 디코더 요구 사항을 확인하세요.
- 테스트 트랜스코딩을 하나 시작하고 FFmpeg 로그를 확인하세요.
- 현재 ZimaOS 패키지에서 과거의 이미지 문제가 재현되는 경우에만 Jellyfin 구성을 백업한 후 사용자 지정 컨테이너를 고려하세요.
ZimaOS의 Jellyfin HDR 톤 매핑 FAQ
Jellyfin HDR 영상이 분홍색 또는 녹색으로 표시되는 이유는 무엇인가요?
커뮤니티 사례에서는 문제가 발생한 파일이 Dolby Vision이었고, 하드웨어 톤 변환 경로에서 문제가 발생했습니다. 드라이버, FFmpeg, OpenCL 또는 컨테이너 이미지 문제로도 유사한 증상이 나타날 수 있으므로, 2025년의 원인이 동일하다고 가정하기 전에 현재 트랜스코딩 로그를 확인하세요.
Intel QSV와 VA-API 중 어느 것을 사용해야 하나요?
현재 Linux용 Intel 하드웨어에서 Jellyfin은 두 방식 모두 지원합니다. 커뮤니티 수정 방법은 QSV를 사용했습니다. 최적의 선택은 GPU 세대, 드라이버 스택, Jellyfin 릴리스 및 특정 톤 매핑 경로가 필요한지 여부에 따라 달라집니다.
VPP 톤 매핑과 OpenCL 톤 매핑 중 어느 것을 활성화해야 하나요?
현재 Jellyfin은 일부 Intel 하드웨어에서 두 방식 모두 지원합니다. OpenCL은 Dolby Vision 지원 범위가 더 넓고 조정 옵션도 많으며, VPP는 전력 효율이 더 높을 수 있지만 하드웨어와 형식 제약이 더 큽니다.
그래도 nyanmisaka/jellyfin 이미지를 사용해야 하나요?
자동으로 되지는 않습니다. 이는 2025년 2월의 특정 ZimaOS App Store 사례에서 사용된 권장 방법이었습니다. 앱 이미지와 Jellyfin 하드웨어 가속 스택이 변경되었을 수 있으므로, 먼저 현재 ZimaOS Jellyfin 패키지에서 테스트하세요.
Intel N100에서 4K Dolby Vision을 톤 매핑할 수 있나요?
IceWhale 커뮤니티 테스터는 자신의 구성에서 4K 30fps 이하의 원활한 변환을 확인했습니다. 실제 성능은 비트레이트, 코덱 프로필, 자막, 출력 형식, 메모리 대역폭, 열 제한 및 현재 소프트웨어에 따라 달라지므로, 해당 결과는 보장이라기보다 참고 자료로 보세요.
