Джеллисерр: Руководство для начинающих по управлению домашними медиа

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

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

Содержание

1. Что такое Jellyseerr?
2. Как установить Jellyseerr
3. Подробное описание базовой установки Jellyseerr
4. Расширенная конфигурация
5. Оптимизация производительности Jellyseer
6. Поиск и устранение неисправностей
7. Часто задаваемые вопросы
8. Заключительные размышления

1. Что такое Jellyseerr?

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

Несмотря на то, что Jellyseerr предназначен в первую очередь для Jellyfin, он может работать и с другими медиасерверами, такими как Plex и Эмби. Однако разработчики предупредили, что некоторые функции могут отличаться на других платформах.

• Настраиваемое управление запросами: Расширенные возможности для запроса медиафайлов с удобной системой проверки и утверждения.
• Автоматизация обработки: При необходимости приложение может запускать такие популярные инструменты, как Radarr, Sonarr и Prowlarr.
• Уведомления: Обеспечивает обновление информации о статусе каждого запроса в режиме реального времени. 

Читайте также: 

• Jellyfin Vs Plex - битва медиаменеджеров
• 7 лучших альтернатив Plex

b. Необходимые условия установки

Перед установкой Jellyseerr убедитесь в следующем:

• Медиа-сервер: Jellyfin установлен и работает.
• Средства автоматизации: Radarr, Sonarr и Prowlarr (для индексаторов).
• База данных: SQLite (Вы также можете использовать PostgreSQL)
• Среда хостинга: NAS / Home Server / Seedbox

2. Как установить Jellyseerr

Jellyseerr может работать на всех платформах, поддерживающих Jellfin. Хотя комбинации обширны, мы сосредоточимся в первую очередь на тех, которые поддерживают Docker поскольку это самый надежный способ управления настройками. 

Если вы не знакомы с Docker, прочтите RapidSeedbox Руководство для начинающих по Docker.

a. Вариант 1: Для пользователей NAS

Зайдите в контейнер Docker на NAS и извлеките образ Jellyseerr. Для этого перейдите на вкладку "Реестр", найдите Jellyseer и загрузите образ.

Затем создайте контейнер:

Перейдите в раздел "Контейнер" и нажмите "Создать", чтобы создать новый контейнер Jellyseer.

• Установите следующие параметры: 

Объемное картирование:

• Сопоставление портов:

Сопоставьте локальный порт (например, 3000) с портом контейнера 3000.

• Переменные среды:

• Запустите контейнер.

Теперь вы можете получить доступ к Jellyseerr, открыв браузер и перейдя по адресу http://:3000.

Читайте также: 8 лучших NAS Synology для мультимедиа и синхронизации файлов

b. Вариант 2: Для домашних серверов Seedbox / Linux

Убедитесь, что ваш seedbox поддерживает Docker (большинство провайдеров поддерживают), и используйте SSH для входа в систему. Затем запустите контейнер Jellyseerr, выполнив следующие действия:

Примечание: Замените /path/to/config на каталог хранилища seedbox.

