🔋 تثبيت PeaNUT — لوحة التحكم العصرية لمراقبة بطاريات الطوارئ (UPS) على Docker

نشر لوحة PeaNUT على Ubuntu باستخدام Docker — لوحة الويب العصرية والأنيقة لمراقبة أجهزة تزويد الطاقة غير المنقطعة (UPS) عبر Network UPS Tools (NUT) مع مؤشرات حية لنسبة شحن البطارية وجهد الكهرباء واستهلاك الوات.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر PeaNUT على المنفذ 8314 مع حفظ دائم للإعدادات وجاهزية تامة للاتصال بخادم NUT.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/peanut/peanut-ubuntu.sh
chmod +x peanut-ubuntu.sh
./peanut-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/peanut/peanut-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x peanut-ubuntu.sh

3 تشغيل المثبت

./peanut-ubuntu.sh

4 الربط بخادم NUT وبدء المراقبة

http://your-server-ip:8314

المنافذ المستخدمة

المنفذالغرض
8314PeaNUT web dashboard (mapped from container port 8080)
3493NUT server (upsd) — the NUT instance PeaNUT connects to, on your network

نظرة عامة

تعد PeaNUT لوحة تحكم ومراقبة ويب حديثة وخفيفة مفتوحة المصدر مبنية بـ Node.js لخوادم Network UPS Tools (NUT). تعمل اللوحة على المنفذ 8314 (المحول من 8080 الداخلي)، وتتصل بخدمة NUT (`upsd`) المحلية أو البعيدة على المنفذ 3493. وتقوم بتحويل بيانات وأرقام البطارية المعقدة إلى مؤشرات ورسوميات بصرية جذابة في الوقت الفعلي: نسبة شحن البطارية، جهد الدخل والخرج بالكهرباء، نسبة التحميل، استهلاك الطاقة بالوات، الوقت المتبقي المقدر للبطارية، وسجل انقطاعات التيار الكهربائي.

لماذا تستخدمه

تعمل حزمة Network UPS Tools (NUT) الأساسية كأداة طرفية عبر سطر الأوامر (`upsc`) أو توفر سكربتات CGI قديمة من حقبة التسعينات تتطلب إعدادات خادم Apache معقدة. توفر PeaNUT حاوية Docker مجهزة وجاهزة مع واجهة عصرية متجاوبة بالكامل تدعم الوضع الداكن وتحديث المؤشرات لحظياً لكافة أجهزة الـ UPS من ماركات APC وCyberPower وEaton وTripp Lite على شبكتك.

متى تحتاجه

  • تمتلك كابينة سيرفرات أو مختبراً منزلياً (Homelab) أو جهاز تخزين شبكي (NAS) محمي ببطارية UPS وتريد لوحة مراقبة بصرية أنيقة
  • تشغل خدمة NUT على سيرفر Ubuntu أو TrueNAS أو Synology وتحتاج لواجهة متصفح سهلة ومباشرة
  • تريد مراقبة استهلاك الطاقة الفعلي (بالوات ونسبة التحميل) للأجهزة المتصلة بالسيرفر لحظياً
  • تريد التحقق من صحة البطارية والوقت التشغيلي المتبقي أثناء تذبذب وانقطاع الكهرباء
  • تبحث عن واجهة ويب خفيفة جداً تفتحها بسهولة من هاتفك أو شاشة لوحية معلقة بجانب السيرفر

من يحتاجه

  • أصحاب السيرفرات المنزلية ومديرو الأنظمة لمراقبة كبائن السيرفرات وأجهزة NAS وسويتشات الشبكة
  • فرق تقنية المعلومات في الشركات الصغيرة لمتابعة سلامة بطاريات خوادم الشركة الداخلية
  • مشغلو العقد الرقمية ومحطات العمل المنزلية لضمان استقرار الطاقة ومعرفة أوقات الانقطاع
  • مديرو بيئات Proxmox وTrueNAS لمراقبة البنية التحتية المشتركة لمزودات الطاقة
  • هواة المنازل الذكية لدمج مؤشرات بطاريات UPS في لوحات التحكم المركزية مثل Home Assistant

