Can I migrate Immich to the ZimaCube 2 without losing my albums and face tags?

Yes — but you must copy both the photo files and the pgdata directory (PostgreSQL database). The database stores all albums, face vectors, people clusters, and metadata. Moving photos alone gives you files without organization. Copy both directories together, and your library survives intact.

What is the fastest way to transfer Immich data to the ZimaCube 2?

If both machines are on the same LAN and run ZimaOS, use the built-in Files app with LAN Storage mounting. Over the ZimaCube 2 2.5GbE connection, 134 GiB transfers in about 10–15 minutes. For larger libraries or machines on different networks, an external USB drive is the next best option.

Does the Immich App Store version matter when migrating?

Yes — critically. The ZimaOS App Store may show multiple Immich variants (official vs BigBearCasaOS). They use different docker-compose variables — postgres credentials, database names, and network configs are incompatible. Install the exact same variant your source machine uses, or the restored database will not connect.

Do I need to stop Immich on the source before copying?

Yes. A running PostgreSQL instance writes continuously. Copying a live database risks an inconsistent state. Stop Immich on the source machine, copy the folders, then start it on the destination. The source machine can remain off or stay on as a backup until you have verified the migration.

How much storage does Immich need on the ZimaCube 2?

Plan for your photo library size plus room for the PostgreSQL database (which grows with your library), thumbnail cache, and transcoded video versions. A 134 GiB library with 14,500 photos uses roughly 150–160 GiB total with overhead. The ZimaCube 2's six SATA bays give you room to grow.

كيف قمت بنقل 14000 صورة إلى ZimaCube 2 بدون فقدان أي بيانات — دليل ترحيل Immich

إيفا وونغ

IceWhale author

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

Immich self-hosted photo management app dashboard displaying multi-device sync and phone backup

💡 تسليط الضوء على المجتمع: u/Ambitious_Shallot_79، r/minilab

لديك مكتبة صور. سنوات من الذكريات. ألبومات نظمتها بعناية. وجوه قمت بوضع علامات عليها. روابط مشتركة أرسلتها للعائلة.

ثم تقوم بترقية جهاز NAS الخاص بك — وتدرك أن نقل الملفات ليس كافيًا. بدون قاعدة البيانات، تفقد كل ألبوم، وكل علامة وجه، وكل ذكرى قمت بتنظيمها. الصور موجودة، لكن التنظيم اختفى.

لقد نقلت للتو 14,505 صورة و925 فيديو — بمجموع 134 جيجابايت — من خادم ZimaOS DIY إلى ZimaCube 2. نجا كل ألبوم. وصلت كل علامة وجه. كل رابط مشترك لا يزال يعمل.

إليك بالضبط كيف فعلت ذلك، وما كاد أن يخطئ، وما الذي قدمه ZimaCube 2 الذي لم تستطع إعدادي القديم تقديمه.

لماذا Immich، ولماذا الآن

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

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

كان لهذا الترحيل قاعدة واحدة: عدم فقدان أي بيانات. لن يتم مسح الخادم القديم حتى يتم التحقق من الجديد.

ما يخزنه Immich فعليًا (ولماذا يهم)

قبل لمس أي ملفات، قمت بتخطيط دقيق لما يجب نقله:

المكون	الموقع	المحتويات	هل يجب الترحيل؟
pgdata	/DATA/AppData/immich/pgdata	PostgreSQL الكامل — الألبومات، الوجوه، الأشخاص، البيانات الوصفية	✅ حرج
ذاكرة التخزين المؤقت للنماذج	/DATA/AppData/immich/model-cache	نماذج CLIP/التعرف على الوجه التي تم تنزيلها	✅ يحفظ إعادة التنزيل
مكتبة الصور	/DATA/Gallery/immich	14,505 صور + 925 فيديو + الصور المصغرة (134 جيجابايت)	✅ الوسائط الفعلية
النسخ الاحتياطية التلقائية	/DATA/Gallery/immich/backups	آخر 14 لقطة يومية لقاعدة البيانات	💡 موجود بالفعل

🎁 نقل ملفات الصور فقط — بدون دليل pgdata — يمنحك كل صورك ولكن لا ألبوماتك، أو علامات الوجوه، أو الأشخاص، أو الذكريات، أو الروابط المشتركة. يعامل Immich PostgreSQL كمصدر الحقيقة. يجب أن ينتقل كلاهما معًا.

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

الطريقة: تطبيق ملفات ZimaOS (نسخ عبر الشبكة المحلية)

كلا الجهازين يعملان بنظام ZimaOS على نفس الشبكة المحلية. هذا يعني أنه يمكنني استخدام تطبيق الملفات المدمج لنقل مباشر عبر الشبكة المحلية — بدون أقراص خارجية، بدون أوامر SCP، بدون تخزين وسيط.

الخطوة 1: تركيب جهاز المصدر

