Коротко о главном

Jellyfin — открытый медиасервер без подписок и рекламы. Он каталогизирует фильмы, сериалы, музыку и фото, отдаёт их на телевизоры, телефоны и браузеры, умеет транскодировать поток под возможности клиента.

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

В этой статье разберём Jellyfin по шагам: установка, базовая конфигурация, практические сценарии и ошибки, которые встречаются чаще всего.

Зачем нужен Jellyfin

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

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install jellyfin

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install jellyfin

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S jellyfin-server jellyfin-web

Пошаговая настройка

После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.

1. Подготовьте медиатеку

Разложите файлы по понятной структуре: фильмы отдельно, сериалы по сезонам. Jellyfin ориентируется на имена файлов и папок.

tree -L 2 /srv/media | head -30
sudo chown -R jellyfin:jellyfin /srv/media

2. Установите и запустите

После установки откройте веб-интерфейс на порту 8096 и пройдите мастер настройки. Не публикуйте порт в интернет до настройки TLS.

sudo systemctl enable --now jellyfin
systemctl status jellyfin --no-pager
curl -I http://127.0.0.1:8096

3. Добавьте библиотеки

Укажите тип содержимого и пути. Не добавляйте корень диска целиком: сервер будет сканировать лишнее и показывать мусор.

# веб-интерфейс → Dashboard → Libraries → Add Media Library

4. Включите аппаратное транскодирование

Проверьте наличие устройства рендеринга и права пользователя jellyfin. Без этого сервер будет транскодировать на CPU и может не справляться.

ls -l /dev/dri
id jellyfin
groups jellyfin

5. Настройте доступ и обновления

Для доступа извне используйте обратный прокси с HTTPS. Обновляйте сервер и клиентов, следите за местом на диске.

docker compose pull
docker compose up -d
journalctl -u jellyfin -n 50 --no-pager

Базовая конфигурация

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

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

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Называйте файлы по схеме Name (Year) и указывайте сезон/эпизод — это р

Называйте файлы по схеме Name (Year) и указывайте сезон/эпизод — это резко улучшает распознавание.

Совет 2. Прямое воспроизведение лучше транскодирования: подбирайте клиенты и фо

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

Совет 3. Ограничьте транскодирование по CPU и проверяйте нагрузку.

Ограничьте транскодирование по CPU и проверяйте нагрузку.

Совет 4. Храните конфигурацию и базу в отдельном каталоге, чтобы пережить переу

Храните конфигурацию и базу в отдельном каталоге, чтобы пережить переустановку.

Совет 5. Не давайте доступ к медиатеке на запись: серверу достаточно чтения.

Не давайте доступ к медиатеке на запись: серверу достаточно чтения.

Практический сценарий

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

Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.

Порядок работ для этого сценария выглядит так:

  1. Подготовьте медиатеку
  2. Установите и запустите
  3. Добавьте библиотеки
  4. Включите аппаратное транскодирование
  5. Настройте доступ и обновления

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

Типичные ошибки

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

1. Видео не воспроизводится

Проверьте, поддерживает ли клиент кодек. Включите транскодирование или используйте совместимый формат. Смотрите журнал Jellyfin.

2. Нет доступа к файлам

Проверьте права пользователя jellyfin и права на каталоги. В Docker путь должен быть смонтирован внутрь контейнера.

3. Транскодирование падает

Проверьте /dev/dri, драйверы и выбранный ускоритель. Для NVIDIA нужны дополнительные библиотеки и права.

Что проверить перед вводом в работу

Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.

Чек-лист

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

Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.

Итог

Jellyfin — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка 0 / 5. Количество оценок: 0

Оценок пока нет. Поставьте оценку первым.

Поделиться: Telegram ВКонтакте