jellyfin настройка

Установка и настройка Jellyfin: фильмы на компьютере, телефоне и телевизоре

Софт

Обновлено:

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

В этой инструкции пройдём путь до первого просмотра: установим сервер на Windows, Ubuntu/Debian или через Docker, добавим библиотеку и подключим другое устройство. Удалённый доступ через интернет рассмотрим отдельно, после проверки домашней сети.

Что нужно для Jellyfin

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

Для начала подготовьте:

  • Компьютер с поддерживаемой системой или Linux-сервер.
  • Папку с несколькими проверенными видеофайлами.
  • Доступ к настройкам системы для установки программы.
  • Другое устройство в домашней сети для проверки подключения.
  • Свободное место под базу данных, изображения и временные файлы.

Я бы начинал с небольшого набора файлов, а не со сканирования всей коллекции. Так проще проверить распознавание и воспроизведение, прежде чем разбирать ошибки большой библиотеки.

Требования к оборудованию зависят от режима просмотра. При прямом воспроизведении сервер в основном передаёт данные. Преобразование видео, особенно 4K с HDR, создаёт другую нагрузку. Поэтому число ядер без учёта кодеков и графического ускорителя мало говорит о возможностях системы.

Перед покупкой оборудования сверяйтесь с рекомендациями Jellyfin по выбору сервера. Для постоянной работы также важны проводное подключение к роутеру и настройки сна: уснувший компьютер перестанет обслуживать клиентов.

Как установить Jellyfin на Windows

  1. Откройте официальную страницу загрузки Jellyfin Server для Windows.
  2. Скачайте стабильный установщик для своей системы.
  3. Запустите установку. Для первого знакомства выберите обычный вариант установки.
  4. Запустите сервер, если он не запустился автоматически.
  5. Откройте браузер на этом же компьютере и перейдите по адресу ниже.
http://localhost:8096

Ожидаемый результат: появился мастер настройки Jellyfin. Если страница не открывается, сначала проверьте, запущен ли сервер и завершилась ли установка без ошибок.

Установка как службы подходит для выделенного сервера, который должен работать без входа пользователя в Windows. Но это отдельная конфигурация: службе нужны права на собственные данные и медиапапки. Для обычного первого запуска разработчики рекомендуют стандартную установку.

При запросе брандмауэра разрешайте доступ в доверенной домашней сети. Публичную сеть в гостинице или кафе не следует считать домашней только ради подключения Jellyfin.

Как установить Jellyfin на Ubuntu и Debian

Для Ubuntu и Debian проект предоставляет официальный установочный скрипт: он подключает репозиторий и устанавливает пакеты. Простая команда apt install jellyfin без предварительного подключения источника пакетов подходит не для каждой чистой системы.

Откройте терминал. Для следующих действий потребуются права sudo.

sudo apt update
sudo apt install curl ca-certificates

mkdir -p ~/jellyfin-install
cd ~/jellyfin-install

curl -fSLO https://repo.jellyfin.org/install-debuntu.sh
curl -fSLO https://repo.jellyfin.org/install-debuntu.sh.sha256sum
sha256sum -c install-debuntu.sh.sha256sum

Продолжайте только после успешной проверки с сообщением install-debuntu.sh: OK. Если загрузка или проверка завершилась ошибкой, выясните причину до запуска скрипта.

При желании сначала просмотрите его содержимое:

less install-debuntu.sh

Затем выполните установку:

sudo bash install-debuntu.sh

Этот способ описан в официальной инструкции для Debian и Ubuntu. Там же приведён вариант ручного подключения репозитория.

После установки проверьте службу:

sudo systemctl enable --now jellyfin
systemctl status jellyfin --no-pager

Ожидаемый результат: состояние active (running). На сервере с графическим интерфейсом можно открыть http://localhost:8096. С другого компьютера используйте IP-адрес сервера — порядок подключения описан ниже.

Jellyfin через Docker Compose

Этот пример предназначен для Linux с уже установленными Docker и плагином Compose. Он сохраняет настройки вне контейнера, чтобы пересоздание контейнера не означало повторную настройку медиатеки.

