واجه مستخدم ZimaOS رسالة Jellyfin «فشل التشغيل لأن الوسائط غير مدعومة من هذا العميل» مع الأفلام وملفات MP3 على كل جهاز تم اختباره. وبما أن الرسالة أشارت إلى دعم الوسائط، فقد شملت الشكوك الأولية ذاكرة التخزين المؤقت للمتصفح وبرامج الترميز وتحويل الترميز والأذونات.
روت السجلات قصة مختلفة. فقد بدأ Jellyfin تشغيله بشكل صحيح، وعثر على FFmpeg، وأتاح عدة وحدات لفك ترميز الصوت والفيديو، وأفاد بأن أذونات أجهزة الرسومات سليمة. وعند بدء التشغيل، سجّل الخادم مرارًا تعذّر العثور على الملف. وتتبع عضو المجتمع gelbuilding هذه الرسالة إلى مسار وحدة تخزين Docker الذي ثبّت مجلد Music فقط في /Media، بينما كانت مكتبات Jellyfin لا تزال تتوقع ملفات ضمن /Media/Music و/Media/Movies و/Media/TV Shows.
خطأ التشغيل الذي ظهر لكل عميل
أفاد MrPenguin بأن Jellyfin وإعداد DNS الخاص بالمستخدم ظلا مستقرين بعد جلسات دعم سابقة. كما أُنشئت نسخة احتياطية. وأثر العطل الجديد في الأفلام والموسيقى من أي جهاز، ما جعل من المنطقي التساؤل عما إذا كان السبب هو ذاكرة التخزين المؤقت أو دعم برامج الترميز أو أذونات الملفات.
يمكن للمستخدمين الذين يميّزون بين قيود العتاد وأعطال مسارات التخزين الرجوع إلى متطلبات Jellyfin للعتاد. لكن في هذه الحالة، جاءت الأدلة الحاسمة من أسطر تعذّر العثور على الملف، لا من رسالة العميل.
أظهرت السجلات ملفًا مفقودًا، وليس برنامج ترميز غير مدعوم
حدّد سجل بدء التشغيل أن Jellyfin 10.10.7 يعمل على Ubuntu 24.04.3 LTS داخل حاوية x64 LinuxServer.io. كما أظهر توفر Jellyfin FFmpeg 7.1.2، والعديد من وحدات فك الترميز والترميز، وواجهات تسريع العتاد، بما في ذلك CUDA وVA-API وQSV وDRM وOpenCL وVulkan.
كما كانت فحوصات جهاز الرسومات إيجابية:
أذونات /dev/dri/renderD128 سليمة
أذونات /dev/dri/card0 سليمةثم أنتج طلب التشغيل السطر الذي غيّر التشخيص:
تعذّر العثور على الملف '/Media/Music/Beyonce/Unknown Album/Single Ladies ... .mp3'ملف مفقود Folder.jpg ظهر المسار أيضًا. وهذا يعني أن قاعدة بيانات Jellyfin كانت لا تزال تشير إلى مسارات مكتبة غير موجودة داخل الحاوية الحالية. ولم يكن توافق برامج الترميز ليساعد عندما يتعذر على الخادم فتح الملف المصدر أصلًا.
يوصي دليل Jellyfin الرسمي لاستكشاف الأخطاء وإصلاحها أيضًا ببدء تشخيص التشغيل بسجلات الخادم وFFmpeg بدلًا من الاعتماد فقط على الرسالة التي يعرضها العميل.
Commands Used to Check the Container Paths
الأوامر المستخدمة للتحقق من مسارات الحاوية
طلب Gelbuilding من الكاتب أيضًا تأكيد ما يمكن لحاوية Jellyfin قيد التشغيل رؤيته فعليًا:
docker exec -it jellyfin ls -lah /Media
docker exec -it jellyfin ls -lah "/Media/Music" | docker exec -it jellyfin ls -lah "/Media/Music/Beyonce/Unknown Album"head
كما طلب الرد أيضًا قائمة عمليات تحميل Docker النشطة: | docker inspect jellyfin --format '{{json .Mounts}}'sed 's/},/},\n/g'
تجيب هذه الفحوص عن سؤالين مختلفين. تُظهر أوامر docker exec ما إذا كانت المسارات موجودة من منظور Jellyfin، بينما يُظهر docker inspect أدلة المضيف المعيّنة إلى الحاوية. وتوفّر وثائق حاويات Jellyfin الرسمية السياق الأوسع حول التهيئة المستمرة وتعيينات وحدات تخزين الوسائط.
مشكلة تعيين وحدة التخزين الفعلية
أظهر ناتج فحص الكاتب تعيين الوسائط هذا:
المضيف: /media/2 TB Master Drive/Media/Musicالحاوية: /Media أوصى Gelbuilding بتحميل المجلد الأصل يضع ذلك التعيين محتويات /Mediaمجلدًا مباشرةً داخل مسار الحاوية /Media/Music . ولا ينشئ /Media.
داخل الحاوية. لذلك أظهرت القائمة مجلدات الفنانين مباشرةً أسفل
في الوقت نفسه، حاول Jellyfin فتح مسارات تبدأ بـ:/Media/Music/.../Media/Movies/...
/Media/TV Shows/...
/Mediaتُظهر إعدادات تطبيق ZimaOS أن المجلد الفرعي Music معيّن مباشرةً إلى، بينما كان Jellyfin يتوقع مسارات منفصلة للموسيقى والأفلام والبرامج التلفزيونية أسفل دليل الحاوية.
The Mapping Change Suggested by the Community Media بدلًا من مجلد أوصى Gelbuilding بتحميل المجلد الأصل المجلد الفرعي:
غيّر من:
/media/2 TB Master Drive/Media/Music → /Media
غيّر إلى:
/media/2 TB Master Drive/Media → /Mediaعند تحميل المجلد الأصل، يمكن للحاوية إتاحة /Media/Music, /Media/Movies، و /Media/TV Shows باستخدام المسارات المخزّنة حاليًا في Jellyfin. يجب أن تتطابق المسافات وحالة الأحرف تمامًا؛ حتى فقدان مسافة واحدة في البرامج التلفزيونية يغيّر المسار.
بعد حفظ تعيين المجلدات المصحَّح، أوصى الرد بإعادة تشغيل Jellyfin وتشغيل لوحة المعلومات ← المكتبات ← فحص جميع المكتبات. يوضّح دليل مكتبات Jellyfin الرسمي موضع إدارة المكتبات في لوحة معلومات الخادم.
قبل تعديل التطبيق أو إعادة بنائه، احتفظ بنسخة احتياطية من الإعدادات الحالية. تشرح مقالة المتجر حول نسخ Jellyfin احتياطيًا قبل الصيانة سبب ضرورة التعامل مع حالة التطبيق ومكتبة الوسائط باعتبارهما جانبين منفصلين من جوانب الاسترداد.
أسطر السجل الأخرى لم تكن سبب التشغيل المؤكد
كما تضمن السجل رفض اتصال NextPVR على localhost:8866 وتحذير WebRootPath ثابت. قد تستحق هذه الإدخالات اهتمامًا منفصلًا فيما يخص البث التلفزيوني المباشر أو أصول الويب، لكن طلبات ملفات MP3 الفاشلة انتهت بأخطاء صريحة تفيد بعدم العثور على الملف. ولم تربط السلسلة فشل NextPVR بملفات الموسيقى والأفلام المفقودة.
وبالمثل، لم يكن هذا دليلًا على تعطل التسريع عبر الأجهزة. أظهر السجل توفر FFmpeg وبرامج ترميز متعددة. في حالة تحويل ترميز حقيقية، يُعد دليل البث المسرّع بالأجهزة على ZimaOS ذا صلة، لكن تغيير إعدادات التسريع لن يصلح عملية تثبيت Docker غير الصحيحة.
ما أكدته سلسلة المحادثة وما لم تؤكده
حدّد دليل السجل وفحص Docker بقوة أن السبب هو عدم تطابق تعيين المسار، وقدّم الرد الأخير تعيينًا مصححًا دقيقًا. ومع ذلك، انتهت السلسلة قبل أن ينشر MrPenguin اختبار تشغيل نهائيًا بعد تطبيق التغيير. لذلك ينبغي أن تصف الصفحة تصحيح التعيين بأنه الحل المدعوم بالأدلة الذي توصّل إليه المجتمع، لا نجاحًا مؤكدًا أبلغ عنه الكاتب الأصلي.
الأسئلة الشائعة حول تشغيل Jellyfin ومسارات Docker
لماذا قال Jellyfin إن الوسائط غير مدعومة عندما كان الملف مفقودًا؟
عرض العميل فشلًا عامًا في التشغيل. وقدّم سجل الخادم السبب المحدد: تعذّر على Jellyfin العثور على ملف المصدر في مسار المكتبة المخزّن في قاعدة بياناته.
هل ستؤدي إعادة تثبيت FFmpeg أو تغيير برامج الترميز إلى حل هذه الحالة؟
لا. أظهر السجل بالفعل FFmpeg الخاص بـ Jellyfin والعديد من برامج فك الترميز وبرامج الترميز. لا يمكن لبرنامج الترميز معالجة ملف مصدر غير موجود في مسار الحاوية.
لماذا كان بإمكان Jellyfin عرض عناصر المكتبة التي لم يعد قادرًا على تشغيلها؟
يمكن لـ Jellyfin الاحتفاظ بالبيانات الوصفية المفحوصة في قاعدة بياناته بعد تغيير نقطة التثبيت. يظل العنصر ظاهرًا، لكن يفشل التشغيل عندما يحاول Jellyfin فتح مسار نظام الملفات القديم.
هل ينبغي تثبيت مجلد Media الأب؟
بالنسبة إلى بنية المجلدات المعروضة في هذه السلسلة، نعم. يؤدي تعيين المجلد الأب على المضيف Media دليل المجلد إلى مسار الحاوية /Media يحافظ على المجلدات الفرعية Music وMovies وTV Shows التي تتوقعها المكتبات الحالية.
هل أكّد الكاتب الأصلي أن التشغيل نجح بعد ذلك؟
لا يظهر أي تأكيد نهائي في سلسلة المحادثة المعروضة. حدّد الرد الأخير عدم التطابق وقدّم التعيين المصحح وخطوات إعادة الفحص.
