لماذا يفوّت فحص مكتبة الوسائط بعض الأفلام الموجودة على مشاركة مُثبّتة؟

إيفا وونغ هي كاتبة تقنية و ومهندسة هاوية في ZimaSpace. مهووسة بالتكنولوجيا مدى الحياة ولديها شغف بالمختبرات المنزلية والبرمجيات مفتوحة المصدر، تتخصص في تبسيط المفاهيم التقنية المعقدة إلى أدلة عملية وسهلة الفهم. تؤمن إيفا بأن الاستضافة الذاتية يجب أن تكون ممتعة وليست مخيفة. من خلال دروسها، تمكّن المجتمع من تبسيط إعدادات الأجهزة، بدءًا من بناء أول نظام تخزين شبكي NAS وحتى إتقان حاويات Docker.

تفشل عملية فحص الوسائط في العثور على الأفلام عندما يتعذر على الخادم اجتياز المسار الموصول، أو عندما يرى مسارًا مختلفًا، أو يرفض الملفات أثناء التعرف عليها.

في جهاز NAS منزلي، قد تعني عبارة «المشاركة موصولة» فقط أن غلاف النظام المضيف يستطيع رؤية دليل. فقد تكون عملية خادم الوسائط داخل Docker، أو تستخدم مسار ربط مختلفًا، أو تعمل بمعرّف UID مختلف، أو تفحص نقطة تحميل محلية فارغة خلّفها انقطاع المشاركة البعيدة. شخّص فيلمًا واحدًا مفقودًا بدءًا من التخزين وصولًا إلى التطبيق، بدلًا من تشغيل عمليات فحص كاملة مرارًا، إذ لا يمكنها إصلاح مشكلة في المسار أو الأذونات أو التسمية أو محلّل الملفات.

أثبت أن المشاركة الموصولة تحتوي على الفيلم الآن

تحقق من مسار مصدر المكتبة الدقيق من المضيف، واعرض فيلمًا مفقودًا واحدًا باسمه الكامل. أكّد نوع نظام الملفات، ومصدر التحميل، وخيارات التحميل، والمساحة الحرة، وعددًا معروفًا من الملفات، بدلًا من الاكتفاء بالثقة في أن دليل نقطة التحميل موجود فحسب.

قد تترك مشاركة الشبكة المنقطعة دليلًا عاديًا فارغًا في نقطة التحميل نفسها، مما يسمح بانتهاء الفحص دون العثور على أي وسائط. يصف تقرير في Jellyfin عملية فحص بدت ناجحة، رغم أن المسار المستهدف أظهر صفرًا من العناصر.

اقرأ جزءًا صغيرًا من الملف المفقود، واعرض الأدلة الأصلية له. إذا كانت المشاركة غير موجودة، فأعد تحميلها قبل الفحص، واضبط خدمة الوسائط بحيث لا تبدأ إلا بعد توفر نظام الملفات البعيد. لا تضف نقطة التحميل المحلية الفارغة كمسار مكتبة ثانٍ.

تحقق من المسار من داخل حاوية خادم الوسائط

ادخل إلى الحاوية قيد التشغيل وافحص المسار الدقيق المكوّن في المكتبة. قد يستخدم المضيف /mnt/media/movies بينما تراه الحاوية على أنه /media/movies؛ والمسار داخل الحاوية وحده هو الذي يجب إدخاله في التطبيق.

قد تظل الوسائط الجديدة غير مرئية حتى مع استمرار تشغيل العناصر الأقدم إذا لم تعد الحاوية قيد التشغيل ترى مسار المضيف الحالي، أو إذا كانت تتلقى محتويات تحميل قديمة. أبلغت إحدى حالات Jellyfin بأن الوسائط الجديدة لم تظهر بعد عمليات فحص متكررة.

قارن تعريف تحميل الحاوية بالتحميل الفعلي الذي يعرضه وقت التشغيل. تحقق من أن مصدر الربط هو المشاركة الموصولة الفعلية، وليس دليلًا رئيسيًا أو مسارًا قديمًا. أعد إنشاء الحاوية فقط بعد التأكد من عدم تغيير عمليات تحميل الإعدادات الدائمة وقاعدة البيانات.

اختبر اجتياز الأدلة باستخدام مستخدم الخدمة الفعلي

استخدم UID وGID الخاصين بخادم الوسائط لعرض كل دليل من جذر المكتبة حتى ملف الفيلم. لا تكفي قراءة الملف؛ إذ تحتاج العملية أيضًا إلى إذن التنفيذ في كل دليل أصلي لاجتياز المسار.