Создайте рабочие папки:

mkdir -p ~/jellyfin/config ~/jellyfin/cache
cd ~/jellyfin

id -u
id -g

Последние две команды показывают UID и GID текущего пользователя. В примере ниже стоят 1000:1000 — замените их своими значениями. Выбранный пользователь должен иметь доступ к папкам config и cache, а также читать медиафайлы.

Создайте файл compose.yaml:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    user: "1000:1000"
    ports:
      - "8096:8096/tcp"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /srv/media:/media:ro
    restart: unless-stopped

Здесь /srv/media — пример папки на Linux-хосте. Замените её реальным путём и убедитесь, что в ней находятся ваши файлы. Внутри контейнера эта папка будет доступна как /media.

Суффикс :ro предоставляет контейнеру доступ к медиатеке только для чтения. Записывать изображения или другие данные рядом с исходными фильмами при такой настройке он не сможет.

Запустите сервер:

docker compose up -d
docker compose ps
docker logs --tail 50 jellyfin

Веб-интерфейс откроется на порту 8096 хоста. Этот минимальный пример не настраивает аппаратное ускорение и автоматическое обнаружение сервера: в клиентах можно указать адрес вручную.

Тег latest следует за стабильными выпусками. Перед обновлением проверяйте изменения и сохраняйте резервную копию. Варианты тегов, подключения GPU и дополнительных параметров есть в документации контейнера Jellyfin.

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

После первого открытия веб-интерфейса:

  1. Выберите язык интерфейса.
  2. Создайте администратора и задайте пароль.
  3. Добавьте медиабиблиотеку либо пропустите этот шаг, чтобы вернуться к нему после подготовки папок.
  4. Выберите язык и регион для загрузки описаний и изображений.
  5. Для первого запуска в домашней сети оставьте автоматический проброс портов отключённым. Внешний доступ можно настроить позже.
  6. Завершите мастер и войдите в аккаунт.

Для обычного просмотра создайте отдельного пользователя без административных прав. Так настройки сервера останутся отделены от повседневного использования. Для членов семьи можно ограничить доступ выбранными библиотеками.

Ожидаемый результат: вы входите в Jellyfin и можете открыть панель управления. Наличие пустого главного экрана на этом этапе нормально, если библиотека ещё не добавлена или не просканирована.

Как добавить фильмы и сериалы

В панели управления откройте раздел библиотек, добавьте новую и выберите тип содержимого: фильмы, сериалы или музыка. Укажите понятное название и папку с соответствующими файлами.

Путь зависит от способа установки:

УстановкаПример пути к фильмам
WindowsD:\Media\Movies
Пакеты Ubuntu/Debian/srv/media/Movies
Docker из примера выше/media/Movies

В Docker выбирайте путь внутри контейнера. Папка /srv/media существует на хосте, но после подключения в приведённой конфигурации Jellyfin видит её под именем /media.

Как называть файлы

Для фильмов удобно использовать отдельную папку с названием и годом:

Movies/Film Name (2024)/Film Name (2024).mkv

Для сериалов — папку сериала, сезон и обозначение серии:

Shows/Series Name (2024)/Season 01/Series Name S01E01.mkv
Shows/Series Name (2024)/Season 01/Series Name S01E02.mkv

Такая организация помогает распознаванию. Но несовпадение названия не означает, что файл обязательно исчезнет из библиотеки. Если подтянулась неправильная карточка, воспользуйтесь идентификацией фильма или сериала и уточните название, год либо идентификатор.

Подробные варианты именования приведены отдельно для фильмов и сериалов.

Если папка недоступна

На Windows проверьте права той учётной записи, от которой работает сервер. Доступ пользователя в Проводнике ещё не гарантирует доступ службе. Подключённый сетевой диск также может отсутствовать в окружении службы.

При пакетной установке Ubuntu/Debian сервер обычно работает от пользователя jellyfin. Проверьте, видит ли он содержимое папки:

sudo -u jellyfin ls -l /srv/media/Movies

Нужны права чтения файлов и прохода по всем родительским каталогам. Для локальной файловой системы с поддержкой ACL один из вариантов — дать пользователю jellyfin доступ к выделенной медиапапке:

sudo apt install acl
sudo setfacl -R -m u:jellyfin:rX /srv/media

Замените путь своим. Команда изменяет права для существующего содержимого указанной папки; доступ к новым файлам зависит от их создания и наследования прав. Для сетевых дисков и некоторых файловых систем настройка выполняется иначе.

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

Как добавить субтитры

Для первого теста положите обычный SRT-файл рядом с видео, сохранив одинаковую основную часть имени:

Film Name (2024).mkv
Film Name (2024).ru.srt

После сканирования выберите дорожку в плеере. Автоматический поиск субтитров зависит от используемого поставщика и плагина; могут потребоваться учётная запись или ключ доступа.

Как подключить телефон или телевизор

Сначала проверьте подключение через браузер другого устройства в домашней сети. Это позволит отделить доступность сервера от особенностей приложения на телевизоре.

Узнайте локальный IP компьютера с Jellyfin. В Windows откройте командную строку:

ipconfig

Найдите IPv4-адрес активного домашнего подключения. В Linux можно посмотреть адреса командой:

hostname -I

Выберите адрес домашней сети. На компьютере с Docker в выводе могут присутствовать и адреса контейнерных сетей.

Например, если сервер получил адрес 192.168.1.50, на телефоне или другом компьютере откройте:

http://192.168.1.50:8096

Важно: это пример. Подставьте адрес своего сервера. localhost на телефоне указывает на сам телефон.

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

Если сервер не обнаруживается автоматически, ручной ввод адреса остаётся рабочим способом подключения. Для постоянного использования удобно закрепить адрес сервера через резервирование DHCP в роутере.

Когда на сервере интерфейс работает, а на другом устройстве нет, проверьте:

  • Правильность IP и порта.
  • Подключение обоих устройств к доступной друг для друга локальной сети.
  • Гостевой Wi-Fi и изоляцию клиентов.
  • Входящие правила брандмауэра для TCP 8096.
  • Публикацию порта, если используется Docker.

Для просмотра дома внешний интернет необязателен, если файлы и нужные компоненты уже доступны локально. Загрузка новых постеров и описаний потребует соединения с соответствующими сервисами. Другие возможности описаны в материале о том, что продолжает работать в домашней сети без интернета.

Как проверить воспроизведение и найти причину тормозов

Запустите один фильм на целевом устройстве. В панели управления сервером откройте сведения об активном воспроизведении и посмотрите используемый режим.

РежимЧто делает сервер
Direct PlayПередаёт файл без преобразования
RemuxМеняет контейнер, сохраняя видео- и аудиопотоки
Direct StreamПреобразует звук, сохраняя исходное видео
TranscodeПерекодирует видеопоток

Если видео преобразуется, выясните причину. На решение влияют поддерживаемые клиентом кодеки, ограничение битрейта, аудиодорожка и субтитры. Один и тот же файл может воспроизводиться напрямую в приложении и требовать преобразования в браузере.

Для диагностики попробуйте другой клиент, другую аудиодорожку или временно отключите субтитры. Это сравнительные проверки: они помогают установить, какая часть файла вызывает преобразование.

При прямом воспроизведении с остановками проверьте скорость чтения накопителя и домашнюю сеть. Для теста подключите сервер или клиент кабелем. При транскодировании дополнительно оцените загрузку сервера и журнал FFmpeg.

Когда включать аппаратное ускорение

Аппаратное ускорение помогает поддерживаемому GPU выполнять этапы преобразования видео. Оно требует подходящего оборудования, драйверов и доступа сервера к устройству.

В настройках воспроизведения выберите метод, соответствующий вашей системе: например, Intel QSV, NVIDIA NVENC или VA-API на поддерживаемом Linux-оборудовании. Включайте обработку только тех форматов, которые поддерживает конкретный ускоритель.

