إذا كان إصدار Immich الظاهر في ZimaOS أقدم من إصدار Immich المنشور upstream ولم يعرض متجر التطبيقات زر تحديث، فهناك طرق لتحديث الحاويات يدويًا، لكن الطريقة الصحيحة تعتمد على حزمة Immich التي ثبّتها في ZimaOS. أكدت سلسلة نقاش IceWhale Community في ديسمبر 2025 إمكانية تغيير وسم الصورة ببساطة لحزمة BigBear Immich، بينما أظهرت الردود اللاحقة أن الحيلة نفسها لم تُحدّث كل حزم Immich الأخرى بشكل موثوق.
كانت طريقة المجتمع هي فتح إعدادات التطبيق وتغيير immich-server و immich-machine-learning وسوم الصور إلى الإصدار المستهدف، مع ترك علامتَي تبويب قاعدة البيانات وRedis دون تغيير. أكد صاحب المنشور الأصلي أن التحديث تم بسلاسة، ثم انتقل مستخدم آخر لـ BigBear بنجاح من v2.3.1 إلى v2.4.1. ومع ذلك، تتطلب وثائق Immich الحالية من المسؤولين قراءة ملاحظات الإصدار، والنسخ الاحتياطي لقاعدة البيانات، ومراعاة تغييرات Compose وقاعدة البيانات قبل الترقية. لذلك لا ينبغي التعامل مع تغيير الوسوم يدويًا على أنه زر تحديث «آمن دائمًا» وعام.
حدّد أولًا حزمة Immich التي ثبّتها
تتضمن سلسلة النقاش مسارين اثنين على الأقل للنشر:
- BigBear Immich: أفاد عدة مستخدمين بأن تعديل وسوم الصور في ZimaOS أدى بنجاح إلى تشغيل تحديث.
- حزمة Original/non-BigBear: أفاد مستخدم لاحق بأنه ظل عالقًا عند الإصدار v2.1.0 حتى بعد محاولة تغيير إصداري الخادم والتعلّم الآلي يدويًا.
افتح إعدادات تطبيق Immich في ZimaOS وسجّل أسماء الصور الحالية، والوسوم، وتعيينات وحدات التخزين، وصورة قاعدة البيانات، ومتغيرات البيئة قبل تغيير أي شيء. لا تفترض أن التعليمات المكتوبة لتعريف BigBear تتوافق مع قالب آخر في متجر التطبيقات.
تحديث وسم BigBear الذي نجح لدى المجتمع
كانت إجراءات المجتمع الناجحة كما يلي:
- في لوحة معلومات ZimaOS، افتح قائمة النقاط الثلاث الخاصة بتطبيق Immich.
- اختر Settings.
- افتح علامة تبويب immich-machine-learning.
- غيّر Tag الخاص بصورته إلى إصدار Immich المطلوب.
- افتح علامة تبويب immich-server.
- اضبط وسم الإصدار نفسه هناك.
- اترك علامتَي تبويب قاعدة البيانات وRedis دون تغيير، ما لم تتطلب ملاحظات الإصدار صراحةً تغييرًا في قاعدة البيانات أو الحاوية.
- احفظ الإعدادات ودَع ZimaOS يعيد إنشاء الحاويات المتأثرة أو يسحبها.
في وقت نشر الرد الأصلي، كان وسم المثال:
v2.3.1ذلك الإصدار تاريخي. وقد حدّث مستخدم آخر لاحقًا إلى v2.4.1، وذُكر في ردٍّ في أبريل 2026 v2.7.4. لا تنسخ أيًا من أرقام الإصدارات القديمة اليوم. اختر الإصدار المستهدف فقط بعد التحقق من ملاحظات إصدار Immich الحالية ومسار الترقية لديك.
ما أكده صاحب المنشور الأصلي
بعد تلقي تعليمات وسم BigBear، ردّ MikeFrizz بأن النصيحة كانت مفيدة جدًا وأن التحديث اكتمل بسلاسة. وهذه أقوى نتيجة مؤكدة في سلسلة النقاش الأصلية.
يؤكد ذلك الأسلوب المستخدم للحزمة وسياق الإصدار لدى صاحب المنشور الأصلي. لكنه لا يثبت أن تعديل وسمين يدويًا يكفي لكل إصدار رئيسي مستقبلي من Immich أو لكل حزمة ZimaOS.
لا تفترض أن وسم «latest» سيحل المشكلة
غيّر أحد المستخدمين الوسم إلى latest، لكن ZimaOS عاد مرارًا إلى الإصدار المثبّت سابقًا. ويتضمن النقاش بعد ذلك تخمينات، مثل تجربة الإصدار، لكن لا يوجد إصلاح شامل مؤكد المصدر يستند إلى أسماء الوسوم العامة هذه.
تستخدم وثائق Immich الحالية متغير إصدار صريحًا، وتدعم وسومًا تشير إلى الإصدارات الرئيسية ضمن سير عمل Docker Compose الخاص بها. أما في تطبيق ZimaOS المجمّع، فاستخدم تنسيق الوسم الذي يدعمه تعريف الحزمة والصورة الأصلية فعلًا. تجنّب ابتكار وسوم لمجرد أن اسمًا ما يبدو منطقيًا.
أنشئ نسخة احتياطية من Immich قبل تغيير الإصدارات
توصي وثائق Immich الحالية صراحةً بإنشاء نسخة احتياطية من قاعدة البيانات قبل الترقيات التي قد تتضمن عمليات ترحيل. كما تحتاج صورك ومقاطع الفيديو الخاصة بك إلى استراتيجية نسخ احتياطي مستقلة؛ فالنسخة الاحتياطية لقاعدة البيانات لا تحل محل مكتبة الوسائط نفسها.
استخدم دليل النسخ الاحتياطي والاستعادة في Immich الحالي قبل الانتقال اليدوي بين الإصدارات.
احرص على الأقل على الاحتفاظ بما يلي:
- نسخة احتياطية من قاعدة بيانات Immich؛
- بيانات مكتبة الوسائط/التحميل؛
- إعدادات تطبيق ZimaOS الحالية وتعيينات وحدات التخزين؛
- وسوم الصور الحالية؛
- وأي متغيرات بيئة أو مواقع تخزين مخصّصة.
اقرأ ملاحظات إصدار Immich قبل كل انتقال بين الإصدارات
تنص وثائق ترقية Immich الحالية على أنه ينبغي للمسؤولين مراجعة ملاحظات الإصدار بحثًا عن التغييرات غير المتوافقة قبل التحديث. وتتم العملية المعتادة باستخدام Docker Compose من المصدر كما يلي:
docker compose pull && docker compose up -dلكن بعد أن يصبح تعريف Compose ومتغيرات الإصدار مناسبين للإصدار المستهدف فقط.
راجع دليل ترقية Immich الحالي.
هذا مهم في ZimaOS لأن التطبيق المجمّع قد يتأخر ليس فقط في وسوم الصور، بل أيضًا في تعريفه المكافئ لـ Compose. قد يتضمن الإصدار الأحدث immich-server قد تتطلب الصورة تغييرات في قاعدة البيانات أو البيئة أو فحص الحالة أو وحدات التخزين، وقد لا تتضمنها حزمة أقدم.
حافظ على توافق إصدارات خادم Immich وتعلّم الآلة
غيّر المجتمع الوسوم لكليهما تحديدًا immich-server و immich-machine-learningتحذّر وثائق Immich الحالية كذلك من أن عدم تطابق الإصدارات بين الخادم الرئيسي ومكوّنات تعلّم الآلة قد يسبب أخطاءً أو عدم استقرار.
لا تُحدِّث أحدهما فقط لأنه صادف أن عرض صورة متاحة أولًا. تعامل معهما باعتبارهما إصدارًا واحدًا لتطبيق منسق، ما لم تنص وثائق الإصدار الحالي صراحةً على خلاف ذلك.
لا تغيّر وسم حاوية قاعدة البيانات عشوائيًا
كانت نصيحة المجتمع بترك تبويب قاعدة البيانات دون تغيير صائبة بالنسبة إلى تحديثات BigBear الفرعية المحددة التي نوقشت هناك. ولطبقة PostgreSQL في Immich عمليات ترحيل خاصة بها وقد تغيرت بمرور الوقت، بما في ذلك الترحيل من إضافات المتجهات الأقدم إلى VectorChord.
- لا ترفع إصدار صورة قاعدة البيانات لمجرد جعل جميع الوسوم تبدو متشابهة رقميًا.
- لا تفترض أن صورة قاعدة البيانات يجب ألا تتغير أبدًا؛ فإذا تطلبت ملاحظات إصدار Immich الحالية ترحيلًا لقاعدة البيانات/Compose، فاتبع مسار الترحيل الموثق لذلك.
ماذا لو ظل تطبيق Immich الأصلي على ZimaOS بإصدار قديم؟
ذكر ردّ في مارس 2026 أن المستخدم لم يكن يشغّل إصدار متجر تطبيقات BigBear، وظل عالقًا على Immich v2.1.0 حتى بعد محاولة تحديث صور التعلّم الآلي والخادم يدويًا. ولا يتضمن الموضوع حلًا مؤكدًا لنشر الحزمة الأصلية لدى ذلك المستخدم.
هذا حدّ مهم: إذا لم يؤدِّ تغيير وسوم الصور يدويًا إلى تحديث التطبيق، فتوقّف عن تكرار العملية نفسها. قارن تعريف الحاويات الحالي للحزمة بمتطلبات Compose الحالية لـ Immich، وفكّر في الترحيل إلى حزمة ZimaOS مُصانة فقط بعد إجراء نسخة احتياطية والتأكد من مسارات البيانات.
لا تُزل حزمة Immich العاملة قبل أن تعرف مكان تخزين وحدات تخزين قاعدة البيانات والوسائط.
لماذا اقترح مستخدمو المجتمع حزمة Immich من BigBear
أوصى الرد الأول بتطبيق Immich من BigBear لأنه كان يُحدَّث عادةً ليواكب الإصدارات الأولية بدرجة أكبر. كما اختُبرت تعليمات تعديل الوسوم التي نجحت لاحقًا صراحةً على BigBear.
هذا لا يجعل «إعادة تثبيت BigBear» مسار ترحيل آمنًا بنقرة واحدة لمكتبة موجودة. فقد تستخدم الحزمة الجديدة أسماء وحدات تخزين أو أدلة بيانات أو صور قواعد بيانات أو متغيرات بيئية مختلفة. تعامل مع ترحيل الحزمة كعملية منفصلة عن ترقية المكدس الحالي.
توخَّ الحذر مع مُحدِّثات الحاويات التلقائية
اقترح ردّ من المجتمع في أبريل 2026 استخدام Tugtainer كبديل أسهل لـ Watchtower لفحص الحاويات وتحديثها تلقائيًا. قد يكون هذا الاقتراح مناسبًا للخدمات عديمة الحالة، لكن Immich تطبيق متعدد الحاويات وحافظ للحالة، ويستخدم قاعدة بيانات PostgreSQL ومسارات ترقية موثقة للتغييرات غير المتوافقة.
بالنسبة إلى Immich، قد يكون استبدال الصور تلقائيًا من دون قراءة ملاحظات الإصدار محفوفًا بالمخاطر. توثيق Immich الحالي يطلب صراحةً من المسؤولين مراعاة التغييرات غير المتوافقة قبل الترقية. وإذا كنت تستخدم مُحدِّث حاويات تلقائيًا، ففضّل الإشعارات/الموافقة اليدوية لـ Immich بدلًا من تحديث كل وسم جديد على نحو أعمى.
سير عمل أكثر أمانًا لتحديث Immich على ZimaOS
- سجّل ما إذا كانت الحزمة المثبّتة هي BigBear أم تعريفًا آخر لـ Immich.
- سجّل صور/وسوم الخادم والتعلّم الآلي وقاعدة البيانات وRedis الحالية.
- أجرِ نسخة احتياطية من قاعدة بيانات Immich والوسائط المهمة.
- اقرأ ملاحظات الإصدار من المصدر لكل حدّ لتغييرات جذرية بين إصدارك الحالي والإصدار المستهدف.
- تحقق مما إذا كان الإصدار المستهدف يتطلب تغييرات في Compose أو قاعدة البيانات أو متغيرات البيئة أو التخزين.
- بالنسبة إلى تحديث فرعي متوافق في BigBear، غيّر علامتَي الخادم والتعلّم الآلي معًا كما فعل المجتمع.
- اترك صور قاعدة البيانات وRedis من دون تغيير، ما لم يتطلب مسار الترقية الموثق تغييرًا محددًا.
- احفظ إعدادات التطبيق وراقب سجلات الحاويات أثناء بدء تشغيل الصور الجديدة.
- تحقق من إصدار واجهة ويب Immich وعمليات الرفع والصور المصغّرة والتعلّم الآلي والمكتبة الحالية قبل حذف الصور القديمة.
- إذا عادَت الحزمة إلى الإصدار السابق فورًا أو بقيت على الإصدار القديم، فتحقق من تعريف الحزمة بدلًا من الاستمرار في فرض العلامات.
ما الذي يجب التحقق منه بعد تحديث Immich
- تُحمّل واجهة الويب وتعرض إصدار الخادم المقصود.
- يمكن لتطبيق الهاتف المحمول الاتصال، وهو متوافق مع الإصدار الرئيسي للخادم.
- تُفتح الصور ومقاطع الفيديو الحالية بشكل صحيح.
- تكتمل عمليات الرفع الجديدة بنجاح.
- تعمل مهام الصور المصغّرة وتحويل الترميز.
- تبدأ ميزات التعلّم الآلي من دون أخطاء عدم تطابق الإصدارات.
- تبقى حاوية PostgreSQL سليمة.
تشير وثائق Immich الحالية إلى أن الرجوع إلى إصدار أقدم ليس استراتيجية استرداد مدعومة. وتُعدّ النسخة الاحتياطية أكثر أمانًا من افتراض إمكانية إعادة العلامة ببساطة بعد ترحيل قاعدة البيانات.
الأسئلة الشائعة حول تحديث Immich على ZimaOS
هل يمكنني تحديث Immich بتغيير علامات صور ZimaOS؟
نعم، لبعض تركيبات الحزم والإصدارات. أكد صاحب المنشور الأصلي ومستخدم آخر من BigBear أن تغيير علامتَي الخادم والتعلّم الآلي معًا نجح. وتتضمن المناقشة أيضًا مستخدمًا من خارج BigBear لم تحلّ الطريقة مشكلته المتعلقة بالتثبيت القديم.
ما علامات Immich التي ينبغي تغييرها؟
في طريقة مجتمع BigBear المؤكدة، تم تغيير immich-server و immich-machine-learning تم تغيير العلامات معًا. لا تنسخ أمثلة v2.3.1 أو v2.4.1 أو v2.7.4 القديمة باعتبارها إصدارات مستهدفة حالية.
هل ينبغي أن أستخدم latest؟
ليس كحل شامل. أفاد أحد المستخدمين في المناقشة بأن latest لم يثبت ذلك. استخدم مخطط الإصدارات الذي تدعمه حزمتك الفعلية وإرشادات Immich الحالية.
هل يمكنني ببساطة تشغيل docker pull؟
لا تؤدي عملية سحب صورة جديدة وحدها إلى إعادة إنشاء الحاوية قيد التشغيل أو تطبيق تغييرات Compose. ويستخدم Immich منبعياً docker compose pull && docker compose up -d بعد إعداد التهيئة للإصدار المستهدف.
هل ينبغي لـ Tugtainer أو Watchtower تحديث Immich تلقائيًا؟
قد تتجاوز التحديثات التلقائية مراجعة ملاحظات الإصدار والترحيل التي توصي بها Immich صراحةً. وبالنسبة إلى تطبيق يعتمد على حالة وقاعدة بيانات، تُعدّ الترقية اليدوية المنظّمة مع الإشعارات أكثر أمانًا من الاستبدال التلقائي غير المدروس.
هل أحتاج إلى نسخة احتياطية قبل تحديث Immich؟
نعم. توصي وثائق Immich الحالية للترقية والنسخ الاحتياطي بحماية قاعدة البيانات قبل الترقية، وينبغي أيضًا حماية الوسائط التي لا يمكن استبدالها بشكل منفصل.
