لا تُعد Jellyfin وSeerr وJellyBridge ثلاثة أجزاء من تطبيق ZimaOS واحد. وأصبح من الأسهل فهم سلسلة الخدمات في موضوع مجتمع IceWhale لشهر يونيو 2026 بعد فصلها إلى طبقات: Jellyfin هو خادم الوسائط، وSeerr تطبيق مستقل لطلب الوسائط، وJellyBridge إضافة لـ Jellyfin تربط بين اكتشاف المحتوى وإجراءات الطلب في Jellyfin وSeerr.
كان صاحب المنشور الأصلي يشغّل Jellyfin من متجر تطبيقات ZimaOS، لكنه لم يتمكن من تشغيل بقية المكونات. أوصت ردود المجتمع بتشخيص كل طبقة بشكل مستقل بدلًا من تغيير كل شيء دفعة واحدة. وأكد مستخدم لاحق أنه شغّل Jellyfin وSeerr بنجاح على ZimaBoard 2، بينما كانت حزمة Sonarr/Radarr تعمل على Raspberry Pi منفصل، ما يوضح أن هذه الخدمات لا تحتاج إلى العمل في الحاوية نفسها أو حتى على الجهاز نفسه، ما دامت عناوين URL وبيانات اعتماد API ومسارات الشبكة صحيحة.
افهم أولًا بنية Jellyfin → Seerr → JellyBridge
إن أبسط طريقة لفهم هذا الإعداد هي:
- Jellyfin: يعرض مكتبات الأفلام والمسلسلات التلفزيونية الحالية ويديرها.
- Seerr: يوفر اكتشاف الوسائط وطلبها، ثم يرسل الطلبات المعتمدة إلى Sonarr وRadarr.
- Sonarr/Radarr: يتوليان سير عمل الحصول على المسلسلات التلفزيونية والأفلام.
- JellyBridge: يعمل داخل Jellyfin كإضافة ويتواصل مع Seerr، بحيث يمكن لعمليات الاكتشاف أو الإضافة إلى المفضلة في Jellyfin إنشاء طلبات.
تصف وثائق Seerr الحالية Seerr بأنه مدير لاكتشاف الوسائط وطلبها لـ Jellyfin وPlex وEmby، مع تكامل أصلي مع Sonarr وRadarr. يعمل Seerr عادةً في حاوية Docker مستقلة، ويعرض واجهة الويب الخاصة به على المنفذ 5055. راجع دليل البدء الحالي لـ Seerr.
Seerr هو الخلف الحالي لـ Jellyseerr وOverseerr
أشار أحد الردود في المجتمع إلى أن Seerr حل محل تطبيق Jellyseerr الأقدم. وتؤكد وثائق مشروع Seerr الحالية أن Seerr هو المسار اللاحق الموحّد لمستخدمي Jellyseerr وOverseerr.
هذا مهم لأن وثائق JellyBridge القديمة ولقطات الشاشة ومتغيرات البيئة أو أسماء الحاويات قد تظل تستخدم اسم Jellyseerr. يذكر مشروع JellyBridge الحالي أن Seerr 3.x يستخدم واجهة API متوافقة للتكامل الذي اختبره، مع الاحتفاظ بمصطلحات Jellyseerr في أجزاء من وثائقه.
إذا كنت تنشئ هذه المنظومة الآن، فابدأ بالإصدار الحالي من Seerr بدلًا من تثبيت إصدار Jellyseerr قديم عمدًا، ما لم يتطلب إصدار مكوّن إضافي محدد ذلك صراحةً.
الخطوة 1: شغّل Seerr قبل تثبيت JellyBridge
لا تستكشف أخطاء JellyBridge وإصلاحها قبل التأكد من أن Seerr نفسه يعمل بصورة سليمة. ثبّت Seerr كتطبيق Docker منفصل في ZimaOS أو باستخدام مصدر التطبيقات المدعوم المتاح على نظامك الحالي.
بعد التثبيت، تحقق من واجهة Seerr على الويب مباشرةً:
http://ZIMAOS_LAN_IP:5055يمكن أن يختلف منفذ المضيف إذا كان تعيين حاوية ZimaOS لديك يستخدم منفذًا خارجيًا آخر. استخدم منفذ المضيف الظاهر في إعدادات التطبيق الفعلية.
إذا لم يفتح Seerr، فتحقق من الحاوية قبل التعامل مع Jellyfin:
docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100كانت تلك الأوامر أولى فحوصات استكشاف الأخطاء وإصلاحها المقترحة في موضوع المجتمع. إذا كانت أوامر Docker تتطلب صلاحيات مضيف مرتفعة في إصدار ZimaOS لديك، فاستخدم سير عمل الطرفية المصرّح به بدلًا من إضعاف أذونات مقبس Docker.
الخطوة 2: ربط Seerr بـ Jellyfin
أثناء إعداد Seerr، اضبط Jellyfin باستخدام حساب إداري في Jellyfin. توضح وثائق Seerr الحالية أن صفحة إعدادات Jellyfin مسؤولة عن الاتصال بالخادم ومزامنة المكتبات.
تأكد مما يلي قبل المتابعة:
- يمكن لـ Seerr الوصول إلى عنوان URL الخاص بـ Jellyfin الذي أدخلته.
- يمتلك حساب Jellyfin المستخدم أثناء الإعداد صلاحيات الإدارة المطلوبة.
- تظهر مكتبات Jellyfin في Seerr بعد المزامنة.
- يكتمل فحص المكتبة يدويًا بنجاح.
راجع دليل إعدادات خادم الوسائط في Seerr للاطلاع على سير عمل الاتصال الحالي بـ Jellyfin.
الخطوة 3: ربط Seerr بـ Sonarr وRadarr
لا ينزّل Seerr الوسائط بنفسه. بل يرسل الطلبات المعتمدة إلى Sonarr وRadarr، اللذين يتوليان بعد ذلك تنسيق بقية حزمة الأتمتة.
قد يعمل Sonarr وRadarr:
- على مضيف ZimaOS نفسه؛
- في حاويات Docker منفصلة؛
- على خادم منزلي آخر؛
- أو، كما وصف أحد مستخدمي المجتمع، على جهاز Raspberry Pi منفصل.
المتطلب الأساسي هو إمكانية الوصول. يجب أن يستخدم Seerr عنوانًا يعمل من داخل حاوية Seerr أو من سياق المضيف. فعنوان URL الذي يعمل على حاسوبك المحمول ليس تلقائيًا العنوان الصحيح للتواصل بين الحاويات.
لا تفترض أن حاويات متجر تطبيقات ZimaOS تشترك في شبكة Docker نفسها
كان أهم تحذير متعلق بالشبكات في رد المجتمع هو أن حاوية Jellyfin المثبّتة من متجر تطبيقات ZimaOS قد لا تتمكن تلقائيًا من رؤية حاوية Seerr المثبّتة يدويًا باستخدام اسم الحاوية.
إذا كانت الحاويتان على شبكة Docker مخصصة يعرّفها المستخدم، فيمكن استخدام اسم خدمة مثل:
http://seerr:5055قد يعمل. إذا كانت الحاويتان على شبكتي Docker مختلفتين، فاستخدم عنوان مضيف يمكن الوصول إليه ومنفذ منشور، مثلًا:
http://ZIMAOS_LAN_IP:5055لا تستخدم localhost بشكل عشوائي بين الحاويات. داخل حاوية Jellyfin، localhost يشير إلى حاوية Jellyfin نفسها، وليس إلى حاوية Seerr منفصلة.
الخطوة 4: تثبيت JellyBridge داخل Jellyfin
JellyBridge مكوّن إضافي لـ Jellyfin، وليس تطبيقًا آخر على ZimaOS يحتاج إلى استبدال Jellyfin. توصي طريقة التثبيت الحالية للمشروع بإضافة مستودع المكوّن الإضافي من خلال واجهة إدارة Jellyfin.
في Jellyfin:
- افتح لوحة المعلومات > المكوّنات الإضافية.
- افتح إدارة المستودعات.
- أضف عنوان URL لمستودع المكوّن الإضافي JellyBridge الذي يوفره المشروع.
- افتح كتالوج المكوّنات الإضافية.
- ثبّت إصدار JellyBridge المتوافق مع إصدار Jellyfin لديك.
- أعد تشغيل Jellyfin.
يوثّق مستودع JellyBridge الحالي إصدارات خاصة بالمكوّن الإضافي لـ Jellyfin 10.10 و10.11. راجع ملاحظات التوافق قبل اختيار الحزمة. راجع وثائق مشروع JellyBridge.
الخطوة 5: تهيئة JellyBridge للوصول إلى Seerr
بعد إعادة تشغيل Jellyfin، افتح إعدادات المكوّن الإضافي JellyBridge وأدخل:
- عنوان Seerr الذي يمكن الوصول إليه من Jellyfin؛
- مفتاح Seerr API المطلوب من المكوّن الإضافي؛
- دليل مخصص لبيانات مكتبة JellyBridge؛
- سلوك المزامنة الذي تريد استخدامه.
استخدم وظيفة اختبار الاتصال في المكوّن الإضافي قبل استيراد محتوى الاكتشاف. إذا فشل الاختبار، فلا تنشئ مكتبات إضافية بعد. أصلح عنوان Seerr أو شبكة Docker أو مفتاح API أولًا.
الخطوة 6: إنشاء مكتبة اكتشاف JellyBridge
ينشئ JellyBridge محتوىً نائبًا ومحتوى اكتشاف يمكن لـ Jellyfin عرضه كمكتبة. تتضمن وثائق المكوّن الإضافي الحالية سير عمل للإعداد داخل المكوّن لإنشاء هذه المكتبة وتهيئتها.
احتفظ بهذه المكتبة منفصلة عن مسارات الوسائط الفعلية للأفلام والبرامج التلفزيونية. عناصر الاكتشاف في JellyBridge ليست بدائل للملفات الحقيقية التي يديرها Sonarr وRadarr وJellyfin.
عندما يضيف المستخدمون عناصر الاكتشاف المدعومة إلى المفضلة في Jellyfin، يمكن لـ JellyBridge إرسال الطلب المقابل إلى Seerr. ثم يتولى Seerr الموافقة على الطلب وإرساله إلى Sonarr أو Radarr وفقًا لإعداداتك.
مثال مجتمع ZimaBoard 2
ذكر مشارك لاحق أنه شغّل Jellyfin وتطبيق Seerr الأحدث معًا على ZimaBoard 2، بينما كانت حزمة ARR لديه تعمل على Raspberry Pi 4. وهذا دليل مفيد على إمكانية توزيع البنية المعمارية على عدة أنظمة.
المسار الحالي لمنتجات أجهزة ZimaBoard هو خادم ZimaBoard 2 الحالي أحادي اللوحة.
لم يتضمن الرد ملفات Docker Compose أو إعدادات الشبكة الدقيقة للمستخدم، لذلك لا ينبغي اعتباره إعدادًا موثوقًا للنسخ واللصق. تكمن قيمته في البنية المعمارية: يمكن فصل الخدمات ما دام كل طرف تكامل قابلًا للوصول.
استكشاف أخطاء الحزمة وإصلاحها بهذا الترتيب
- تأكد من أن Jellyfin يعمل بشكل مستقل.
- تأكد من استمرار تشغيل حاوية Seerr.
- افتح واجهة ويب Seerr مباشرةً.
- تأكد من أن Seerr يستطيع المصادقة مع Jellyfin ومزامنة المكتبات.
- تأكد من أن Seerr يستطيع الاتصال بـ Sonarr وRadarr.
- ثبّت إصدار JellyBridge المتوافق مع إصدار Jellyfin لديك.
- تأكد من أن JellyBridge يستطيع اختبار اتصاله بـ Seerr.
- أنشئ مكتبة اكتشاف JellyBridge فقط بعد نجاح اختبار الاتصال.
- اختبر طلبًا واحدًا من Jellyfin وتأكد من ظهوره في Seerr.
- بعد ذلك، تحقّق من أن Seerr يوجّه الطلب إلى مثيل Sonarr أو Radarr الصحيح.
الأسئلة الشائعة حول Jellyfin وSeerr وJellyBridge
هل يحتاج Seerr إلى حاوية Docker خاصة به؟
نعم. Seerr تطبيق مستقل لإدارة الطلبات. أما JellyBridge فهو إضافة Jellyfin التي تتواصل معه.
هل ينبغي أن يظهر JellyBridge كتطبيق في متجر تطبيقات ZimaOS؟
ليس بالضرورة. يوزّع مشروع JellyBridge الحالي الإضافة باعتبارها إضافة لـ Jellyfin، ويتم تثبيتها عبر نظام مستودع الإضافات في Jellyfin.
لماذا يفشل localhost:5055 من JellyBridge؟
إذا كان Jellyfin وSeerr في حاويتين منفصلتين، localhost داخل Jellyfin يشير إلى حاوية Jellyfin. استخدم اسم خدمة مشتركًا ضمن شبكة Docker أو عنوان مضيف/عنوان IP يمكن لحاوية Jellyfin الوصول إليه فعليًا.
هل ينبغي أن أثبّت Jellyseerr أم Seerr؟
بالنسبة إلى عملية نشر جديدة حاليًا، يُعد Seerr المسار اللاحق المدعوم. لا تزال وثائق JellyBridge تتضمن مصطلحات Jellyseerr وملاحظات التوافق لأن الانتقال حديث، لذا تحقّق من توافق إصدار JellyBridge لديك مع إصدار Seerr الذي تثبّته.
هل يمكن تشغيل Sonarr وRadarr على خادم آخر؟
نعم. وصف أحد مستخدمي المجتمع هذا التخطيط تحديدًا. يحتاج Seerr فقط إلى الوصول عبر الشبكة إلى نقاط نهاية واجهة برمجة تطبيقات Sonarr/Radarr ومفاتيح API صالحة؛ ولا يلزم أن تشترك التطبيقات في الخادم الفعلي نفسه.