على ZimaCube 2، افتح تطبيق الملفات → + إضافة تخزين → تخزين LAN → أدخل عنوان IP المحلي لجهاز المصدر وقم بالمصادقة. يظهر نظام ملفات جهاز المصدر الآن كمساحة تخزين يمكن تصفحها على ZimaCube 2.

Featured

ZimaCube 2 سحابة شخصية منزلية لتخزين الشبكة (NAS)

ZimaCube2

الخطوة 2: إيقاف Immich على المصدر

هذه هي الخطوة التي يتخطاها الناس ويندمون عليها. أوقف Immich قبل النسخ. نسخة PostgreSQL العاملة تكتب باستمرار — تحتاج إلى قاعدة بيانات في حالة متسقة ومفرغة. على جهاز المصدر: متجر تطبيقات ZimaOS → Immich → إيقاف.

الخطوة 3: نسخ كلا الدليلين

من تطبيق الملفات في ZimaCube 2، انتقل إلى المصدر المركب واختر:

مسار المصدر	مسار الوجهة على ZimaCube 2
/DATA/AppData/immich	/DATA/AppData/immich
/DATA/Gallery/immich	/DATA/Gallery/immich

اختر كلا الموقعين، واضغط على ترحيل. اختر: الكتابة فوق في الوجهة والاحتفاظ بالأصلية في المصدر — لا تحذف المصدر حتى يتم التحقق.

⚡ عبر اتصال 2.5GbE في ZimaCube 2، تم نقل 134 جيجابايت في حوالي 10–15 دقيقة. كان خادمي القديم المصنوع يدويًا عالقًا على 1GbE — نفس النقل كان سيستغرق 30–40 دقيقة. هذا هو الفرق الواقعي الذي لا يظهر في مواصفات الجهاز لكنه مهم في كل مرة تنقل فيها البيانات.

الخطوة 4: تثبيت Immich على ZimaCube 2

افتح متجر تطبيقات ZimaOS وابحث عن Immich. تحذير هام: قد يعرض متجر التطبيقات عدة نسخ من Immich. يجب عليك تثبيت نفس النسخة بالضبط التي يستخدمها جهاز المصدر الخاص بك:

Immich (تطبيق ZimaOS/CasaOS الرسمي) — استخدم هذا إذا كان هذا ما كان لديك من قبل

BigBearCasaOS Immich — متغيرات docker-compose مختلفة، بيانات اعتماد postgres مختلفة، اسم قاعدة بيانات مختلف — غير متوافق مع نسخة pgdata مباشرة من التطبيق الرسمي

🔑 متغيرات docker-compose — اسم مستخدم postgres، كلمة المرور، اسم قاعدة البيانات، وضع الشبكة — مدمجة في تعريف التطبيق. أي عدم تطابق بين متغيرات التطبيق المصدر والوجهة سيمنع Immich من الاتصال بقاعدة البيانات المستعادة. هذه هي نقطة الفشل الأكثر شيوعًا في ترحيلات Immich.

بعد التثبيت، لا تبدأ التطبيق فورًا. سيكتشف Immich دليل pgdata الموجود عند الإطلاق الأول ويتصل به بدلاً من تهيئة قاعدة بيانات جديدة فارغة.

البحث عن تطبيق 'immich' في متجر تطبيقات ZimaOS / CasaOS أثناء إعداد NAS

الخطوة 5: تسجيل الدخول باستخدام بيانات الاعتماد الحالية

افتح Immich على http://192.168.x.x:2283 وسجل الدخول بنفس اسم المستخدم وكلمة المرور من النسخة المصدر. ستكون مكتبتك الكاملة — الألبومات، الوجوه، الأشخاص، الإعدادات — كما كانت تمامًا.

شاشة ترحيب تطبيق Immich وزر البدء بعد نجاح ترحيل قاعدة البيانات

الخطوة 6: التحقق من قوائم الوظائف

انتقل إلى الملف الشخصي → الإدارة → قوائم الوظائف. بعد ترحيل pgdata، تحتوي قاعدة البيانات بالفعل على جميع النتائج التي تمت معالجتها سابقًا، لذا يجب أن تظهر معظم القوائم نشط: 0 / في الانتظار: 0.

إذا أظهر أي طابور عددًا أقل من المفقود، انقر على زر المفقود لمعالجة الأصول غير المعالجة فقط:

الطابور	متى يتم تشغيل المفقود
توليد الصور المصغرة	إذا عرضت أي صور معاينات فارغة
استخراج البيانات الوصفية	إذا كانت الأصول تفتقد GPS/الموقع/التاريخ
البحث الذكي	إذا لم تُرجع البحث الدلالي أي نتائج
كشف الوجه	إذا بدت بيانات الوجه غير مكتملة

إحصائيات الترحيل

