يمكن أن تكون بيانات Immich القديمة بعد تغيير مسار التخزين ناتجة عن ثلاثة أسباب مختلفة لا ينبغي خلطها: نقل جذر الوسائط المُدار، أو تغيير مسار استيراد مكتبة خارجية، أو استخدام عميل لا يزال يعرض حالة مخزنة مؤقتًا. تستطيع الإصدارات الحديثة من Immich التوفيق بين موقع وسائط مُدار تم نقله عندما يظل إعداد موقع الوسائط وتركيب وحدة التخزين متسقين، بينما قد تظل عمليات نقل المكتبات الخارجية تُعامل على أنها هويات أصول جديدة.
احتفظ بالمسار القديم وقاعدة البيانات قبل إعادة الفحص. أثبت أولًا المسار الذي تراه الحاوية قيد التشغيل، ثم حدّد ما إذا كان سجل Immich على الخادم غير صحيح أم أن عميلًا واحدًا فقط يعرض حالة قديمة. يحدد هذا الفرق ما إذا كان ينبغي إصلاح التركيب، أو استعادة مسار ثابت تراه الحاوية، أو إعادة فحص مجموعة فرعية للاختبار، أو مسح ذاكرة التخزين المؤقت للعميل فقط.
ميّز بين نقل جذر الوسائط المُدار ونقل المكتبة الخارجية
إذا غيّرت موقع المضيف للتحميلات التي يديرها Immich، فتحقق من تغيير إعداد موقع الوسائط الفعلي وتركيب المضيف إلى الحاوية معًا. لا ينبغي تشخيص نقل الوسائط المُدارة بالطريقة نفسها التي يُشخَّص بها تغيير اسم مسار استيراد مكتبة خارجية.
تُعد خريطة حالة Immich المستمرة من ZimaSpace مفيدة هنا، لأن قاعدة البيانات ومسارات نظام الملفات تشكل معًا حدًا واحدًا للاسترداد. لا تكفي الملفات الصحيحة على المضيف إذا كانت الحاوية مركّبة في مكان آخر.
إذا كان جذر الوسائط المُدار غير متطابق، فصحّح البيئة وربط وحدة التخزين أولًا، ثم أعد تشغيل الخدمة قبل تشغيل مهام المكتبة. وإذا كان المسار المتغير يخص مكتبة خارجية، فأبقِ قاعدة البيانات سليمة واختبر هذا المسار بشكل منفصل.
حافظ على ثبات مسار الحاوية للمكتبة الخارجية متى أمكن
بالنسبة إلى مكتبة خارجية، يكون نقل التخزين على جانب المضيف أكثر أمانًا عندما يظل مسار الاستيراد الذي تراه الحاوية دون تغيير. وإذا تغيّر المسار المعروض على Immich، فسجّل مجموعة صغيرة من معرّفات الأصول والألبومات والأشخاص والمسارات القديمة قبل الفحص، حتى تتمكن من معرفة ما إذا كانت الأصول الحالية قد أُعيد ربطها أم أُنشئت من جديد.
وصف تقرير عن تغيير مسار مكتبة خارجية في Immich ملفات منقولة عوملت كأصول جديدة، مع إعادة معالجة وفقدان للعلاقات الخاصة بـ Immich. ورغم أن هذه حالة مرتبطة بإصدار معين، فإنها تدعم القاعدة الاحترازية التي تفيد بأن تغيير مسار مكتبة خارجية ليس إعادة تسمية شفافة تلقائيًا.
إذا ظهرت مجموعة اختبار فرعية كأصول جديدة، بينما أصبحت السجلات القديمة مفقودة أو في سلة المهملات، فأوقف إعادة الفحص الكامل. استعد المسار القديم الذي تراه الحاوية إن كان ذلك عمليًا، أو استخدم نهج ترحيل مناسبًا للإصدار؛ ولا تُعد كتابة مسارات قاعدة بيانات الإنتاج يدويًا من دون نسخة احتياطية مختبرة.
لا تخلط بين هذا المسار وترحيل قالب التخزين لملفات Immich المُدارة. قد تبدو الأعراض متشابهة في المخطط الزمني، لكن ملكية الملفات ومسار الترحيل المدعوم مختلفان.
افصل بين مسارات الخادم المخزنة وذاكرة التخزين المؤقت للعميل
افحص الأصل المعروف نفسه من عميل الويب ومن عميل آخر تمت مصادقته، ثم قارن ذلك بسجلات الخادم أو بالمسار الذي يراه الخادم. إذا كانت مهام الخادم لا تزال تشير إلى المسار القديم، فلن يؤدي مسح ذاكرة المتصفح المؤقتة إلى إصلاح السجل الأساسي.
أظهرت مشكلة لاحقة في بيانات المسار القديم لدى Immich استمرار المعالجة في الإشارة إلى مسار سابق لمكتبة خارجية بعد تغيير اسمه. وهذا دليل قوي على ضرورة فحص مسارات المهام قبل إلقاء اللوم على واجهة الهاتف أو الويب.
إذا كان مسار الخادم صحيحًا لكن عرض ويب واحدًا فقط يعرض حالة قديمة، فحدّث ذاكرة التخزين المؤقت لذلك العميل أو امسحها، ثم أعد اختبار الملف الأصلي. قد تجعل الصور المصغرة المخزنة مؤقتًا وحالة العميل القديمة خادمًا سليمًا يبدو معطلًا، كما قد تجعل المعاينة المخزنة مؤقتًا مسار خادم معطلًا يبدو سليمًا.
أصلح أصغر حدّ للمسار وتحقق من إعادة فحص مضبوطة
أجرِ تصحيحًا واحدًا قابلًا للعكس: زامن إعداد الوسائط المُدارة مع التركيب، أو استعد مسار الحاوية السابق للمكتبة الخارجية، أو صحّح مسار الاستيراد، أو امسح ذاكرة التخزين المؤقت لعميل واحد. خذ نسخة احتياطية من قاعدة البيانات قبل أي إجراء قد يؤدي إلى إعادة اكتشاف مكتبة كبيرة.
شغّل أصغر إعادة فحص عملية وراقب ما إذا كانت السجلات الحالية تظل مرتبطة، وتتوقف أخطاء المسار القديم، ولا تظهر أصول قديمة وجديدة مكررة. ثم افتح عينات من النسخ الأصلية، وتحقق من علاقات الألبومات والأشخاص، ونفّذ بحثًا، وأعد تشغيل الحزمة.
صعّد المشكلة إذا ظلت سجلات المسارين القديم والجديد نشطة معًا، أو أُعيدت معالجة مكتبة خارجية كبيرة على نحو غير متوقع، أو اختفت العلاقات بينما ظلت النسخ الأصلية قابلة للقراءة. احتفظ بخريطة التركيب الدقيقة قبل التغيير وبعده، وإصدار Immich، ومعرّفات الأصول المتأثرة، وسلوك حالة الأحرف في نظام الملفات، والطابع الزمني للنسخة الاحتياطية لقاعدة البيانات.
الدعم والنصائح
المزيد للقراءة

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

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

كيفية إصلاح Immich بعد امتلاء وحدة تخزين قاعدة البيانات الخاصة به
لا تحذف سجلات WAL الخاصة بـ PostgreSQL لتحرير المساحة مطلقًا. أوقف عمليات الكتابة في Immich، وحافظ على حالة قاعدة البيانات، وأضف سعة تخزين آمنة،...

