Медиасервер Jellyfin на Ubuntu 24.04: пошаговая установка

MAATRIX

Медиасервер Jellyfin превращает обычный сервер в личный Netflix: фильмы, сериалы, музыка и фото доступны с любого устройства через браузер или приложение, без подписок и слежки. В отличие от Plex, Jellyfin полностью бесплатен и не требует облачного аккаунта — всё живёт на вашем сервере. Ниже пошаговая установка медиасервера Jellyfin на Ubuntu 24.04 с настройкой библиотек, доступом по HTTPS и разбором транскодинга.

Почему Jellyfin и что важно знать заранее

Jellyfin — форк старого Emby, полностью открытый и без платных функций. Вы получаете красивый интерфейс, поддержку клиентов под все платформы, автоматическое скачивание обложек и описаний, профили пользователей с родительским контролем — и всё это без единого рубля подписки. Для тех, кто устал от того, что стриминги то добавляют, то убирают контент, свой медиасервер это возвращение контроля над собственной коллекцией.

Есть важный технический нюанс, который стоит понять до установки: раздача видео бывает двух видов. Direct Play, когда клиент проигрывает файл как есть, почти не грузит сервер. И транскодинг, когда сервер на лету перекодирует видео под возможности клиента или ширину канала — вот это уже тяжёлая работа для процессора. Если вы планируете смотреть тяжёлые 4K-фильмы на слабых устройствах или отдавать поток через узкий канал, транскодинг неизбежен, и к железу будут требования. Об этом честно поговорим в отдельном разделе.

Требования к серверу под Jellyfin

Сам Jellyfin нетребователен: интерфейс, каталогизация и Direct Play спокойно работают на VPS с 2 ядрами и 2 ГБ RAM. Диск нужен под вашу медиатеку — здесь всё зависит от объёма коллекции, и место стоит брать с запасом. Для домашней библиотеки часто хватает сотни-другой гигабайт, для серьёзной коллекции в 4K счёт идёт на терабайты.

А вот транскодинг меняет картину. Программное перекодирование одного 1080p-потока съедает несколько ядер целиком, а 4K может не потянуть и мощный процессор. Поэтому если транскодинг вам нужен, честный выбор — либо брать сервер с производительным CPU и большим числом ядер, либо сервер с аппаратным ускорением на видеокарте, которое снимает нагрузку с процессора. Для одного-двух зрителей с Direct Play подойдёт скромный VPS, для нескольких параллельных транскодируемых потоков нужна серьёзная конфигурация.

Установка Jellyfin из официального репозитория

На Ubuntu 24.04 правильный способ — подключить официальный репозиторий Jellyfin, а не ставить из случайных deb-пакетов. Так вы будете получать обновления штатно через apt. Разработчики предоставляют скрипт, который добавляет репозиторий и ключ, но безопаснее сделать это осознанно вручную.

apt update && apt install -y curl gnupg
mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key \
  | gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg

Затем добавьте запись репозитория для вашего релиза Ubuntu и установите пакеты сервера. После установки служба запустится автоматически и будет слушать порт 8096.

apt update
apt install -y jellyfin
systemctl enable --now jellyfin
systemctl status jellyfin

Проверьте, что сервис поднялся, и откройте в браузере адрес вашего сервера с портом 8096 — вас встретит мастер первичной настройки. На этом этапе создаётся администратор и подключаются первые библиотеки.

Первичная настройка и подключение библиотек

Мастер проведёт через несколько шагов: язык интерфейса, создание учётной записи администратора с надёжным паролем, добавление медиатек. Библиотека в Jellyfin — это папка на диске с определённым типом контента: Фильмы, Сериалы, Музыка. Заранее разложите файлы по каталогам с понятными именами, потому что Jellyfin распознаёт метаданные по названиям файлов и папок.

mkdir -p /srv/media/movies /srv/media/tvshows /srv/media/music
chown -R jellyfin:jellyfin /srv/media

Права здесь критичны: служба работает от пользователя jellyfin, и если у неё нет доступа к каталогам с медиа, библиотека просто останется пустой без внятной ошибки. Для фильмов придерживайтесь схемы именования, где в названии файла есть год в скобках — так система точно найдёт правильную обложку и описание. Для сериалов раскладывайте по папкам сезонов. После добавления библиотеки Jellyfin запустит сканирование и подтянет метаданные из открытых источников автоматически.

Доступ по HTTPS через Nginx

Держать медиасервер открытым по голому HTTP на порту 8096 небезопасно — пароли и токены пойдут по сети незашифрованными. Поставьте перед Jellyfin обратный прокси Nginx с сертификатом Let's Encrypt. Направьте домен на IP сервера, установите Nginx и certbot, затем настройте проксирование.

apt install -y nginx certbot python3-certbot-nginx

В конфиге сайта пропишите проксирование на локальный порт Jellyfin с поддержкой веб-сокетов — они нужны для корректной работы интерфейса и синхронизации воспроизведения.

location / {
    proxy_pass http://127.0.0.1:8096;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

Получите сертификат командой certbot с указанием вашего домена, и после этого медиасервер будет доступен по HTTPS. Не забудьте, что автопродление сертификата уже настроено таймером systemd — проверьте это командой пробного продления, чтобы через три месяца доступ внезапно не отвалился.

Транскодинг и аппаратное ускорение

Если Jellyfin при воспроизведении начинает нагружать процессор до потолка и видео тормозит — включился программный транскодинг. Первое, что стоит сделать, — по возможности избегать его: держите файлы в форматах, которые клиенты проигрывают напрямую, тогда сервер только отдаёт данные и почти не нагружается. Но полностью уйти от транскодинга не всегда получается.

Когда транскодинг неизбежен, спасает аппаратное ускорение. Jellyfin умеет перекладывать перекодирование на видеокарту через VAAPI для встроенной графики Intel, NVENC для карт NVIDIA или QSV. Это снимает нагрузку с CPU в разы: то, что программно грузит восемь ядер, аппаратно тянет один поток почти незаметно. Включается ускорение в настройках сервера в разделе воспроизведения, но требует, чтобы на сервере была подходящая видеокарта и установлены драйверы.

Здесь и появляется момент честного выбора конфигурации. Для домашнего медиасервера с Direct Play достаточно недорогого VPS. Но если нужен уверенный транскодинг нескольких потоков, разумно взять сервер помощнее или машину с GPU. У MAATRIX можно подобрать подходящую конфигурацию в нужной локации — US или UK для зарубежного контента, RU для минимального пинга — и оплатить из России картой, СБП или криптой. Начать можно со скромного тарифа и вырасти по мере роста нагрузки.

Частые вопросы