После настройки снова запустите файл и проверьте фактическую работу. В Docker дополнительно требуется передать контейнеру доступ к GPU; одной настройки в веб-интерфейсе недостаточно. Подробные инструкции по платформам находятся в разделе аппаратного ускорения Jellyfin.

Универсального коэффициента ускорения нет. Не нужно и автоматически ограничивать каждый телефон разрешением 720p: подходящее качество зависит от файла, клиента и соединения.

Как пользоваться Jellyfin вне дома

Настраивайте внешний доступ после успешного просмотра в локальной сети. Для личных устройств можно использовать частную VPN-сеть между сервером и клиентами — например, по официальной инструкции Jellyfin для Tailscale.

Такой вариант полезен и при CGNAT, когда обычный проброс входящего порта недоступен. Устройства должны быть подключены к этой VPN-сети; при необходимости разрешите удалённый доступ в настройках Jellyfin и нужного пользователя.

Публичный доступ по домену требует отдельной настройки HTTPS и reverse proxy. Для него предусмотрены официальные конфигурации прокси, включая параметры доверенных прокси.

Порт 8096 по умолчанию обслуживает HTTP. Порт 8920 используется встроенным HTTPS только после его включения и настройки сертификата. Само открытие порта в роутере не создаёт защищённое соединение.

Что проверять, если Jellyfin не работает

СимптомПервая проверка
Не открывается даже на сервереРаботает ли процесс или служба, что записано в журнале запуска
На сервере работает, на телефоне нетЛокальный IP, TCP 8096, брандмауэр и изоляция устройств
Папка не появляется при добавленииПуть и права пользователя, от которого работает сервер
В Docker библиотека пустаяИсходная папка хоста, её подключение и путь внутри контейнера
Фильм есть, карточка неправильнаяНазвание, год и ручная идентификация
Карточка открывается, видео не запускаетсяЖурнал FFmpeg, доступ к файлу, параметры транскодирования
Воспроизведение прерываетсяРежим просмотра, сеть, накопитель и нагрузка сервера
Сервер пропадает через некоторое времяСон компьютера, остановка приложения и смена IP

Для пакетной установки Linux полезны команды:

systemctl status jellyfin --no-pager
sudo journalctl -u jellyfin -n 80 --no-pager

Для контейнера:

docker compose ps
docker logs --tail 80 jellyfin

Журналы приложения также доступны через административную панель. При проблеме с конкретным фильмом запомните время попытки воспроизведения и проверьте соответствующие записи. Одна надпись «ошибка воспроизведения» не позволяет определить, виноваты ли файл, клиент или ускорение.

Как сохранять настройки и обновлять Jellyfin

Перед обновлением сделайте резервную копию. В версиях с встроенным резервным копированием откройте панель управления → Backups и создайте архив. Сохраните его отдельно от рабочего сервера. Видео и музыка требуют собственной копии: архив базы не заменяет резервирование медиатеки.

При ручном копировании данных сначала остановите Jellyfin. Порядок и расположение каталогов описаны в инструкции резервного копирования и восстановления. После миграции базы простой возврат старой версии программы может не сработать.

Windows: остановите Jellyfin, скачайте новый стабильный установщик и выполните обновление поверх существующей установки.

Ubuntu/Debian: после подключения официального репозитория обновите список пакетов и установленные компоненты Jellyfin:

sudo apt update
sudo apt install --only-upgrade jellyfin jellyfin-server jellyfin-web

Docker Compose: из папки с файлом compose.yaml:

docker compose pull
docker compose up -d

Папки config и cache должны сохраняться. После обновления проверьте вход, наличие библиотек и воспроизведение одного файла с обычного клиента.

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

3.7 3 голоса
Рейтинг статьи
Подписаться
Уведомить о
guest
1 Комментарий
Старые
Новые Популярные
Вячеслав
Вячеслав
3 месяцев назад

И это «Полный гайд»? Даже 5% не освещено!!

1
0
Оставьте комментарий! Напишите, что думаете по поводу статьи.x