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

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

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

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