Теперь вы можете использовать домен или IP вашего seedbox и порт (например, http://:3000) для доступа к Jellyseerr. 

Если вы работаете на домашнем сервере Windows, вы можете использовать тот же набор команд. Изменится только процесс установки Docker.

Читайте также:

• Стоит ли использовать ящик для рассады?
• Что делает посевной ящик?

Попробуйте RapidSeedbox сегодня!

3. Прохождение базовой настройки Jellyseerr

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

Откройте браузер и перейдите по адресу http://:3000 (или эквивалентному URL-адресу для вашей платформы). Используйте учетные данные администратора, созданные по умолчанию при настройке. Если появится запрос, создайте надежный пароль для учетной записи администратора.

Перейдите на страницу настроек:

• После входа в систему нажмите на значок шестеренки настроек в интерфейсе Jellyseerr.
• Перейдите в раздел Медиасервер.

Добавить детали Jellyfin:

• Host/IP: Введите IP-адрес или доменное имя вашего сервера Jellyfin (например, 192.168.1.100 или https://myjellyfinserver.com).
• Порт: Используйте порт по умолчанию (8096 для HTTP или 8920 для HTTPS).
• API-ключ: Получите его от Jellyfin, войдя в Jellyfin, перейдя в Настройки пользователя > API-ключи и создав новый ключ для Jellyseerr.
• Нажмите Сохранить, чтобы применить настройки.

Проверьте соединение:

Jellyseerr предоставляет кнопку "Проверить соединение" для подтверждения успешной интеграции. Нажмите ее, чтобы убедиться, что сервер доступен.

a. Добавление Радарра, Сонарра и Проварра

Jellyseerr интегрируется с такими инструментами автоматизации, как Radarr, Sonarr и Prowlarr, для загрузки и организации запрошенных медиафайлов. В настройках Jellyseerr найдите и откройте вкладку "Интеграции".

Добавьте Radarr со следующими деталями:

• Host/IP: IP-адрес или домен вашего сервера Radarr (например, http://localhost:7878 или http://192.168.1.100:7878).
• Ключ API: Получите его в Radarr в разделе Настройки > Общие > Безопасность.
• Нажмите Сохранить и Проверить подключение, чтобы убедиться в правильности настроек.

Добавьте Сонарр:

Повторите описанный выше процесс, но используйте соответствующий порт (по умолчанию: 8989) и ключ API из меню Настройки > Общие > Безопасность.

Добавьте Prowlarr (необязательно):

Если вы используете Prowlarr для управления индексаторами, нажмите Добавить интеграцию и выберите Prowlarr.

Введите IP, порт (по умолчанию: 9696) и ключ API в меню Настройки > Общие > Безопасность в Prowlarr.

Читайте также:

• Полное руководство Radarr - как установить, использовать и многое другое
• Руководство по Sonarr - настройка, использование и многое другое
• Руководство по Prowlarr: Как установить, настроить и использовать

4. Расширенная конфигурация

После интеграции Jellyseerr с Jellyfin и вашими инструментами автоматизации настройте их в соответствии с вашими предпочтениями.

a. Установка ролей и разрешений пользователей

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

b. Установите предпочтения качества по умолчанию

В разделе "Интеграции" настройте Radarr и Sonarr на приоритет определенных качеств. Например, вы можете настроить Radarr на загрузку фильмов в формате 4K или Sonarr на предпочтение HDTV-1080p для телепередач.

c. Включите метки и фильтрацию

Используйте теги, чтобы упорядочить или расставить приоритеты для конкретных запросов. Например, присвойте тег "Kids" для детского контента или "4K" для фильмов высокого качества. Лучше настроить фильтры для автоматического определения приоритетности запросов с определенными тегами.

d. Обеспечьте безопасность установки (важно!)

Если ваш сервер или Jellyseerr доступен из Интернета, защитите его, включив HTTPS.

Используйте обратный прокси-сервер, например Nginx или Traefik, для работы с SSL-сертификатами и укажите пользовательский домен (например, https://jellyseer.mydomain.com).

Читайте также: 

• Менеджер прокси-серверов Nginx: Как настроить и использовать
• Traefik vs NGINX: сравнение дизайна и назначения

5. Оптимизация производительности Jellyseerr

Несмотря на то, что Jellyseerr относительно легкий, мы запускаем его в среде с низким уровнем ресурсов. Из-за этого он может работать медленно или не реагировать на запросы, падать при интенсивном использовании или неэффективно обрабатывать запросы.

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

a. Определите ограничения по ресурсам

Ограниченные ресурсы процессора, оперативной памяти или хранилища могут привести к задержкам или сбоям. Выделите Jellyseerr дополнительные системные ресурсы, увеличив лимиты процессора и памяти контейнера Docker:

b. Оптимизация базы данных

По умолчанию Jellyseerr использует SQLite, который хорошо подходит для небольших систем, но может стать узким местом по мере роста вашей медиатеки и базы пользователей. Чтобы смягчить эту проблему, вы можете перейти на PostgreSQL, которая является более надежной и масштабируемой.

• Установите PostgreSQL на свой сервер или воспользуйтесь облачным сервисом PostgreSQL.
• Обновите конфигурацию Jellyseerr для использования PostgreSQL, установив DB_TYPE=postgresql и указав детали подключения.
• Перенесите существующие данные из SQLite в PostgreSQL, используя инструмент миграции или документацию Jellyseerr.

c. Периодически перезапускайте контейнер Docker

Со временем временное использование ресурсов в контейнере Docker может накапливаться, что приводит к снижению производительности. Для решения этой проблемы периодически перезапускайте Docker-контейнер Jellyseerr, чтобы очистить временное использование ресурсов:

docker restart jellyseerr

Чтобы обеспечить регулярное обслуживание, вы можете автоматизировать этот процесс с помощью задания cron или планировщика задач Windows.

d. Оптимизация уведомлений и обновлений

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

• Уменьшите частоту обновления статуса в настройках Jellyseerr.
• Ограничьте уведомления только важными событиями (например, одобрение запроса или добавление носителя), чтобы избежать чрезмерной фоновой активности.

e. Сведите к минимуму ненужные плагины или функции

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

• Отключите функции или интеграции, которые вы активно не используете.
• Проведите аудит настроек и интеграций Jellyseerr, чтобы оптимизировать рабочий процесс.

6. Устранение общих проблем

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

a. Jellyseerr не может подключиться к Jellyfin

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

Обычно эта проблема возникает из-за неправильных данных сервера, введенных в Jellyseerr, например, недействительного IP-адреса, номера порта или ключа API. Также причиной могут быть сетевые ограничения, например, брандмауэр, блокирующий связь между Jellyseerr и Jellyfin.

Возможные решения:

• Дважды проверьте IP-адрес или домен Jellyfin, порт (8096 для HTTP или 8920 для HTTPS) и ключ API в настройках Jellyseerr.
• При необходимости регенерируйте ключ API в Jellyfin в разделе Настройки пользователя > Ключи API.
• Убедитесь, что нет правил брандмауэра, блокирующих доступ. Это можно сделать, протестировав соединение с помощью такой команды, как:

b. Запросы, не представленные в Радарр/Сонарр

Если одобренные запросы не отображаются в Radarr или Sonarr, это часто связано с неправильными настройками интеграции в Jellyseerr. Это могут быть недействительные URL, неправильные порты или несовпадающие ключи API. 

Другая распространенная причина - сервер Jellyseerr не может связаться с Радарром или Сонарром из-за сетевых ограничений или неправильной конфигурации.

Возможные решения:

• Проверьте URL-адреса для Radarr и Sonarr в настройках Jellyseerr. Например, используйте http://:7878 или http://:8989.
• Подтвердите API-ключи, получив их в меню Настройки > Общие > Безопасность в Radarr и Sonarr.
• Протестируйте соединение на вкладке интеграций Jellyseerr, чтобы убедиться, что все настроено правильно.

c. Медиа не загружается

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

Кроме того, отсутствующие или плохо настроенные индексаторы в Radarr или Sonarr могут не найти запрашиваемое содержимое.

Возможные решения:

• Убедитесь, что клиент загрузки правильно добавлен в Radarr/Sonarr с правильным IP-адресом, портом и ключом API.
• Протестируйте индексаторы в Radarr или Sonarr, выполнив поиск запрашиваемого содержимого вручную.
• Проверьте журналы в Radarr или Sonarr на наличие ошибок, связанных с загрузкой или подключением индексатора.

d. Медиа не отображается в Jellyfin

Если загруженное содержимое не появляется в библиотеке Jellyfin, это обычно связано с неправильными путями к библиотеке или задержкой сканирования библиотеки. Пути к библиотекам в Jellyfin могут не совпадать с местом загрузки Radarr или Sonarr, или Jellyfin может недостаточно часто сканировать библиотеку. 

Несоответствие метаданных также может привести к некорректному отображению контента.

Возможные решения:

• Убедитесь, что пути к библиотекам Jellyfin правильно настроены и соответствуют каталогам загрузки, используемым Radarr и Sonarr.
• Запустите сканирование библиотеки вручную в Jellyfin, перейдя в Dashboard > Libraries и выбрав Scan Library Files.
• Используйте менеджер метаданных Jellyfin, чтобы проверить и обновить метаданные для отсутствующих носителей.

e. Веб-интерфейс Jellyseerr не загружается

Если вы не можете получить доступ к веб-интерфейсу Jellyseerr, возможно, не запущен контейнер или неправильно настроено сопоставление портов в настройках Docker. Эта проблема также может возникнуть, если неправильно настроен обратный прокси-сервер или неверно установлены SSL-сертификаты для доступа по протоколу HTTPS.

Возможные решения:

• Проверьте состояние Docker-контейнера Jellyseerr с помощью команды: 

• Перезапустите контейнер, если он остановлен:

docker restart jellyseerr

• Убедитесь, что в конфигурации Docker или NAS указан правильный порт (по умолчанию: 3000).
• Проверьте сертификат SSL и настройки прокси, если вы используете HTTPS с обратным прокси.

f. Уведомления не работают

Если пользователи не получают уведомления об обновлениях запроса, это часто связано с тем, что настройки уведомлений в Jellyseerr не были настроены или выбранная служба уведомлений (например, электронная почта или push) была неправильно сконфигурирована. 

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

Возможные решения:

• Перейдите в Настройки > Уведомления в Jellyseerr и настройте службу уведомлений (например, электронную почту или службу push-уведомлений).
• Протестируйте систему уведомлений, запустив обновление запроса.
• Проверьте журналы на наличие ошибок, связанных с настройкой службы уведомлений.

7. Часто задаваемые вопросы

8. Заключительные мысли

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

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

Получите RapidSeedbox прямо сейчас!