أعد Home Assistant إلى إصدار سابق باستخدام نقطة استرداد سابقة للتحديث ومتوافقة مع إصدار Core الأقدم؛ ولا تفترض أن تشغيل بيئة تشغيل قديمة سيعكس عمليات ترحيل الحالة الدائمة الأحدث.
يبدأ التراجع الأكثر أمانًا قبل أول محاولة إصلاح: احتفظ بحالة ما بعد التحديث الفاشلة، وحدد آخر إصدار ونسخة احتياطية معروفين بسلامتهما، وقرر ما إذا كان سبب عدم التوافق هو Core أو تكامل مخصص أو إضافة أو قاعدة بيانات خارجية. لا يُعد التراجع ناجحًا إلا عندما تتمكن بيئة التشغيل السابقة من قراءة الحالة المستعادة وتعمل وظائف المنزل الأصلية مجددًا. فتغيير الإصدار والتراجع عن البيانات عملية استرداد واحدة، وليسا زرين غير مرتبطين.
احتفظ بالحالة الفاشلة قبل محاولة الرجوع إلى إصدار أقدم
لا تستبدل النسخة الوحيدة من الإعدادات بعد التحديث أثناء التجربة. احفظ الإعدادات الحالية والسجلات وأرقام الإصدارات وموقع قاعدة البيانات والميزة المحددة التي تعطلت. قد تحتوي هذه النسخة على تغييرات جديدة أُجريت بعد آخر نسخة احتياطية سليمة، إضافةً إلى أدلة لازمة لفهم عدم التوافق لاحقًا.
أظهر تراجع في الاستعادة عام 2026 أن استعادة نسخة احتياطية تبدو ناجحة قد تترك بيئة التشغيل على الإصدار الخاطئ عندما يكون سلوك Supervisor المحيط بها معيبًا. ويُعد التقرير حول استعادة النسخة الاحتياطية والتراجع عن إصدار Core سببًا مفيدًا للتحقق من الإصدار الفعلي بعد الاستعادة بدلًا من الوثوق برسالة إتمام العملية.
توقف عن إجراء تغييرات على الإعدادات حتى يتضح مسار الاسترداد. إذا تسبب التحديث في تعطيل مكوّن مخصص اختياري بينما بقي باقي Home Assistant مستقرًا، فقد يكون تعطيل ذلك المكوّن أكثر أمانًا من إجراء تراجع كامل. أما إذا تعذر تشغيل Core أو فشل تحميل قاعدة البيانات أو أصبحت الأتمتات المهمة غير قابلة للاستخدام، فانتقل إلى مسار استرداد يجمع بين بيئة التشغيل والحالة.
اختر نقطة استرداد تسبق الإصدار غير المتوافق
حدد آخر نسخة احتياطية أُخذت أثناء تشغيل إصدار Home Assistant الأقدم بصورة صحيحة. تحقق من تاريخها ووقته مقارنةً بأي تغييرات مهمة في الأتمتات أو المستخدمين أو لوحات المعلومات أو السجل تقبل فقدانها. فنقطة الاسترداد تنطوي على مقايضة: إذ تستعيد التوافق عبر إعادة الحالة الدائمة إلى الوراء زمنيًا.
تُعد إرشادات ZimaSpace بشأن أخذ لقطة لبيانات التطبيق قبل التحديث النسخة الوقائية من القاعدة نفسها: يكون التراجع عن بيئة التشغيل أنظف عندما توجد نسخة معروفة بسلامة حالتها من قبل أن يبدأ البرنامج الجديد بالكتابة إلى بيانات الإنتاج.
إذا لم توجد نسخة احتياطية موثوقة سابقة للتحديث، فلا تنشئ واحدة مصطنعة عبر نسخ قاعدة البيانات التي رُحّلت بالفعل وإقرانها بصورة Core قديمة. احتفظ بالحالة الحالية وابحث عن إصلاح تقدمي أو إعادة بناء مضبوطة. فقد يحول التراجع من دون نسخة حالة متوافقة مشكلة ميزة واحدة غير متوافقة إلى أعطال في المسجل أو السجل أو السجل التعريفي.
استعد بيئة التشغيل والحالة الدائمة كزوج متطابق
بالنسبة إلى Home Assistant OS أو التثبيت المُدار، استخدم مسار الاستعادة المدعوم الذي يعيد نقطة الاسترداد المحددة، وتحقق من تشغيل إصدار Core المقصود فعليًا. أما في تثبيتات الحاويات، فإرجاع الصورة إلى إصدار سابق لا يمثل سوى نصف العملية إذا كان الإصدار الأحدث قد غيّر البيانات الدائمة؛ لذا استعد أيضًا نسخة الإعدادات المطابقة لما قبل التحديث.
وثّقت مشكلة في Home Assistant Core تتعلق بالرجوع من 2025.4 إلى 2025.3 تعطل المسجل والسجل والتكاملات ذات الصلة عندما واجهت بيئة التشغيل الأقدم بنية قاعدة بيانات أحدث. وتوضح استجابة المشرف صراحةً أن التراجع يعتمد على استعادة نسخة احتياطية، وليس على مسار لخفض إصدار قاعدة البيانات في مكانها.
استعد قواعد البيانات الخارجية والخدمات التابعة إلى نقاط متوافقة فقط عندما لا تكون نسخة Home Assistant الاحتياطية مسؤولة عنها. لا تُرجع كل حاوية إلى إصدار أقدم بشكل أعمى. قد تكون MQTT والوكلاء وأجهزة الراديو سليمة ويمكن إبقاؤها دون تغيير؛ ركز التراجع على المكونات التي تغير عقد إصدارها أو حالتها فعلًا.
تحقق من العطل الأصلي قبل إعادة تمكين التحديثات التلقائية
بعد التراجع، تأكد من إصدار Core قيد التشغيل وتسجيل الدخول والمسجل/السجل والتكاملات الأساسية والأتمتات ولوحات المعلومات وجهاز واحد من كل بروتوكول مهم. كرر الإجراء الذي فشل في الإصدار غير المتوافق وتحقق من أنه يعمل الآن من دون أخطاء جديدة. ثم أعد تشغيل Home Assistant وأعد تشغيل المضيف مرة واحدة.
احتفظ بنسخة الحالة الفاشلة وملاحظات التحديث حتى تختبر الإصدار أو الإصلاح التالي. إذا تسبب تكامل مخصص في عدم التوافق، فتحقق من الإصدارات التي يدعمها قبل تحديث Core التالي. وإذا فشل التراجع نفسه، فلا تتناوب على الإصدارات مرارًا باستخدام قاعدة البيانات القابلة للتغيير نفسها؛ عُد إلى نقطة الاسترداد النظيفة أو انتقل إلى إعادة بناء مع استعادة انتقائية.
يُعد الاسترداد ناجحًا عندما يظل الإصدار القديم والحالة المستعادة مستقرين أثناء الاستخدام العادي وبعد إعادة التشغيل، ويختفي العطل الأصلي. صعّد المشكلة عندما يتعذر استرداد النسخة الاحتياطية أو تظل بيئة التشغيل الأقدم عاجزة عن قراءة حالتها أو لا تتوفر نقطة استرداد متوافقة للبيانات المهمة. عند هذه النقطة، يكون الإصلاح التقدمي المنضبط أو إعادة البناء أكثر أمانًا من تكرار محاولات الرجوع.
الدعم والنصائح
المزيد للقراءة

هل يمكن لـ Home Assistant مشاركة وحدة معالجة رسومات أو مُسرّع مع حاوية أخرى؟
تعتمد مشاركة وحدة معالجة الرسومات (GPU) على عبء العمل: إذ يمكن للحاويات غالبًا مشاركة عقد العرض، بينما يغيّر تمرير الجهاز بالكامل إلى آلة افتراضية...

كيفية معرفة ما إذا كان خطأ Home Assistant صادرًا عن العميل أم الخادم
تشير حالات الفشل لدى عميل واحد إلى حالة العميل؛ بينما تشير حالات الفشل عبر عملاء متعددين إلى الخادم أو وكيل مشترك أو مسار شبكة...

كيفية تهيئة ذاكرة التخزين المؤقت ووحدة التخزين المؤقتة لـ Home Assistant
احتفظ بحالة Home Assistant الدائمة على وحدة تخزين متينة؛ واستخدم tmpfs فقط للمسارات التي ثبت أنها قابلة للحذف، واضبط حجمها ضمن ميزانية ذاكرة المضيف...

