Jellyfin(https://jellyfin.org) 직접 서버를 돌리는 구조와 첫 설정 순서
Jellyfin(https://jellyfin.org) 직접 서버를 자세히 보기 >
Jellyfin은 내 PC나 서버를 미디어 서버로 만들어 내가 가진 영상과 음악을 여러 기기로 스트리밍하는 무료 오픈소스 프로그램입니다. 아래에서 직접 서버를 돌려야 하는 구조, 운영체제별 설치와 설정 마법사, 영화·드라마 파일 이름 규칙, 서버 사양, 원격 접속과 포트, 12.0 업그레이드 주의점까지 공식 문서 기준으로 정리했습니다.
체크 포인트
공식 서버는 없습니다 — 내 PC나 서버에 직접 설치해야 합니다 · 파일 이름 규칙이 인식을 좌우 — 영화마다 폴더, 드라마는 Season 01·S01E01 · 12.0은 되돌릴 수 없음 — 업그레이드 전 데이터 폴더 전체 백업
Jellyfin 구조 — 공식 서버 없이 직접 돌립니다
Jellyfin을 처음 찾는 사람이 가장 많이 헷갈리는 것은 구조입니다. 공식 사이트 첫 화면에는 ‘사용자를 위한 서버를 운영하지 않는다’고 적혀 있습니다.
| 구분 | 내용 |
|---|---|
| 서버 | 내 PC·서버에 직접 설치해 실행 |
| 공식 서버·계정 | 없음 |
| 볼 수 있는 것 | 내가 가진 영화·드라마·음악·책·사진 |
| 추가 기능 | 실시간 TV·녹화, 함께 보기(SyncPlay) |
| 보는 기기 | 브라우저 또는 클라이언트 앱 |
| 비용 | 무료 · 오픈소스 |
즉 Jellyfin은 콘텐츠를 제공하는 서비스가 아니라, 내가 이미 가진 파일을 정리해 다른 기기로 보내 주는 서버 프로그램입니다.
공식 문서는 Jellyfin이 인터넷과 무관하게 돌아가고, 서버를 인터넷에 공개할 필요도 없다고 설명합니다. 다만 포스터·줄거리 같은 메타데이터는 외부 제공처에서 받아 오기 때문에 인터넷이 없으면 받지 못합니다.
Jellyfin은 자원봉사자가 만드는 프로젝트입니다. 공식 FAQ는 정해진 출시 일정이 없고, 원하는 기능도 만들 사람이 나타나야 구현된다고 답합니다. 기부금은 서버 등 인프라에만 쓰고 개발자는 원칙적으로 무급이라고 적혀 있습니다.
Jellyfin 운영체제별 설치와 설정 마법사
운영체제별 설치 방법은 공식 설치 안내에 나뉘어 있습니다.
| 구분 | 내용 |
|---|---|
| Windows | 설치 파일 실행 · 서비스로 설치는 비권장 |
| Windows 업데이트 | 트레이 앱에서 종료 후 새 설치 파일 실행 |
| Windows 제거 | 설정 → 앱 추가/제거에서 Jellyfin 제거 |
| macOS | DMG의 앱을 응용 프로그램 폴더로 → 메뉴 막대 아이콘 → Launch |
| macOS 14 미만 ARM Mac | macOS를 올리거나 x86판 사용 |
| 첫 접속 주소 | http://내부IP:8096 |
설치 뒤 브라우저로 접속하면 설정 마법사가 열립니다.
- 언어 선택 — 지금 쓰는 클라이언트에만 적용되고, 서버 전체 언어는 나중에 정합니다.
- 관리자 계정 — 서버를 관리할 계정을 만듭니다. 사용자는 나중에 더 만들 수 있습니다.
- 미디어 라이브러리 — +를 눌러 콘텐츠 유형(영화·프로그램·음악 등)과 표시 이름을 정하고 폴더를 고릅니다. 건너뛰고 나중에 추가해도 됩니다.
- 메타데이터 언어·지역 — 서버 기본값이며 라이브러리마다 바꿀 수 있습니다.
- 네트워크 — 공식 문서는 원격 접속 허용은 켜고, 자동 포트 매핑(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로도 실시간이 안 될 수 있다고 적고 있습니다.
재생 방식은 서버 부하가 낮은 순서로 네 가지이며, 재생 중 대시보드에 표시됩니다.
- Direct Play — 변환 없이 원본 그대로 전송
- Remux — 영상·음성은 그대로, 담는 형식만 변경
- Direct Stream — 음성만 변환
- 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로 로그인합니다. 서버에서 기본으로 켜져 있습니다.
- 새 기기의 Jellyfin 로그인 화면에서 Quick Connect를 고릅니다(일부 앱은 수동 로그인을 먼저 누름).
- 화면에 나온 6자리 코드를 띄워 둡니다.
- 이미 로그인된 기기에서 설정 → Quick Connect에 그 코드를 넣고 확인합니다.
- 새 기기가 아이디·비밀번호 없이 로그인됩니다. 코드가 틀리거나 만료되면 다시 합니다.
Jellyfin 자주 묻는 질문
Q. Jellyfin은 가입하면 바로 볼 수 있는 서비스인가요?
아닙니다. 공식 사이트는 사용자를 위한 서버를 운영하지 않는다고 적고 있습니다. 내 PC나 서버에 Jellyfin 서버를 직접 설치하고, 내가 가진 영상·음악 파일을 라이브러리로 추가해 다른 기기에서 보는 방식입니다.
Q. Jellyfin에 넣은 영화가 목록에 안 나와요.
공식 FAQ는 대개 파일 권한 문제이거나 폴더 구성이 규칙과 다른 경우라고 답합니다. 영화는 영화마다 ‘영화 이름 (연도)’ 폴더를 만들고 파일 이름을 폴더 이름과 같게 맞춥니다. 드라마는 시리즈 폴더 → Season 01 → S01E01 형식입니다.
Q. Jellyfin 첫 접속 주소는 무엇인가요?
서버를 설치한 뒤 브라우저에서 http://서버의 내부IP:8096 으로 접속합니다. 8096/TCP가 기본 HTTP 포트이고, HTTPS용 8920/TCP는 기본으로 쓰지 않습니다.
Q. Jellyfin 12.0으로 업그레이드할 때 주의할 점은?
데이터베이스가 바뀌어 되돌릴 수 없으므로 업그레이드 전에 데이터 폴더 전체를 백업합니다. 10.10.7·10.11.x에서는 바로 올라가고 그보다 옛 버전은 10.10.7을 먼저 거칩니다. 업그레이드 뒤에는 전체 라이브러리 스캔이 필수입니다.
Q. Jellyfin 서버에 그래픽카드가 꼭 있어야 하나요?
공식 하드웨어 안내는 그래픽 칩 없는 서버를 권하지 않습니다. 기기가 재생하지 못하는 형식을 실시간으로 변환할 때 CPU만으로는 부하가 매우 크고, HDR을 SDR로 바꾸는 작업은 최신 CPU로도 실시간이 안 될 수 있다고 적고 있습니다.
Jellyfin을 시작하기 전에 먼저 알아 둘 것은 공식 서버가 없다는 점입니다. 내 PC나 서버에 직접 설치하고, 내가 가진 영상과 음악을 라이브러리로 추가해 다른 기기에서 봅니다. 설치 뒤 http://내부IP:8096 에 접속해 설정 마법사에서 관리자 계정과 라이브러리를 만들고, 자동 포트 매핑은 공식 권고대로 끕니다. 미디어가 안 보이면 파일 권한과 이름 규칙부터 확인합니다. 영화는 영화마다 폴더, 드라마는 Season 01과 S01E01 형식입니다. 집 밖에서 보려면 포트를 바로 열지 말고 리버스 프록시나 VPN을 쓰라고 공식 문서는 권합니다. 12.0으로 올릴 때는 데이터 폴더 전체를 백업하고, 올린 뒤 전체 라이브러리 스캔을 합니다.