Jellyfin — это бесплатный медиасервер с открытым исходным кодом , который ставит вашу медиатеку в центр внимания: вы сами решаете, чем поделиться и как это воспроизвести. Никаких обязательных учетных записей, платных подписок или навязчивой телеметрии; философия ясна: «ваши медиафайлы, ваши правила», с полной конфиденциальностью и контролем дома или в вашей сети.
В этом практическом и всеобъемлющем руководстве вы узнаете, что такое Jellyfin, его историю и лицензию, совместимые платформы и клиенты, ключевые функции, такие как просмотр телепередач в прямом эфире, SyncPlay или DLNA, обзор процесса установки и настройки (включая Docker и NAS), реальные отличия от Plex и Emby, рекомендуемые версии с новыми функциями, такими как Dolby Vision или AV1, а также подробную информацию для разработчиков (.NET, ffmpeg, веб-клиенты и API) и опыт пользователей с распространенными проблемами и их решениями.
Что такое Jellyfin и почему это важно
Jellyfin — это набор приложений и медиасервер, предназначенные для организации, управления и обмена цифровыми файлами (видео, аудио, фотографиями и даже электронными книгами в формате EPUB) с использованием клиент-серверной модели. Сервер устанавливается на Linux, Windows, macOS или в контейнере Docker, а клиенты запускаются на мобильных телефонах, планшетах, Smart TV, медиаплеерах, игровых консолях или непосредственно в веб-браузере.
В отличие от проприетарных альтернатив, таких как Plex или Emby, Jellyfin — это на 100% бесплатное программное обеспечение (GPLv2), без подписок, платных функций или аутентификации третьих лиц. Оно отлично работает в изолированной интрасети, не полагаясь на внешние сервисы, и может передавать контент на устройства DLNA и Chromecast в вашей сети.
История, лицензия и философия Jellyfin
Проект зародился 8 декабря 2018 года как форк Emby , когда сообщество (включая таких соучредителей, как Эндрю Раберт и Джошуа Бонифас) отреагировало на закрытие его разработки с открытым исходным кодом. Первый релиз состоялся 30 декабря 2018 года, а с января 2019 года проект перешёл на собственную систему версионирования, начиная с версии 10.0.0, с постоянными обновлениями.
Лицензия GPLv2 гарантирует, что код останется свободным , а сообщество сможет проверять, улучшать и распространять его. Такой подход также обеспечивает конфиденциальность: нет «скрытой повестки дня», нет отслеживания и нет обязательных учетных записей для использования собственных медиафайлов, что многие пользователи ценят по сравнению с моделями freemium.
Платформы, экосистема и клиенты
Jellyfin — это по-настоящему кроссплатформенное приложение : сервер работает на Linux, Windows, macOS и Docker; клиенты — для Android, iOS и iPadOS, Amazon Fire TV, Android TV и Fire TV, Roku, Xbox One и Series X/S, телевизоров LG с webOS, настольные приложения (Jellyfin Media Player) и веб-интерфейс, доступный из браузера.
Также существуют дополнения и плагины для интеграции с Kodi , а в некоторых случаях даже неофициальная совместимость со старыми клиентами Emby (хотя это становится все менее распространенным по мере расхождения кода). По умолчанию доступ осуществляется по протоколу HTTP на порту 8096 и HTTPS на порту 8920, что обеспечивает как локальный, так и удаленный доступ при соответствующей настройке.
Ключевые особенности, которые имеют значение
- Прямая трансляция и запись: Если вы добавите необходимое оборудование/услуги, Jellyfin сможет настраиваться на прямую трансляцию телепередач и управлять записями без ограничений каналов, налагаемых сторонними лицензиями.
- Chromecast и DLNA: Вы можете транслировать контент на устройства Chromecast и на плееры, совместимые с DLNA. Начиная с Jellyfin 10.9, DLNA управляется как плагин, сохраняя функциональность, но перемещая её в раздел дополнений.
- Синхронизация: Начиная с версии 10.6.0 несколько пользователей могут синхронно просматривать один и тот же контент, что идеально подходит для удаленных групповых сеансов.
- Электронные книги EPUB и медиасегменты- Добавлено чтение EPUB, а в последних выпусках — такие улучшения, как медиа-сегменты (например, главы в видеофайлах) для более точной навигации.
- Нет платного доступа: Транскодирование, пользовательские скраперы, воспроизведение плейлистов IPTV (через Xteve или HDHomeRun) и другие расширенные функции доступны без подписки.
Официальное приложение для Android и мобильная версия
Официальное приложение для Android является естественным дополнением к серверу : вам необходимо запустить сервер Jellyfin, а из приложения вы можете воспроизводить свою библиотеку, отправлять контент на Chromecast, просматривать свою коллекцию с помощью удобного интерфейса и слушать музыку с помощью Android Auto (только онлайн).
Девиз «Ваши медиафайлы на ваших условиях» имеет смысл и для мобильных устройств : никаких учетных записей или отслеживания, прямой доступ к вашей коллекции и надежная поддержка локального воспроизведения, если формат совместим, что сводит к минимуму ненужное перекодирование.
Установка и начало работы (ПК, Docker и NAS)
Настройка осуществляется по принципу "сервер-клиент" : сначала устанавливается сервер, а затем к нему подключаются один или несколько клиентов. На официальном сайте доступны установщики для Linux, Windows, macOS и Docker, а сообщество поддерживает пакеты для различных NAS-устройств.
QNAP NAS и практичный способ быстрой установки : некоторые пользователи устанавливают Jellyfin на QNAP, используя файл .qpkg (например, тот, что есть у pdulvp на GitHub) непосредственно из App Center, что ускоряет развертывание благодаря значку и запуску, как у любого другого приложения для NAS.
Будьте осторожны с портом 8096, если используете Emby : и Jellyfin, и Emby по умолчанию используют порт 8096, поэтому, если они работают на одной машине, при открытии Jellyfin вы, скорее всего, увидите сервер Emby. Измените порт одного из них, чтобы избежать конфликта.
Мастер первоначальной настройки : При запуске Jellyfin Server выберите язык, создайте пользователя (лучше избегать имени «admin» и использовать надежный пароль) и определите свои библиотеки, указав, являются ли они фильмами, сериалами, музыкой и т. д., язык метаданных и вашу страну для корректной классификации.
Внешний доступ и порты : На начальном этапе лучше всего отключить внешний доступ и автоматическое открытие портов; как только все заработает должным образом, можно будет рассматривать возможность открытия портов 8096/8920 только в случае необходимости и с соблюдением соответствующих мер безопасности.
Организация файлов и парсеров: будьте организованы
Jellyfin поощряет организованность, сводя к минимуму неожиданности : в отличие от Plex, который «прощает» хаотичные имена, Jellyfin работает гораздо лучше с четкими правилами именования, особенно для сериалов. Структура типа "Series/Season 2/Series S02E01.mp4" позволяет избежать проблем и ускоряет идентификацию.
При необходимости переименуйте; если нет, настройте : хотя переименование может быть утомительным, Jellyfin позволяет использовать собственные парсеры и вручную редактировать метаданные без дополнительной оплаты, что другие платформы скрывают за своими премиум-планами.
Производительность, транскодирование и качество воспроизведения
Воспроизведение локального контента происходит быстро и надежно : пользователи, переходящие с Plex, часто отмечают более легкую начальную загрузку и меньшую буферизацию при совместимости формата, что позволяет избежать ненужного перекодирования.
Транскодирование бесплатно, но потребляет ресурсы : если ваш NAS или сервер имеет ограниченные возможности, транскодирование в реальном времени может его перегрузить. Включите аппаратное ускорение в разделе «Воспроизведение > Конвертация» и попробуйте HEVC и AV1, если ваше оборудование это позволяет, скорректировав свои ожидания в зависимости от вашей системы.
Плагины, IPTV и экосистема расширений
Официальный репозиторий дополнений предлагает ключевые компоненты : DLNA (теперь в виде плагина), интеграцию с Infuse и Kodi, NextPVR, Trakt и многое другое. Это не бесконечный каталог, но он охватывает основные функции, а сообщество вносит свой вклад в сторонние репозитории, не будучи привязанным к официальному.
Бесплатные IPTV-списки : Jellyfin может воспроизводить IPTV, используя Xteve или HDHomeRun в качестве посредников; настройка требует немного больше усилий, чем в Kodi, но после настройки потока он очень хорошо интегрируется в вашу библиотеку.
Безопасность и конфиденциальность
Никаких принудительных учетных записей, никакой телеметрии и никаких третьих лиц : Jellyfin не отправляет ваши данные на внешние серверы и может работать внутри вашей сети без публичного доступа. Тем не менее, используйте надежные пароли и тщательно подумайте, действительно ли вам нужно открывать порты для внешнего мира.
Форумы и сети с «стенами уведомлений о файлах cookie» : такие сообщества, как Reddit, могут отображать уведомления о файлах cookie и аналогичных технологиях; это не является частью Jellyfin, но об этом стоит помнить, если вы обращаетесь к темам поддержки на этих платформах.
Разработка: компиляция, добавление и отладка Jellyfin
Репозиторий сервера находится на GitHub и использует .NET (в настоящее время для компиляции требуется SDK 9.0). Вам также понадобится ffmpeg, и вы можете разрабатывать с помощью Visual Studio 2022 или VS Code на любой основной операционной системе (кроме FreeBSD, которая пока не поддерживается).
Веб-клиент отделен от бэкэнда : сервер по умолчанию предоставляет статические файлы для веб-клиента, но эти файлы не включены в репозиторий. Вы можете получить их тремя способами: загрузить завершенные сборки из конвейера Azure DevOps, скомпилировать их из репозитория jellyfin-web или скопировать их из существующей установки сервера.
Начало работы и отладка : В Visual Studio откройте решение и нажмите F5. В VS Code откройте папку репозитория, установите рекомендуемые расширения и нажмите F5. В командной строке введите "dotnet run" или скомпилируйте и запустите исполняемый файл (./jellyfin в Linux/macOS или jellyfin.exe в Windows).
Для размещения веб-клиента отдельно используйте флаг «--nowebclient» или переменную «JELLYFIN_NOWEBCONTENT=true». Существует профиль запуска «Jellyfin.Server(nowebcontent)». Обратите внимание, что мастер установки не сможет запуститься, если веб-клиент размещен отдельно.
API и тестирование : Документация по API находится в файле «/api-docs/swagger/index.html» на серверном порту. Модульные тесты запускаются с помощью команды «dotnet test» и являются частью конвейера CI в Azure.
Контейнеры Codespaces и Development : При создании среды загрузка расширений может занять 20–30 секунд (.NET 7.x в логах). Если вы обращаетесь извне, отметьте порты как общедоступные. При первом доступе может появиться экран входа в систему; перезагрузите страницу, чтобы перейти к мастеру настройки. Существуют варианты контейнера "nowebclient" и контейнер с предустановленным ffmpeg6 (лаунчер "ghcs .NET Launch (nowebclient, ffmpeg)").
Реальный опыт: субтитры и кэширование в клиентах
Рассинхронизация или отсутствие субтитров на iOS : Некоторые пользователи сообщают, что при включенных встроенных или SRT-субтитрах синхронизация не удается или они не загружаются на iPhone, в то время как в других приложениях (веб, Tizen, PC Media Player) они работают нормально. Обычно команда исправляет это в обновлениях, но стоит попробовать разные контейнеры субтитров и настройки.
Проблемы с кэшем при смене серверов или обновлении : При подключении к новому серверу или после обновления приложения, всё ещё связанного с предыдущим, интерфейс может не отображаться из-за повреждённого кэша. На ПК это исправляется очисткой кэша плеера; на iPhone наиболее простым решением является переустановка приложения. Часто запрашивается также очистка веб-кэша с помощью кнопки «Сбросить приложение».
Как использовать Jellyfin в повседневной жизни
Из гостиной или в дороге : получайте доступ к своим библиотекам, продолжайте воспроизведение с того места, где остановились, транслируйте на Chromecast или Smart TV или слушайте музыку с помощью Android Auto (помните, это онлайн-режим). Если вы включите функцию «Прямой эфир», вы сможете интегрировать каналы и записи в свой просмотр.
Доступен как в браузере, так и на компьютере : веб-клиент обладает высокой производительностью, а Jellyfin Media Player для Windows, macOS и Linux предлагает ускорение воспроизведения и удобные сочетания клавиш. Вы также можете комбинировать его с Kodi или Infuse, если предпочитаете их интерфейсы.
Полезные советы, как избежать головной боли при использовании Jellyfin
- Поддерживайте сервер в актуальном состоянии: Помимо новых функций (таких как Dolby Vision HDR или AV1), есть исправления ошибок клиента, улучшения парсера и оптимизация бэкэнда.
- Берегите библиотекуЧёткая структура, единообразное наименования и метаданные на правильном языке экономят время. Воспользуйтесь функциями «Воспроизведение» > «Конвертация», чтобы найти баланс между качеством и потреблением ресурсов.
- Плагины с головойУстанавливайте только то, что используете. DLNA как плагин, Trakt для синхронизации, интеграция с Kodi/Infuse и NextPVR для ТВ — беспроигрышные варианты; остальное — контролируемое тестирование.
Техническая совместимость Jellyfin и дополнительные примечания
Разработанная на C# и основанная на .NET , платформа Jellyfin перенесла свой веб-интерфейс на отдельную систему, чтобы подготовиться к работе с SQL-сервером и сценариям высокой доступности с несколькими серверами. По умолчанию она доступна через порты 8096/8920, а API Swagger помогает интегрировать или автоматизировать задачи.
Доступен на нескольких языках и имеет активное сообщество, которое поддерживает переводы (через платформы локализации), темы и наборы иконок. Проект на GitHub, помимо сервера, содержит множество подпроектов и приветствует вклад в виде руководств и стандартов сообщества.
Экосистема HTPC позиционирует его наряду с Plex, Kodi и Emby как основной вариант для домашнего кинотеатра, обеспечивая совместимость с телеприставками и системами Smart TV. Вы можете запустить его в Docker и адаптировать развертывание к своей инфраструктуре.
Если вам нужен контроль, конфиденциальность и возможности управления без подписки , Jellyfin — отличный вариант: он гибок на разных платформах, поддерживает Live TV, плагины и транскодирование, а также поддерживается сообществом, которое постоянно совершенствует и расширяет проект.
