Jellyfin(https://jellyfin.org) 직접 서버를 돌리는 구조와 첫 설정 순서

Jellyfin 구조 — 공식 서버 없이 직접 돌립니다

Jellyfin을 처음 찾는 사람이 가장 많이 헷갈리는 것은 구조입니다. 공식 사이트 첫 화면에는 '사용자를 위한 서버를 운영하지 않는다'고 적혀 있습니다.

즉 Jellyfin은 콘텐츠를 제공하는 서비스가 아니라, 내가 이미 가진 파일을 정리해 다른 기기로 보내 주는 서버 프로그램입니다.

공식 문서는 Jellyfin이 인터넷과 무관하게 돌아가고, 서버를 인터넷에 공개할 필요도 없다고 설명합니다. 다만 포스터·줄거리 같은 메타데이터는 외부 제공처에서 받아 오기 때문에 인터넷이 없으면 받지 못합니다.

Jellyfin은 자원봉사자가 만드는 프로젝트입니다. 공식 FAQ는 정해진 출시 일정이 없고, 원하는 기능도 만들 사람이 나타나야 구현된다고 답합니다. 기부금은 서버 등 인프라에만 쓰고 개발자는 원칙적으로 무급이라고 적혀 있습니다.

Jellyfin 운영체제별 설치와 설정 마법사

운영체제별 설치 방법은 공식 설치 안내에 나뉘어 있습니다.

• Windows — 설치 파일 실행 · 서비스로 설치는 비권장
• Windows 업데이트 — 트레이 앱에서 종료 후 새 설치 파일 실행
• Windows 제거 — 설정 → 앱 추가/제거에서 Jellyfin 제거
• macOS — DMG의 앱을 응용 프로그램 폴더로 → 메뉴 막대 아이콘 → Launch
• macOS 14 미만 ARM Mac — macOS를 올리거나 x86판 사용
• 첫 접속 주소 — http://내부IP:8096

설치 뒤 브라우저로 접속하면 설정 마법사가 열립니다.

1. 언어 선택 — 지금 쓰는 클라이언트에만 적용되고, 서버 전체 언어는 나중에 정합니다.
2. 관리자 계정 — 서버를 관리할 계정을 만듭니다. 사용자는 나중에 더 만들 수 있습니다.
3. 미디어 라이브러리 — +를 눌러 콘텐츠 유형(영화·프로그램·음악 등)과 표시 이름을 정하고 폴더를 고릅니다. 건너뛰고 나중에 추가해도 됩니다.
4. 메타데이터 언어·지역 — 서버 기본값이며 라이브러리마다 바꿀 수 있습니다.
5. 네트워크 — 공식 문서는 원격 접속 허용은 켜고, 자동 포트 매핑(UPnP)은 꼭 필요할 때가 아니면 끄라고 권합니다.

라이브러리를 추가할 때 미디어 폴더가 목록에 안 보이면 권한 문제일 수 있다고 공식 안내에 적혀 있습니다.

Jellyfin 영화·드라마 파일 이름 규칙

미디어가 라이브러리에 안 나오는 원인으로 공식 FAQ는 파일 권한과 폴더 구성을 꼽습니다. 파일 이름 규칙은 이렇습니다.

• 영화 폴더 — 영화마다 폴더 · '영화 이름 (연도) [메타데이터 ID]'
• 영화 파일 — 폴더 이름과 같게, 예: Jellyfin Documentary (2030).mkv
• 드라마 구조 — 시리즈 폴더 → Season 01 → 회차 파일
• 회차 파일 — 시리즈 이름 S01E01.mkv
• 특별편 — Season 00 폴더
• 쓰면 안 되는 문자 — < > : " / \ | ? *

연도와 메타데이터 ID는 선택 사항이지만 넣으면 인식이 정확해집니다. 자막은 영화 파일과 같은 이름에 언어 표시를 붙여(.en_us.srt 형식) 같은 폴더에 둡니다.

파일 하나에 두 회차가 들어 있으면 'S01E01-E02'로 적을 수 있지만 목록에는 한 항목으로 보입니다. 공식 문서는 회차별로 파일을 나누라고 권합니다.

ISO 같은 디스크 이미지는 재생은 되지만 지원 대상이 아닙니다. 공식 문서는 mkv로 다시 담거나 VIDEO_TS·BDMV 폴더로 풀어 두라고 안내합니다. VIDEO_TS·BDMV 폴더는 여러 버전, 여러 부분, 외부 자막·음성 트랙을 지원하지 않습니다.

Jellyfin 서버 사양과 트랜스코딩

공식 하드웨어 안내가 권하는 사양입니다. 사양이 낮아도 돌아가지만 쾌적하게 쓰기 위한 기준입니다.

• 저장장치 — 운영체제·Jellyfin·변환 캐시용 SSD 100GB
• 메모리 — 8GB (화면 없는 Linux 서버는 4GB도 가능)
• 네트워크 — 기가비트 유선 · 무선·전력선 통신 비권장
• 원격용 인터넷 — 업로드 20Mbps 이상
• 그래픽(GPU) — 없는 서버는 비권장
• 옛 x86 CPU — 10.11부터 SSE4.1 지원 필수

그래픽 칩이 중요한 이유는 트랜스코딩 때문입니다. 받는 기기가 원본 형식을 재생하지 못하면 서버가 실시간으로 변환해 보내는데, CPU로만 하면 부하가 매우 큽니다. 공식 문서는 HDR 영상을 SDR로 바꾸는 작업은 최신 데스크톱 CPU로도 실시간이 안 될 수 있다고 적고 있습니다.

재생 방식은 서버 부하가 낮은 순서로 네 가지이며, 재생 중 대시보드에 표시됩니다.

1. Direct Play — 변환 없이 원본 그대로 전송
2. Remux — 영상·음성은 그대로, 담는 형식만 변경
3. Direct Stream — 음성만 변환
4. Transcode — 영상까지 변환

해상도는 원본과 받는 기기 조건에 따라 정해지며 수동으로 바꿀 수 없습니다. 공식 안내는 완제품 NAS와 대부분의 싱글보드 컴퓨터는 하드웨어 가속 지원이 부족해 느리다고 적고 있습니다. 업로드 속도가 100Mbps 미만이면 Jellyfin 대역폭을 업로드 속도의 70%로 제한하라고 권합니다.

Jellyfin 원격 접속과 포트

집 밖에서 보려면 서버를 직접 인터넷에 연결해야 합니다. 공식 서버가 없으니 Jellyfin이 대신 해 주지 않습니다.

• 8096/TCP — 기본 HTTP · 웹 화면
• 8920/TCP — HTTPS · 기본은 사용 안 함
• 7359/UDP — 같은 네트워크 클라이언트 탐색 · 변경 불가
• 로컬 네트워크 범위 — 네트워킹 → Local Networks에 CIDR로 입력
• 사용자별 원격 허용 — 사용자 편집 → 원격 연결 허용
• 인증서 — 자체 서명 인증서는 강하게 비권장

공식 문서가 소개하는 원격 접속 방법은 다음과 같습니다.

• 포트를 인터넷에 바로 여는 방식 — 권하지 않음
• 리버스 프록시를 거치는 방식
• VPN으로 집 네트워크에 들어오는 방식
• 가상 서버(VPS)에서 집 네트워크로 리버스 프록시하는 방식

공식 문서는 포트를 하나 열면 그 포트가 위쪽 네트워크 전체에 열리는 것이라 인터넷에 직접 여는 것은 안전하지 않다고 설명합니다. HTTPS를 쓸 때도 Jellyfin 안에서 처리하기보다 리버스 프록시에서 처리하라고 강하게 권합니다.

원격 접속 제한이 제대로 동작하려면 Jellyfin이 어떤 IP 범위를 집 안 네트워크로 볼지 알아야 합니다. 같은 네트워크 기기 자동 탐색(7359/UDP)은 집 안에서만 동작하며 외부에 열면 안 됩니다.

Jellyfin 12.0 업그레이드와 Quick Connect

GitHub 릴리스 기준으로 2026년 9월 8일 12.0이 나왔고, 10월 5일 12.2까지 나왔습니다. 12.0은 데이터베이스가 바뀌어 업그레이드 뒤 되돌릴 수 없습니다.

• 업그레이드 전 — 데이터 폴더 전체 백업 강력 권장
• 바로 업그레이드 — 10.10.7, 10.11.x에서 가능
• 10.10.7 미만 — 10.10.7로 먼저 올린 뒤 12.0
• 추가 설치 플러그인 — 이전 전에 제거, 이후 다시 추가
• 업그레이드 뒤 — 전체 라이브러리 스캔 필수
• 중단된 패키지 — Debian Bullseye, Ubuntu Focal

12.0 릴리스 노트에 따르면 자동으로 묶였던 영화의 다른 버전이 데이터 형식 문제로 지워지기 때문에 전체 스캔으로 다시 찾아야 하고, 첫 스캔은 평소보다 훨씬 오래 걸리며 일부 영화가 새로 추가된 것처럼 보일 수 있습니다. 플러그인 저장소를 불안정판으로 바꿨다면 대시보드 → 플러그인 → 저장소 관리에서 안정판 주소로 되돌리라고 안내합니다.

TV처럼 글자 입력이 불편한 기기는 Quick Connect로 로그인합니다. 서버에서 기본으로 켜져 있습니다.

1. 새 기기의 Jellyfin 로그인 화면에서 Quick Connect를 고릅니다(일부 앱은 수동 로그인을 먼저 누름).
2. 화면에 나온 6자리 코드를 띄워 둡니다.
3. 이미 로그인된 기기에서 설정 → Quick Connect에 그 코드를 넣고 확인합니다.
4. 새 기기가 아이디·비밀번호 없이 로그인됩니다. 코드가 틀리거나 만료되면 다시 합니다.