حالات الاستخدام الشائعة

  • عرض نسبة البطارية والوقت المتبقي لحظياً على جهاز تابلت معلق بجانب كابينة السيرفرات
  • مراقبة تذبذبات الجهد الكهربائي وانخفاض الفولتية وتغير تردد الكهرباء في خط الطاقة الرئيسي
  • فحص سحب الطاقة اللحظي (بالوات) عند تشغيل أحمال حسابية أو ماكينات افتراضية ثقيلة
  • متابعة عدة أجهزة بطاريات UPS في مواقع وغرف مختلفة من لوحة تحكم مركزية واحدة
  • التأكد من اكتمال إعادة شحن بطارية الـ UPS تلقائياً بعد عودة الكهرباء من انقطاع طويل

الميزات الرئيسية

  • واجهة ويب عصرية ومتجاوبة بالكامل مع مؤشرات جذابة لشحن البطارية، وجهد التيار، ونسبة التحميل
  • اتصال تلقائي ومباشر بخدمة Network UPS Tools (`upsd`) على المنفذ 3493
  • دعم الأجهزة المتعددة: مراقبة عدة وحدات UPS في نفس الوقت عبر خوادم شبكية مختلفة
  • تحديث البيانات في الوقت الفعلي مع شارات حالة حية (متصل بالتيار، يعمل بالبطارية، بطارية منخفضة، جاري الشحن)
  • حساب تلقائي لتقدير استهلاك الوات الفعلي والوقت الزمني المتبقي بناءً على قراءات NUT
  • تصميم بالوضع الداكن مع ألوان تنبيه ذكية (أخضر: طبيعي، أصفر: تحذير، أحمر: يعمل على البطارية)
  • استهلاك فائق الخفة للذاكرة لا يتجاوز 40 ميجابايت من الذاكرة العشوائية
  • نشر منظم عبر Docker مع ربط مجلد `./config` لحفظ الإعدادات وبيانات الاتصال

كيفية الاستخدام بعد التثبيت

  • تأكد من تثبيت خدمة NUT (`upsd`) وتشغيلها على المنفذ 3493 في السيرفر أو جهاز TrueNAS أو الراوتر
  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8314 لعرض لوحة تحكم PeaNUT
  • اضغط على الإعدادات (Settings) لإدخال عنوان خادم NUT (`host.docker.internal` أو IP السيرفر)، والمنفذ (3493)، واسم الـ UPS
  • أدخل اسم المستخدم وكلمة المرور إذا كانت خدمة NUT تتطلب مصادقة
  • احفظ الإعدادات وعد للوحة الرئيسية للتأكد من ظهور مؤشرات البطارية والجهد الحية
  • ضع PeaNUT خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL للوصول الآمن عن بعد
  • احفظ الرابط في المفضلة بهاتفك الذكي لمتابعة حالة بطاريات السيرفر في أي لحظة

أفضل ممارسات الأمان

  • تأكد من قصر استماع خدمة NUT (`upsd.conf`) على واجهات الشبكة المحلية الموثوقة فقط
  • عين كلمة مرور قوية لمستخدمي مراقبة NUT في ملف `/etc/nut/upsd.users`
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية الاتصال عند الفتح عبر الإنترنت أو الواي فاي
  • لا تكشف المنفذ 8314 أو المنفذ 3493 للإنترنت العام مباشرة؛ واقصر الوصول على شبكتك المحلية أو VPN
  • احمِ مجلد الإعدادات `./config` الذي يحتوي على بيانات الاتصال بصلاحيات مناسبة على السيرفر
  • حدّث صورة الحاوية brandawg93/peanut دورياً للحصول على الميزات والتحسينات الجديدة

المنافذ وإعدادات جدار الحماية

