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

Настройка и проверка

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. Не давайте доступ к медиатеке на запись: серверу достаточно чтения.

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

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

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

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

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

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

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

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

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

Итог

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