Jellyseerr: Посібник для початківців з управління домашніми медіа

Якщо ви використовуєте 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, коли це необхідно.
• Сповіщення: Надає оновлення статусу кожного запиту в режимі реального часу. 

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

• Медуза проти 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-контейнера на мережевому сховищі і витягніть образ Jellyseerr. Ви можете зробити це, перейшовши на вкладку "Реєстр", знайшовши Jellyseer і завантаживши образ.

Далі створіть Контейнер:

Перейдіть до "Контейнер" і натисніть "Створити", щоб створити новий контейнер Jellyseer.

• Встановіть наступні параметри: 

Об'ємне мапування:

• Мапування портів:

Зіставте локальний порт (наприклад, 3000) з контейнерним портом 3000.

• Змінні середовища:

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

Тепер ви можете отримати доступ до Jellyseerr, відкривши браузер і перейшовши за адресою http://:3000.

Читайте також: 8 найкращих мережевих сховищ 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.
• Перейдіть до розділу Медіасервер.

Додати детальну інформацію про медузу:

• Хост/IP: Введіть IP-адресу або доменне ім'я вашого сервера Jellyfin (наприклад, 192.168.1.100 або https://myjellyfinserver.com).
• Порт: Використовуйте порт за замовчуванням (8096 для HTTP або 8920 для HTTPS).
• Ключ API: Отримайте його з Jellyfin, увійшовши в Jellyfin, перейшовши в Налаштування користувача > Ключі API і створивши новий ключ для Jellyseerr.
• Натисніть Зберегти, щоб застосувати налаштування.

Перевірте з'єднання:

Jellyseerr надає кнопку "Перевірити з'єднання" для підтвердження успішної інтеграції. Натисніть її, щоб переконатися, що сервер доступний.

a. Додавання Radarr, Sonarr та Prowlarr

Jellyseerr інтегрується з такими інструментами автоматизації, як Radarr, Sonarr і Prowlarr, для завантаження та організації запитуваних медіа. У налаштуваннях Jellyseerr знайдіть і відкрийте вкладку Інтеграції.

Додайте Radarr, вказавши наступні дані:

• Хост/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. Увімкнути теги та фільтрацію

Використовуйте теги, щоб упорядкувати або визначити пріоритетність певних запитів. Наприклад, призначте тег "Діти" для дитячого контенту або "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-контейнера 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.
• Переконайтеся, що немає правил брандмауера, які блокують доступ. Це можна зробити, протестувавши з'єднання за допомогою команди like:

b. Запити не відображаються в Radarr/Sonarr

Коли схвалені запити не відображаються в Radarr або Sonarr, це часто пов'язано з неправильними налаштуваннями інтеграції в Jellyseerr. Це можуть бути невірні URL-адреси, неправильні порти або невідповідні ключі API. 

Іншою поширеною причиною є те, що сервер Jellyseerr не може зв'язатися з Radarr або Sonarr через мережеві обмеження або неправильну конфігурацію.

Можливі рішення:

• Перевірте 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, перейшовши на Панель керування > Бібліотеки та вибравши Сканувати файли бібліотеки.
• Використовуйте менеджер метаданих Jellyfin, щоб перевірити та оновити метадані для відсутніх носіїв.

e. Не завантажується веб-інтерфейс Jellyseerr

Якщо ви не можете отримати доступ до веб-інтерфейсу Jellyseerr, можливо, контейнер не запущено або неправильно налаштовано мапінг портів у вашому Docker. Ця проблема також може виникнути, якщо неправильно налаштований зворотний проксі або неправильно налаштовані SSL-сертифікати для доступу по HTTPS.

Можливі рішення:

• Перевірте стан контейнера Jellyseerr Docker за допомогою команди: 

• Перезапустіть контейнер, якщо він зупинився:

docker restart jellyseerr

• Переконайтеся, що у вашій конфігурації Docker або NAS вказано правильний порт (за замовчуванням: 3000).
• Перевірте налаштування SSL-сертифіката і проксі-сервера, якщо ви використовуєте HTTPS зі зворотним проксі-сервером.

f. Не працюють сповіщення

Коли користувачі не отримують сповіщення про оновлення запитів, це часто пов'язано з тим, що налаштування сповіщень в Jellyseerr не налаштовані або обраний сервіс сповіщень (наприклад, email або push) налаштований неправильно. 

Це також може статися, якщо служба сповіщень не має належних облікових даних або налаштувань з'єднання.

Можливі рішення:

• Перейдіть до Налаштування > Сповіщення в Jellyseerr і налаштуйте службу сповіщень (наприклад, електронну пошту або службу push-сповіщень).
• Протестуйте систему сповіщень, запустивши оновлення запиту.
• Перевірте журнали на наявність помилок, пов'язаних з налаштуванням служби сповіщень.

7. Часті запитання

8. Заключні думки

Якщо ви цього ще не зробили, зараз саме час налаштувати Jellyseerr і відчути його переваги на власному досвіді. Оптимізуйте управління медіа, покращуйте роботу з Jellyfin і радуйте своїх користувачів за допомогою цього найкращого інструменту для запитів на медіа.

Новачкам в управлінні медіа-колекцією варто почати вчитися користуватися Jellyseerr якнайшвидше. Ви не повірите, як швидко ваша колекція може розростися і вийти з-під контролю. 

Придбайте RapidSeedbox зараз!