المقياس	القيمة
الصور التي تم ترحيلها	14,505
الفيديوهات التي تم ترحيلها	925
إجمالي البيانات	134 جيبيبايت
وقت النقل (2.5GbE)	~12 دقيقة
الألبومات محفوظة	الكل
علامات الوجوه محفوظة	الكل
الروابط المشتركة محفوظة	الكل
فقدان البيانات	صفر

لماذا جعل ZimaCube 2 هذا الأمر يستحق العناء

لم أقم بالترحيل فقط لأصل إلى نفس التجربة. يقدم ZimaCube 2 ثلاث ترقيات لم يكن بإمكان صندوق ZimaOS DIY القديم الخاص بي مجاراتها:

نقل بسرعة 2.5GbE. تنمو مكتبات الصور. كل نسخة احتياطية كاملة، وكل استيراد كبير، وكل ترحيل يستفيد من عرض النطاق الترددي 2.5× مقارنة بالجيجابت العادي. يعني وجود منفذي 2.5GbE مزدوجين في ZimaCube 2 أنني أستطيع تشبع النسخ الاحتياطي بينما يبقى بقية الشبكة مستجيبًا.

تخزين NVMe لقاعدة البيانات. أداء قاعدة بيانات Immich PostgreSQL أفضل بكثير على NVMe مقارنة بالأقراص الصلبة التقليدية. توليد الصور المصغرة، استعلامات البحث الذكية، التعرف على الوجوه — كل ذلك يقرأ من pgdata. على مجموعة NVMe في ZimaCube 2، العمليات على قاعدة البيانات التي كانت تتعثر سابقًا على HDD أصبحت الآن فورية.

توسعة بست فتحات. 134 جيبي اليوم. ماذا عن العام المقبل؟ يحتوي ZimaCube 2 على ستة فتحات SATA بالإضافة إلى أربع فتحات M.2 في الفتحة السابعة، مما يعني أن مكتبة الصور هذه يمكن أن تنمو لسنوات دون أن تصل إلى حد التخزين.

جهاز IceWhale ZimaCube 2 NAS بست فتحات يظهر فتحات الأقراص القابلة للتبديل السريع من الأمام لتخزين ذاتي عالي الأداء

انقل مكتبة الصور الخاصة بك إلى ZimaCube 2 →

تبني إعداد الصور المستضافة ذاتياً؟ اقرأ دليل جهاز التخزين السحابي الشخصي، وتحليلنا العميق لـ Docker وCI/CD على ZimaCube 2، وفتح صندوق ZimaCube 2 Pro.

الأسئلة المتكررة

هل يمكنني نقل Immich إلى ZimaCube 2 دون فقدان ألبوماتي وعلامات الوجوه؟

نعم — لكن يجب نسخ كل من ملفات الصور ودليل pgdata (قاعدة بيانات PostgreSQL). تخزن القاعدة جميع الألبومات، متجهات الوجوه، مجموعات الأشخاص، والبيانات الوصفية. نقل الصور فقط يعطيك ملفات بدون تنظيم. انسخ كلا الدليلين معاً، وستبقى مكتبتك سليمة.

ما هي أسرع طريقة لنقل بيانات Immich إلى ZimaCube 2؟

إذا كان كلا الجهازين على نفس الشبكة المحلية ويشغلان ZimaOS، استخدم تطبيق الملفات المدمج مع تركيب تخزين LAN. عبر اتصال 2.5GbE في ZimaCube 2، تنتقل 134 جيبي في حوالي 10–15 دقيقة. للمكتبات الأكبر أو الأجهزة على شبكات مختلفة، يعد قرص USB خارجي الخيار الأفضل التالي.

هل تهم نسخة Immich من متجر التطبيقات عند النقل؟

نعم — بشكل حاسم. قد يعرض متجر تطبيقات ZimaOS عدة نسخ من Immich (الرسمية مقابل BigBearCasaOS). تستخدم متغيرات docker-compose مختلفة — بيانات اعتماد postgres، أسماء قواعد البيانات، وتكوينات الشبكة غير متوافقة. قم بتثبيت نفس النسخة التي يستخدمها جهاز المصدر بالضبط، وإلا فلن تتصل قاعدة البيانات المستعادة.

هل أحتاج إلى إيقاف Immich على المصدر قبل النسخ؟

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

كم من التخزين يحتاجه Immich على ZimaCube 2؟

خطط لحجم مكتبة الصور الخاصة بك بالإضافة إلى مساحة لقاعدة بيانات PostgreSQL (التي تنمو مع مكتبتك)، ذاكرة التخزين المؤقت للصور المصغرة، وإصدارات الفيديو المحولة. تستخدم مكتبة بحجم 134 جيبي مع 14,500 صورة حوالي 150–160 جيبي إجمالاً مع الحمل الزائد. توفر ستة فتحات SATA في ZimaCube 2 مساحة للنمو.