يقدم تطبيق PeaNUT واجهة الويب عبر منفذ TCP 8314 (المحول من 8080 الداخلي). ويتصل خارجياً بخدمة NUT على منفذ TCP 3493. يجب السماح بالمنفذ 8314 في جدار الحماية للشبكة المحلية (ufw allow 8314/tcp). وإذا كانت خدمة NUT تعمل على سيرفر آخر، فتأكد من فتح المنفذ 3493 بين السيرفرين.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./config` احتياطياً، والذي يحتوي على إعدادات الاتصال والأجهزة المضافة
  • احتفظ بنسخة من ملفات إعداد خدمة NUT بالسيرفر (`/etc/nut/ups.conf` و`upsd.conf` و`upsd.users`)
  • أتمت النسخ الاحتياطي الدوري للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بإعادة تشغيل الحاوية والتأكد من استرجاع أجهزة الـ UPS فوراً

الأخطاء الشائعة

  • كتابة عنوان خادم NUT كـ `localhost` داخل الحاوية بدلاً من `host.docker.internal` أو عنوان IP السيرفر المحلي
  • نسيان السماح بالاتصالات الخارجية في ملف `/etc/nut/upsd.conf` بالسيرفر (حيث يستمع NUT افتراضياً لـ 127.0.0.1 فقط)
  • عدم ربط مجلد التخزين الدائم `./config`، مما يسبب فقدان إعدادات الاتصال عند تحديث الحاوية
  • تشغيل PeaNUT دون وجود خدمة NUT نشطة ومهيأة مسبقاً على السيرفر
  • كشف المنفذ 8314 علناً على الإنترنت دون حماية بكلمة مرور أو وكيل عكسي

استكشاف الأخطاء وإصلاحها

  • ظهور رسالة 'Cannot connect to NUT server' — تأكد من تشغيل خدمة NUT بالسيرفر (`systemctl status nut-server`) وسماحها بالاستماع في `upsd.conf` (`LISTEN 0.0.0.0 3493`)
  • عدم التعرف على host.docker.internal — تأكد من وجود سطر `extra_hosts: ['host.docker.internal:host-gateway']` في ملف docker-compose
  • ظهور قيم 'N/A' أو فارغة للمؤشرات — اختبر قراءة NUT من طرفية السيرفر بالأمر: `upsc <اسم_الـUPS>@localhost`
  • واجهة الويب لا تفتح على 8314 — راجع سجلات الحاوية بالأمر: `docker logs peanut -f`
  • فشل المصادقة — تأكد من مطابقة اسم المستخدم وكلمة المرور لبيانات المستخدم في `/etc/nut/upsd.users`

البدائل

واجهة NUT-CGI الواجهة الرسمية الكلاسيكية لحزمة Network UPS Tools. أداة APCUPSD حزمة مراقبة متخصصة لأجهزة بطاريات APC. أداة Netdata تتضمن رسوميات وتنبيهات فورية لخدمة NUT. منصة Home Assistant تتضمن تكاملاً مباشراً مع NUT لإدارة أتمتة المنازل الذكية.

متى لا تستخدمه

تجنب استخدام PeaNUT إذا كنت تمتلك جهاز UPS من ماركة APC متصل عبر apcupsd وليس عبر Network UPS Tools (حيث تتوافق أدوات مثل apcupsd-cgi أو تكامل Home Assistant مع apcupsd). وإذا كنت تحتاج لنظام إيقاف تشغيل آلي معقد عبر عدة خوادم Proxmox أو ESXi، فاضبط عملاء `upsmon` مباشرة على كل سيرفر.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هي حزمة Network UPS Tools (NUT) وهل أحتاجها لتشغيل PeaNUT؟

حزمة NUT هي خدمة برمجية مفتوحة المصدر تتواصل مباشرة مع جهاز الـ UPS عبر منفذ USB أو Serial. وتعد PeaNUT لوحة تحكم ويب تتصل بخدمة NUT (`upsd`) لعرض قراءات الطاقة بصرياً.

كيف تتصل حاوية PeaNUT بخدمة NUT داخل Docker؟

تتصل PeaNUT باستخدام العنوان `host.docker.internal:3493` (أو عنوان IP المحلي للسيرفر) للوصول لخدمة `upsd` العاملة على السيرفر الأساسي أو على جهاز آخر بالشبكة.

هل يمكن لـ PeaNUT مراقبة أكثر من جهاز UPS في نفس الوقت؟

نعم! تدعم PeaNUT مراقبة عدة أجهزة UPS متصلة بخوادم NUT مختلفة، وتتيح إضافتها جميعاً في الإعدادات وعرضها في اللوحة الرئيسية.

ما هي ماركات أجهزة الـ UPS التي تدعمها NUT وPeaNUT؟

تدعم NUT تقريباً كافة الماركات العالمية عبر بروتوكولاتها القياسية، بما في ذلك APC وCyberPower وEaton وTripp Lite وRiello وPowerwalker.

كم يستهلك PeaNUT من الذاكرة العشوائية؟

يعد PeaNUT خفيفاً للغاية، حيث يستهلك ما بين 30 إلى 45 ميجابايت فقط من الذاكرة العشوائية داخل Docker.