لماذا يفقد Home Assistant الوصول إلى البيانات الدائمة بعد إعادة إنشاء الحزمة؟

إيفا وونغ

IceWhale author

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

Why Does Home Assistant Lose Access to Persistent Data After Stack Recreation?

لا ينبغي أن تؤدي إعادة إنشاء حزمة Home Assistant عبر Docker أو Compose إلى محو الإعدادات عند إعادة تركيب بيانات /config الدائمة نفسها. عندما تظهر شاشة الإعداد الأولي أو تبدو عمليات التكامل مفقودة بعد إعادة الإنشاء، ينبغي أن يكون الافتراض الأول هو أن الحاوية الجديدة ترى عرض تخزين مختلفًا، وليس أن Home Assistant حذف حالة المنزل.

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

تحقق مما هو مركّب فعليًا في /config

افحص الحاوية قيد التشغيل وتأكد من مصدر التركيب المرتبط بـ /config. قارنه بملف Compose القديم أو بسجل النشر بدلًا من الاعتماد على اسم مجلد يبدو مألوفًا.

تستبدل عمليات الربط المباشر في Docker عرض الحاوية للدليل المستهدف، وتشير وثائق الربط المباشر إلى أن تركيب دليل من المضيف فوق مسار غير فارغ في الحاوية يحجب الملفات الموجودة فيه مسبقًا. لذلك، يجعل مسار المصدر الفارغ أو الخاطئ Home Assistant يرى /config فارغًا.

لا تشغّل الإعداد الأولي ولا تبدأ بإنشاء عمليات تكامل جديدة قبل التحقق من التركيب. فالكتابات الجديدة في الدليل الخاطئ تجعل الاسترداد اللاحق أكثر إرباكًا.

ميّز بين عمليات الربط المباشر ووحدات التخزين المسماة

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

يوضح دليل حالي لوحدات تخزين Docker أن وحدات التخزين المسماة تخزن البيانات بشكل مستقل عن الحاويات الفردية ويمكن إعادة ربطها بعد استبدال الحاوية. لذلك، فإن إزالة الحاوية تختلف عن إزالة تخزينها الدائم أو استبداله.

اعرض الوحدات القديمة والجديدة، وافحص نقاط تركيبها عبر Docker، وقارن أوقات إنشائها ومحتوياتها. تجنب أوامر التنظيف حتى تعرف أي وحدة تحتوي على حالة Home Assistant المعتمدة.

قد تجعل الملفات المخفية النسخة تبدو مكتملة وهي ليست كذلك

يخزن Home Assistant حالة مهمة تديرها واجهة المستخدم ضمن مسارات مخفية مثل .storage. وقد يؤدي نسخ shell باستخدام نمط شامل مثل *، أو استخدام مدير ملفات يخفي الملفات التي تبدأ بنقطة، إلى نقل ملفات YAML مع ترك حالة السجل وعمليات التكامل المهمة خلفه بصمت.

أعادت حالة ترحيل من Docker إلى Compose في عام 2025 إنتاج هذه المشكلة تحديدًا: فقدت عملية النسخ حالة Home Assistant المخفية أو تعاملت معها بشكل غير صحيح، ولم تستقر عملية الترحيل إلا بعد نسخ شجرة الإعدادات والبيانات الوصفية بالكامل وبشكل صحيح.

قارن قوائم الأدلة التي تتضمن الملفات المخفية، وتحقق من الملكية والطوابع الزمنية ووجود الأدلة المخفية المتوقعة قبل استنتاج أن البيانات نفسها تالفة.

Featured

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

ZimaCube2

تحقق من الأذونات قبل نسخ البيانات مرة أخرى

قد يبدو الدليل الصحيح غير قابل للاستخدام عندما تفتقر الحاوية المعاد إنشاؤها إلى إذن قراءته أو الكتابة فيه. ويشيع ذلك بعد نقل البيانات إلى نظام ملفات جديد، أو تغيير وضع Docker، أو الاستعادة من مضيف آخر، أو تغيير تعيينات UID/GID.

يحصر دليل لاستكشاف أخطاء Docker Engine، تم التحقق منه في عام 2026، هذه الأعطال في مسار المضيف الفعلي، وUID/GID الخاص بالحاوية، وإمكانية الوصول إلى الدليل الأب، ووضع التركيب، وحدود الأمان. وقد يمنع عدم تطابق الملكية أو وضع القراءة فقط Home Assistant من تحديث الحالة حتى عندما تكون الملفات ظاهرة.

أصلح مشكلة الملكية أو التركيب المحددة بدلًا من منح أذونات الكتابة للجميع لشجرة الإعدادات بأكملها.

أعد إنشاء الحزمة فقط بعد التحقق من المسار الدائم

استخدم تعريف Compose المطابق تمامًا للإعداد المعروف بصحته، وعلامة الصورة، ووضع الشبكة، والأجهزة، ومصدر /config. شغّل Home Assistant وتحقق من عودة المستخدمين ولوحات المعلومات وعمليات التكامل والأتمتة والمساعدات المتوقعة قبل السماح بعمليات الترحيل أو تغييرات الإعدادات الجديدة.

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

إذا كانت البيانات المعتمدة مفقودة فعلًا، فانتقل إلى استعادة النسخة الاحتياطية. أما إذا كانت موجودة لكن الحاوية الجديدة لا تستطيع رؤيتها أو تعديلها، فالمشكلة تتعلق بحدود تعيين التخزين أو الأذونات، وليست في إعدادات Home Assistant نفسها.