المكتبات الخارجية في Immich: دليل لأرشيف صور للقراءة فقط

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

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

اختر بين رفع الملفات إلى التخزين المُدار والمكتبة الخارجية

متى ينبغي أن تظل مجلداتك الحالية المرجع الأساسي

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

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

تقدّم تجربة جايسن ماثاي العملية مثالًا ملموسًا: فهو يحتفظ بـ Elodie لتنظيم أرشيفه، ويستخدم مجلدات خارجية للقراءة فقط مع Immich. وتعتمد إعادة كتابة بيانات EXIF لديه على تكامل مخصص. اعتبر ذلك وصفًا لإعداده الخاص، وليس قدرة مدمجة أو نتيجة نشر نفّذته Optijara.

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

ميّز بين الأرشيف ومسار الحاوية ومالك المكتبة

الربط للقراءة فقط يقيّد الكتابة، ولا يحدد سياسة الوصول

لمجلدك على المضيف مسار. وقد يكون للمجلد نفسه مسار مختلف داخل الحاوية. ولا يحدد أيٌّ من المسارين لـ Immich الحساب الذي ينبغي أن يملك المكتبة. بحسب تعليمات الملكية والمسارات، تختار مالكًا واحدًا عند الإنشاء، ولا يمكنك تغييره بعد ذلك. ولا تجعل صلاحيات المسؤول كل مستخدم مالكًا.

تمنع اللاحقة :ro تطبيق Immich من حذف الملفات الأصلية أو كتابة الملفات الجانبية عبر ربط المصدر. لكن تطبيقات المضيف تظل قادرة على تغيير تلك الملفات. وتحتاج أذونات العرض والنسخ الاحتياطية إلى اهتمام مستقل. اتبع دليل الربط: أضف ربطًا خارجيًا منفصلًا، وأبقِ ${UPLOAD_LOCATION}:/data، واحتفظ بجميع روابط التخزين المُدار الحالية.

فيما يلي مسار القراءة المقترح. لم تُنفّذ أي عملية نشر لإعداد هذا المقال.

تظل قاعدة البيانات والملفات المُولّدة بحاجة إلى تخزين للتطبيق يسمح بالكتابة. ربط المصدر وحده هو المخصص للقراءة فقط.

نفّذ تجربة محدودة لأرشيف للقراءة فقط

اربط مجلد عينة وحدد مساره

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

1. اربط. أضف المُدخل التالي إلى قائمة volumes في خدمة immich-server الحالية. استبدل العنصر النائب المكتوب بأحرف كبيرة بالمسار المطلق لمجلد العينة على المضيف. احتفظ بكل ربط قائم للتخزين المُدار. هذا المقتطف التوضيحي غير مكتمل ولم يُنفّذ؛ ولا يصلح ملف Compose مستقلًا.

- /ABSOLUTE/HOST/SAMPLE:/mnt/photos-source:ro

يتطلب تطبيق التغيير إجراءً منفصلًا من المشغّل. اتبع الدليل الرسمي لتحديث روابط المجلدات. ولا يُبلّغ هذا المقال عن تنفيذ إعادة تشغيل لأي حاوية.

1. حدد المسار. تأكد من إمكانية قراءة /mnt/photos-source داخل كل حاوية خادم أو عامل منفصل معنيّة. تحقّق من الأذونات الفعلية. تشير إرشادات استكشاف المشكلات وإصلاحها إلى غياب روابط المجلدات لدى العمال ومشكلات الروابط الرمزية، لذا لا تفترض أن رابطًا رمزيًا يعبر بين نقاط الربط سيعمل.

أنشئ المكتبة ضمن الإدارة > المكتبات الخارجية، واختر المالك المقصود. أدخل /mnt/photos-source بوصفه مسار الاستيراد. المسار /ABSOLUTE/HOST/SAMPLE يخص المضيف؛ أما Immich فيحتاج إلى المجلد الظاهر داخل حاوياته. توقّف إذا تعذّر الوصول إلى ذلك المجلد.

امسح وتحقّق قبل التوسّع

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

1. تحقّق. سجّل ما تلاحظه. الجدول التالي خطة قياس مقترحة، وليس دليلًا على اختبارات أُنجزت.

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

يمكن لملاحظة تخطيط موجزة أن تسجّل المقصود بصورة منفصلة عن الملاحظات الفعلية. تحدد قيمة مسار الاستيراد أدناه نوع المسار المطلوب؛ أدخل المجلد الفعلي /mnt/photos-source في Immich. مثال JSON هذا ملاحظة، وليس إعدادًا للتطبيق أو إثباتًا للنجاح.

{
  "workflow": "mount-map-scan-verify",
  "import_path_kind": "container-visible",
  "source_access": "read-only",
  "status": "proposed-unexecuted"
}

افهم عمليات المسح ومهام الخلفية دون افتراض مزامنة فورية

اكتشاف الملفات لا يعني اكتمال المعالجة

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

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

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

إعادة المسح والجداول الزمنية والمراقبة التجريبية

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

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

تعرّف إلى ما تستطيع ملفات XMP الجانبية حفظه وما لا تستطيع

الحقول المدعومة لا تمثّل المكتبة بأكملها

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

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

بالنسبة إلى IMG_0001.jpg، يفضّل Immich الملف IMG_0001.jpg.xmp على البديل IMG_0001.xmp عند وجود كليهما. وتدخل البيانات الوصفية المستخرجة المحددة إلى قاعدة البيانات. تربط مهمة DISCOVER الملفات الجانبية المكتشفة حديثًا بالوسائط التي لا يرتبط بها ملف جانبي بالفعل؛ وتعيد SYNC قراءة الملفات الجانبية المرتبطة بعد التغييرات الخارجية. ولا توفّر أيٌّ من المهمتين آلية شاملة لحل التعارضات بين أدوات التحرير.

تحذير تعديل البيانات الوصفية عند القراءة فقط

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

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

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

تحقّق من التصفّح بملفات معروفة قبل الاعتماد على البحث الذكي

استخدم أسماء الملفات والمجلدات والتواريخ للفحص بالعينة

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

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

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

تجنّب الأخطاء التي تفصل الملفات عن سجلّها في المكتبة

نقل ملف ليس مجرد تغيير اسم بلا تبعات في قاعدة البيانات

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

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

يمكن تجنّب عدة أخطاء شائعة:

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

كرر التجربة المحدودة كلما تغيّر افتراض أساسي.

حدد الحدود قبل استخدام أرشيف أكبر

التخزين والمشاركة والصيانة المستمرة

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

الفهرسة لا تضيف نسخة من ملفاتك الأصلية. تحتوي تفريغات قاعدة البيانات على بيانات وصفية، لا صور أو فيديوهات، لذا احمِ مجلدات المصدر الخارجية بصورة منفصلة عن بيانات Immich المُدارة. وإجراءات النسخ الاحتياطي والاستعادة خارج نطاق هذا الدليل.

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

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