Jellyfin Reverse Proxy Setup Guide Using Nginx Proxy Manager

Jellyfin과 Nginx Proxy Manager 연동 - 최적의 프록시 및 캐시 설정 가이드 미디어 서버를 구축할 때 Jellyfin과 Nginx Proxy Manager(NPM) 조합은 강력한 리버스 프록시 환경을 제공합니다.

하지만, 실시간 UI 반영과 스트리밍 성능을 위해서는 몇 가지 중요한 설정을 반드시 확인해야 합니다.

이 글에서는 Jellyfin과 NPM 연동 시 Cache Assets 옵션과 관련된 실전 팁을 정리합니다.

NPM세팅

Details

forward Port 는 사용자에 따라 다릅니다.

!Cache Assets는 반드시 off.
이유 : Jellyfin은 미디어 라이브러리, 썸네일, UI 등 자주 변경되는 자산이 많아, 캐싱이 오히려 문제를 유발할 수 있습니다.

예: '시청 완료' 표시, 새 미디어 추가 등 UI가 즉시 반영되지 않음.

일부 클라이언트(Infuse 등)에서 스트리밍/버퍼링 문제 발생.
Cache Assets 옵션이 활성화되면 Jellyfin UI가 실시간으로 갱신되지 않거나, 스트리밍/트랜스코딩에 문제가 발생할 수 있습니다.

SSL

Advanced

proxy_buffering off;

강제로 cache assets를 off

cache assets disable 했는데 적용이 안된다 Advanced tab에서 아래의 내용추가

# --- 타임아웃 설정 ---
proxy_connect_timeout 300s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;

# --- 캐시 완전 비활성화 ---
proxy_no_cache 1;
proxy_cache_bypass 1;


# --- 스트리밍 성능 향상 ---
proxy_buffering off;
proxy_request_buffering off;
proxy_max_temp_file_size 0;

# --- 대용량 파일 업로드 지원 ---
client_max_body_size 0;