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

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

Минимальный конфиг

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

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

Шпаргалка по командам

  • Подготовьте медиатеку: tree -L 2 /srv/media | head -30
  • Установите и запустите: sudo systemctl enable —now jellyfin
  • Добавьте библиотеки: # веб-интерфейс → Dashboard → Libraries → Add Media Library
  • Включите аппаратное транскодирование: ls -l /dev/dri
  • Настройте доступ и обновления: docker compose pull

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

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

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

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

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

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

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

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

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

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

Что дальше

Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.

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

Чек-лист

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

Короткие ответы на частые вопросы

Нужно ли запускать всё от root?

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

Что делать, если после перезагрузки ничего не работает?

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

Как обновлять без сюрпризов?

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

Итог

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

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

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

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

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

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