إذا استمر PeaNUT في اكتشاف وحدة UPS بعد إعادة تشغيل ZimaOS، لكن اختفت إعداداته المحفوظة، فغالبًا ما تكون المشكلة في الاستمرارية وليس في اتصال UPS. يجب ربط دليل الإعدادات بتخزين دائم في ZimaOS، كما يجب أن تتمكن الحاوية من الكتابة إلى ذلك الدليل.
أكدت سلسلة المنتدى المنشورة في مارس 2026 إصلاحًا واحدًا لإصدار PeaNUT المثبّت آنذاك: ربط مجلد مضيف دائم بالمسار /app/config. ومنذ ذلك الحين، وحّثت وثائق PeaNUT الحالية من المصدر إعدادات التخزين الدائم تحت المسار /config، لذلك ينبغي للتثبيتات الجديدة اتباع المسار الحالي بدل نسخ مسار الحاوية القديم دون تحقق.
ما الذي أثبته إصلاح المنتدى فعليًا؟
أفاد صاحب المنشور الأصلي بأن جميع إعدادات PeaNUT اختفت بعد كل إعادة تشغيل لـ ZimaOS، مع أن Home Assistant استمر في تلقي بيانات UPS. فحص أحد أفراد المجتمع الحزمة واقترح تغيير ربط وحدة التخزين بحيث يُركَّب مجلد مضيف ضمن بيانات تطبيقات ZimaOS على المسار /app/config. وردّ صاحب المنشور الأصلي بأن هذا «حل المشكلة»، ما يجعله إصلاحًا موثّقًا لإصدار الحزمة المحدد.
لا يعني ذلك أن /app/config هو المسار الصحيح لكل صور PeaNUT الحالية. فمسارات الحاوية جزء من مواصفات الصورة، وقد تتغير بين الإصدارات.
بالنسبة إلى إصدارات PeaNUT الحالية، استخدم المسار /config
تستخدم وثائق PeaNUT الحالية الخاصة بـ Docker المسار /config للإعدادات الدائمة. كما تتوقع الصورة الحالية أن يكون هذا الدليل قابلًا للكتابة من مستخدم الخدمة، وعادةً ما يكون معرّف المستخدم/المجموعة 1000:1000.
في ZimaOS، اربط دليلًا دائمًا على المضيف، مثل مجلد بيانات التطبيقات، بالمسار /config، ثم أعد تشغيل الحاوية وأجرِ تغييرًا بسيطًا غير مؤثر في الإعدادات. أعد التشغيل مرة أخرى وتأكد من بقاء التغيير. يوضّح دليل ترحيل بيانات التطبيقات في ZimaOS مبدأ الاستمرارية نفسه.
تحقق من أذونات الكتابة قبل تغيير المسارات مجددًا
إذا كان الربط صحيحًا، لكن الإعدادات لا تزال تُعاد إلى الوضع الافتراضي، فتحقق من سجلات PeaNUT بحثًا عن أخطاء الأذونات. يحذّر الكود الحالي من المصدر صراحةً عندما لا يكون /config قابلًا للكتابة. لا تفترض أن إضافة متغيرات البيئة غير المدعومة PUID أو PGID ستصلح الصورة؛ فالإرشادات الحالية من المصدر تركز بدلًا من ذلك على جعل دليل المضيف قابلًا للكتابة من مستخدم الخدمة الفعلي داخل الحاوية.
يُعد منتدى نقاش PeaNUT من المصدر مفيدًا عندما تُظهر الصورة الحالية أخطاء متعلقة بالأذونات.
لماذا قد يفشل docker exec؟
أظهر المنشور الأصلي أيضًا فشل الأمر docker exec -it PeaNUT sh لأن صورة PeaNUT تلك لم تكن تحتوي على صدفة أوامر. ولا يُعد ذلك دليلًا على تعطل الحاوية. فقد تتعمد الصور المصغّرة عدم تضمين sh أو bash.
ابدأ بسجلات الحاوية وربط وحدات التخزين المُعدّ. وللاطلاع على أساسيات استمرارية الحاويات عمومًا، يشرح دليل ZimaOS التمهيدي لتطبيقات Docker سبب بقاء البيانات المركّبة من المضيف بعد إعادة إنشاء الحاوية وإعادة تشغيلها.
الخلاصة
كان إصلاح المجتمع القديم حقيقيًا لحزمة PeaNUT المستخدمة في مارس 2026، لكن إصدارات PeaNUT الحالية توثّق /config بوصفه الدليل الدائم. استخدم مسار الحاوية الموثّق في الصورة المثبّتة لديك، واجعل مجلد المضيف قابلًا للكتابة، وتحقق من الاستمرارية عبر إعادة التشغيل قبل تغيير أي شيء آخر.