تحدد إحدى مشكلات ظهور مكتبة Jellyfin أن غياب أذونات القراءة والتنفيذ على الأدلة سبب مباشر لعدم ظهور العناصر. والحد الفاصل المهم هو إذن اجتياز الدليل، وليس ما إذا كان حساب المسؤول يستطيع تصفح المشاركة.

أصلح أضيق قاعدة ملكية أو مجموعة أو ACL تمنح الخدمة وصولًا للوسائط للقراءة فقط. يوفّر دليل ZimaSpace حول الأذونات بعد نقل الملفات سير العمل المرتبط عندما تعمل المشاركة عبر SMB ولكنها لا تعمل داخل الحاوية.

قارن فيلمًا مفقودًا بفيلم تم اكتشافه

اختر مجلدين تحت المشاركة الموصولة نفسها: مجلد فيلم تكتشفه المكتبة، ومجلد فيلم لا تكتشفه. قارن اسم الملف، والامتداد، وعمق المجلد، وحالة الأحرف، والأحرف الخاصة، وحجم الملف، واستخدام الروابط الرمزية، والأذونات، والطوابع الزمنية، وما إذا كان الملف مكتملًا.

تكون بعض أعطال الفحص خاصة بعنصر معين، لا بالمشاركة بأكملها. أظهرت حالة مُبلّغ عنها في Jellyfin أفلامًا لم تظهر إلا بعد نقلها إلى مجلد آخر، مما يوضح سبب فائدة المقارنة المنضبطة بين عنصر مكتشف وآخر مفقود أكثر من إعادة فحص عامة جديدة.

أعد تسمية عنصر اختباري منسوخ أو انقله إلى بنية بسيطة مثل Movies/Movie Name (Year)/Movie Name (Year).mkv. إذا ظهرت النسخة، فافحص تسمية المجلد الأصلي أو علاماته المخفية أو أذوناته أو سلوك نظام الملفات قبل تغيير المكتبة بأكملها.

اقرأ سجل الفحص عند أول مسار مفقود

ابدأ فحصًا مستهدفًا، وتابع السجل منذ لحظة دخول الفاحص إلى الدليل المتأثر. ابحث عن رسائل رفض الوصول، وعدم العثور على الدليل، وأخطاء الإدخال والإخراج، والملفات غير المدعومة، وفشل الاستكشاف، وقيود قاعدة البيانات، وأخطاء مزود البيانات الوصفية، وإلغاء الفحص.

قد يتوقف الفحص الكامل أو يتجاوز العمل بعد استثناء على مستوى المسار، بينما لا تعرض واجهة المستخدم سوى مكتبة غير مكتملة. وثّقت Jellyfin عمليات فحص تأثرت باستثناء دليل مفقود، مما يجعل الخطأ الأول أهم من مؤشر التقدم النهائي.

أصلح أقدم خطأ قابل للتكرار، ثم أعد تشغيل أصغر فحص ممكن. لا تحذف قاعدة بيانات المكتبة أو البيانات الوصفية أو ذاكرة التخزين المؤقت قبل إثبات ظهور المسار وصحة الأذونات؛ فقد تؤدي عمليات إعادة الضبط المدمرة إلى إزالة أدلة التشخيص دون إصلاح المشاركة الموصولة.

تحقق من الإصلاح باستيراد مضبوط وإعادة تشغيل

أضف فيلمًا اختباريًا واحدًا باسم واضح إلى المشاركة نفسها، وافحص المكتبة المتأثرة، وتأكد من ظهوره مرة واحدة بالمسار والبيانات الوصفية الصحيحين. ثم أعد تشغيل الحاوية وأعد تشغيل المضيف.

بعد إعادة التشغيل، تأكد من تحميل المشاركة البعيدة قبل بدء خدمة الوسائط، ومن أن الحاوية ترى المسار المملوء، وأن مستخدم الخدمة يستطيع اجتيازه، وأن الفاحص يكتشف ملفًا اختباريًا مضافًا حديثًا دون تغييرات يدوية في الأذونات.

لا يكتمل الإصلاح إلا عندما تظهر الأفلام المفقودة الفعلية من موقع التحميل المقصود، ولا يجري فحص دليل احتياطي فارغ، وتستمر النتيجة بعد إعادة التحميل، وإعادة إنشاء الحاوية، وإعادة تشغيل المضيف. أزل النسخة الاختبارية بعد التأكد من استقرار مسار المكتبة الأصلي.

الدعم والنصائح

المزيد للقراءة

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.