يعرض Jellyfin بيانات قديمة بعد تغيير مسار التخزين
يعرض Jellyfin عادةً بيانات قديمة بعد نقل التخزين لأن الخدمة ترى المسار القديم، أو لا تستطيع قراءة نقطة التركيب الجديدة، أو لم تُكمل فحصًا صالحًا للموقع الجديد.
هل تعرض لوحة التحكم عناصر قديمة، أو عناصر مفقودة، أو مزيجًا من الاثنين؟ لا تحذف المكتبة أو تفرغ سلة المهملات أولًا. سجّل المسارين القديم والجديد بدقة، وحالة التركيب، وملكية الخدمة، ونتيجة الفحص حتى يمكن اختبار كل فرع دون إتلاف البيانات الوصفية.
تحقق من المسار الذي يستطيع Jellyfin رؤيته فعليًا
افحص المسار من داخل عملية Jellyfin أو الحاوية، وليس من موجّه أوامر المضيف فقط. تأكد من وجود نقطة التركيب بعد الإقلاع، ومن قدرة حساب الخدمة على عرض الملفات وقراءة ملف نموذجي، ومن تطابق تعيين الحاوية مع المسار المخزن في إعدادات المكتبة.
إذا كان المسار فارغًا أو يتعذر الوصول إليه، فأصلح نقطة التركيب أو UID/GID أو وحدة تخزين الحاوية أولًا. قد تؤدي نقطة تركيب التخزين التي تظهر بعد تسجيل الدخول اليدوي إلى جعل Jellyfin يفحص مجلدًا فارغًا عند بدء التشغيل.
قارن المسار القديم بالمسار الجديد في إعدادات المكتبة وفي سجل واحد من قاعدة البيانات. إذا ظل كلاهما موجودًا، فقد يعرض Jellyfin بشكل مشروع عنصرًا صالحًا وآخر يشير إلى مرجع قديم.
ميّز بين البيانات الوصفية القديمة وفشل الفحص
بعد أن يصبح المسار قابلًا للقراءة، شغّل فحصًا مضبوطًا وراقب السجلات بحثًا عن اسم المكتبة، وعدد العناصر، وأخطاء الأذونات، والملفات التي جرى تخطيها. قارن عنصرًا قديمًا معروفًا بملف أُضيف حديثًا. إذا اكتمل الفحص لكن ظلت المسارات القديمة موجودة، فلا تزال قاعدة البيانات تحتوي على الموقع السابق، أو أُضيف المسار الجديد دون إزالة المرجع القديم.
لا تعتبر الملصق المخزن مؤقتًا دليلًا على توفر ملف الوسائط. توضح قواعد مسارات التخزين أن نظام الملفات المركّب ومسار التطبيق عمليتان منفصلتان للتحقق.
استخدم فحصًا مضبوطًا واحدًا بعد تصحيح التعيين، ثم قارن عدد العناصر وملفًا معروفًا واحدًا. قد تؤدي عمليات إعادة الفحص المتكررة قبل إصلاح المسار إلى إنشاء حالة أكثر إرباكًا.
أصلح المشكلة فقط بعد إثبات الفرع الصحيح
أصلح تعيين المسار أو الأذونات، وأعد التشغيل مرة واحدة، ثم أعد الفحص. إذا كان مسار قاعدة البيانات خاطئًا، فحدّث موقع المكتبة بأصغر تغيير ممكن، وتحقق من عدد العناصر المتوقع قبل تنظيف الإدخالات القديمة. احتفظ ببيانات التطبيق وبنسخة احتياطية قبل إجراء أي عملية جماعية على البيانات الوصفية.
تثبت استعادة الحالة عندما تظل الخدمة ترى المسار الجديد بعد إعادة التشغيل، ويشغّل عميل نموذجي أحد العناصر، ولا يعيد الفحص الثاني إنشاء الحالة القديمة. صعّد المشكلة عندما يُبلغ نظام الملفات عن تلف، أو تحتوي قاعدة البيانات على مسارات متعارضة، أو تعود المشكلة بعد تركيب نظيف وإعادة التشغيل.
بعد الإصلاح، أعد التشغيل مع توفر نقطة التركيب عند الإقلاع، وكرر الفحص. لا تُحل البيانات القديمة حتى يظل المسار نفسه ظاهرًا بعد إعادة التشغيل.
صعّد المشكلة عند استمرار ظهور المسار
أبقِ التعيين الذي تم إصلاحه عندما يستخدم كل من إعادة التشغيل النظيفة، وفحص واحد، وتشغيل عنصر نموذجي المسار الجديد دون إعادة إنشاء الإدخال القديم.
أوقف التنظيف عندما يعود المسار القديم، أو تحتوي قاعدة البيانات على هويات متعارضة، أو تتغير نقطة تركيب التخزين بين عمليات الفحص. احتفظ بقاعدة البيانات وخريطة المسارات الحالية أولًا.
صعّد المشكلة إلى استعادة نسخة احتياطية أو إصلاح خاص بقاعدة البيانات عندما يكون نظام الملفات سليمًا، لكن تستمر المراجع القديمة بعد تعيين نظيف وإعادة التشغيل.
المنتجات الموصى بها
الدعم والنصائح
المزيد للقراءة
كيفية تحسين اتصالات قاعدة بيانات Jellyfin للحاويات المتزامنة
ابدأ بمالك واحد لقاعدة البيانات، وقِس سلوك القفل في SQLite؛ ولا تُضف واجهة خلفية مختلفة إلا عندما يبرّر التزامن والاسترداد هذا التعقيد.
كيفية منع تكرار المهام أو عمليات الاستيراد في Jellyfin
ينشأ العمل المكرر عادةً بسبب تداخل أدوات الجدولة أو وجود أكثر من جهة كتابة؛ عيّن مسؤولًا واحدًا، ومسارًا واحدًا، وفحصًا واحدًا لاكتمال العمل.
كيفية إصلاح Jellyfin بعد امتلاء وحدة تخزين قاعدة البيانات الخاصة به
أوقف عمليات الكتابة، وحافظ على قاعدة البيانات وملفات WAL، وحرّر مساحةً دون حذف الحالة عشوائيًا، ثم تحقّق من السلامة والتكامل ومن عبء العمل الأصلي.
