كان الحل البديل الوارد في المصدر عمليًا لحزمة Immich واحدة في عام 2025، لكنه لا ينبغي تثبيته في دليل تحديث حالي. غيّر أحد مستخدمي المجتمع يدويًا الـ immich-server و immich-machine-learning وسوم الصور إلى v1.134.0. وقال صاحب المنشور الأصلي إن ذلك نجح في النهاية على نظام ZimaOS الأساسي لديه، لكنه لم ينجح على آلة افتراضية للاختبار.
انتقل Immich منذ ذلك الحين إلى v3، ويستخدم نموذج النشر المُصان لديه الآن حزمة Docker Compose كاملة، إلى جانب قيمة IMMICH_VERSION. وقد يؤدي تحديث وسم خدمة واحدة أو خدمتين فقط إلى إنشاء حزمة بإصدارات مختلطة عند تغيّر افتراضات قاعدة البيانات أو ذاكرة التخزين المؤقت أو تعلّم الآلة أو واجهة API.
عدّل مصدر 2025 وسوم خدمات Immich الفردية
أخبر المجتمع المستخدم بتغيير كلٍّ من الخادم وتعلّم الآلة
قال CogZog إن كليهما immich-server و immich-machine-learning ينبغي استخدام الوسم الجديد. وأكد المستخدم أنه غيّر كليهما، لكن آلة الاختبار الافتراضية ظلت على الإصدار الأقدم.
وصل إصدار ZimaOS الأساسي في النهاية إلى v1.134.0
لم يثبت المصدر وجود قاعدة تقضي بتحديث صورة قاعدة البيانات يدويًا
سأل beep عمّا إذا كان ينبغي أيضًا نقل قاعدة البيانات إلى وسم أحدث ومستقر. وكان ردّ المجتمع جوهريًا: «إذا لم يكن معطّلًا، فلا تُصلحه». كان ذلك رأيًا، وليس سياسة ترحيل خاصة بـ Immich.
إصدار Immich الحالي هو v3، مع مسار تحديث كامل لـ Compose
تم إصدار Immich v3.0.0 في يوليو 2026. وتقول الجهة المطوِّرة إن تحديث الحزمة المُصانة يتم عبر ضبط IMMICH_VERSION=v3 وتشغيل عملية السحب/إعادة الإنشاء المعتادة في Compose، مع مراجعة ملاحظات التغييرات العاجلة/الترحيل في v3 أيضًا.
راجع إرشادات إصدار Immich v3 الحالية.
المصدر الأساسي الحالي يوصي بحزمة Docker Compose الكاملة
توضح وثائق التثبيت الحالية لـ Immich للمستخدمين كيفية تنزيل إصدار docker-compose.yml و .env، ثم عيّن المواقع و IMMICH_VERSION. يجب أن يظل مسار قاعدة بيانات PostgreSQL على نظام ملفات محلي مدعوم بدلًا من مشاركة شبكية.
استخدم نموذج Immich Compose الحالي لعمليات النشر اليدوية/المخصصة.
بالنسبة إلى حزمة متجر تطبيقات ZimaOS، فضّل مسار تحديث التطبيق الحالي
يتضمن متجر تطبيقات ZimaOS 2.0 الحالي إدارة تحديثات التطبيقات المثبتة. إذا كان المتجر يوفر تحديثًا لـ Immich، فاترك لتعريف الحزمة تحديث حزمة الخدمات المتعددة بأكملها بدلًا من تعديل وسم خدمة واحدة بشكل مستقل.
أنشئ نسخة احتياطية قبل ترقية Immich الرئيسية
احمِ مكتبة الصور/الفيديو وحالة قاعدة البيانات/التطبيق معًا قبل تغيير إصدار رئيسي. فوجود مجلد مكتبة سليم وحده لا يكفي لإعادة بناء الألبومات والمستخدمين والبيانات الوصفية وحالة التطبيق.
تجنّب إنشاء حزمة Immich بإصدارات مختلطة
ليس Immich حاوية مستقلة واحدة. إذ يجري اختبار التطبيق وخدمة تعلّم الآلة وقاعدة البيانات والمكوّنات الداعمة الأخرى كطوبولوجيا إصدار منسّقة. وقد يؤدي تحديث صورة واحدة مع إبقاء أخرى مثبتة إلى حالات عدم توافق في واجهة API أو المخطط أو بدء التشغيل.
لم يعمل المصدر إلا بعد أن توافقت حزمة المستخدم بما يكفي لتشغيل الإصدار v1.134.0؛ وهذا لا يثبت أن خلط العلامات العشوائي آمن.
أبقِ PostgreSQL على وحدة تخزين محلية مدعومة
تنص متطلبات Immich الحالية على أن دليل بيانات PostgreSQL ينبغي أن يستخدم نظام ملفات محليًا وألا يكون على مشاركة شبكية. تكون حالة قاعدة البيانات عادةً صغيرة مقارنةً بمكتبة الصور، لكنها ضرورية للمستخدمين والألبومات والبيانات الوصفية وحالة التطبيق.
اعرف ما إذا كنت قد ثبّت حزمة ZimaOS أم حزمة Compose مخصصة
إذا كان Immich قد أتى من متجر تطبيقات ZimaOS، فاستخدم مسار التحديث الحالي للمتجر وراجع تغييرات حزمتها. وإذا استوردت ملف Compose الخاص بك، فأنت مسؤول عن تثبيت إصدار upstream، .envومسار قاعدة البيانات وخطوات الترحيل.
يؤدي الجمع بين تعديلات متجر التطبيقات وحزمة upstream تتم صيانتها يدويًا إلى زيادة صعوبة استكشاف الأخطاء وإصلاحها مستقبلًا.
أجرِ فحصًا تمهيديًا للترقية الرئيسية
- تأكد من وجود نسخة احتياطية حديثة لمكتبة الصور.
- انسخ قاعدة البيانات/حالة التطبيق احتياطيًا.
- سجّل الإصدار الحالي وتعيينات وحدات التخزين.
- اقرأ ملاحظات التغييرات الجذرية من المصدر الأصلي.
- تأكد من أن قرص النظام/AppData يحتوي على مساحة خالية كافية لسحب الصور وعمليات الترحيل.
تحقق من الإصدار قيد التشغيل والمهام بعد التحديث
لا تكتفِ بظهور عبارة «اكتمل الحفظ». افتح صفحة About/System في Immich، وتحقق من إصدار الخادم قيد التشغيل، وافحص سلامة الحاويات، ثم تحقق من عمليات الرفع والصور المصغرة ومهام تعلّم الآلة واتصال تطبيق الهاتف المحمول.
يوضح المصدر نفسه السبب: إذ إن تعديل الوسم لم يعنِ فورًا أن النسخة قيد التشغيل قد تحدّثت فعلًا.
الاسترجاع ليس دائمًا مجرد إعادة الوسم السابق
بمجرد أن يُرحّل إصدار رئيسي مخطط قاعدة البيانات أو حالتها، قد لا يكون الرجوع إلى إصدار أقدم للصورة مدعومًا. استخدم إرشادات الترحيل/الاسترجاع والنسخ الاحتياطية من المصدر الأصلي بدلًا من افتراض أن الوسم السابق زر تراجع شامل.
الأسئلة الشائعة حول تحديث Immich
هل نجحت طريقة الوسم اليدوية لعام 2025 في النظام الأساسي لمستخدم المصدر؟
نعم، في النهاية. لم تتصرف آلة الاختبار الافتراضية لديهم بالطريقة نفسها.
هل ينبغي لمستخدمي Immich الحاليين تحديث وسوم immich-server و machine-learning فقط؟
لا. تتم صيانة Immich v3 حاليًا كحزمة Compose متكاملة مع إرشادات للإصدار والترحيل.
هل وعدت IceWhale بتحديثات تلقائية لـ Immich في المصدر؟
لا. قال زيما-جيورجيو فقط إن الفريق سيناقش الطلب.
