🏠 تثبيت openHAB — مركز أتمتة المنازل الذكية المحايد والشامل على Docker

نشر منصة openHAB على Ubuntu باستخدام Docker — المنصة العريقة والمفتوحة المصدر لأتمتة المنازل الذكية التي تجمع مئات البروتوكولات والأجهزة (Zigbee وZ-Wave وKNX وMQTT وMatter) في مركز تحكم محلي ومستقل.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر openHAB على المنفذ 8187 مع حفظ دائم للإعدادات وبيانات المستخدم والإضافات.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/openhab/openhab-ubuntu.sh
chmod +x openhab-ubuntu.sh
sudo bash openhab-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/openhab/openhab-ubuntu.sh

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

chmod +x openhab-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين للإعدادات وبيانات المستخدمين وتشغيل حاوية openHAB الرسمية على المنفذ 8187.

sudo bash openhab-ubuntu.sh

4 إتمام معالج الإعداد

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8187 لبدء معالج الإعداد الأولي لـ openHAB. أنشئ حساب المشرف، وحدد لغتك وموقعك الجغرافي، وابدأ في ربط أجهزتك الذكية.

http://<your-server-ip>:8187

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

المنفذالغرض
8187Web UI (host → container 8080)
setup wizardNo default login — create the admin on first visit
conf, userdata, addonsYour entire configuration, persisted to disk

نظرة عامة

تعد openHAB (Open Home Automation Bus) منصة أتمتة منازل ومبانٍ ذكية متقدمة ومفتوحة المصدر ومحايدة للشركات المصنعة، تم بناؤها بلغة Java. تعمل المنصة على المنفذ 8187 (المحول من منفذ 8080 الداخلي)، وتعمل كجسر عالمي يربط بين مختلف المعايير والبروتوكولات الذكية المنفصلة: Zigbee وZ-Wave وKNX وEnOcean وModbus وMQTT وMatter وApple HomeKit وGoogle Assistant وأجهزة Philips Hue وShelly. ومن خلال تحويل الأجهزة لنماذج كائنات موحدة، تتيح لك بناء سيناريوهات أتمتة ذكية ولوحات تحكم جدارية تعمل محلياً 100% داخل منزلك دون أي اعتماد على خوادم السحابة.

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

تقوم الشركات المصنعة للأجهزة الذكية (مثل Tuya وHue وAqara) بحبس أجهزتك داخل تطبيقاتها السحابية الخاصة التي لا تتواصل مع بعضها وتتعطل فور انقطاع الإنترنت. يحل openHAB هذه المشكلة بتوفير مركز تحكم محلي ومستقل تماماً؛ حيث تتم كافة عمليات اكتشاف الأجهزة، وقراءة الحساسات، وتشغيل قواعد الأتمتة محلياً داخل سيرفرك، مما يضمن استجابة فورية للأوامر، واستقراراً دائماً، وحماية خصوصية بيانات منزلك.

متى تحتاجه

  • تمتلك أجهزة ذكية من شركات وبروتوكولات متعددة (Zigbee وZ-Wave وKNX وMQTT وWi-Fi) وتريد دمجها في تطبيق ولوحة تحكم واحدة
  • ترغب في تشغيل الأتمتة والتحكم محلياً 100% مع ضمان استمرار عمل المنزل حتى عند انقطاع الإنترنت بالكامل
  • تحتاج إلى دعم بروتوكولات المباني الذكية والمصانع الاحترافية (مثل أنظمة KNX وModbus وEnOcean)
  • تريد تصميم لوحات تحكم جدارية مخصصة للشاشات اللوحية والهواتف بتصميمات وأيقونات تفاعلية
  • تبحث عن منصة أتمتة قوية بلغة Java تدعم كتابة قواعد وسيناريوهات برمجية متقدمة (Blockly وJavaScript وPython)

من يحتاجه

  • هواة ومطورو المنازل الذكية الباحثون عن استقلالية تامة وحرية اختيار الأجهزة والبروتوكولات
  • الفنيون ومهندسو الشبكات الذين ينفذون مشاريع أتمتة الفلل والمباني باستخدام أنظمة KNX وModbus
  • المستخدمون الحريصون على الخصوصية الذين يرفضون إرسال بيانات الكاميرات والحساسات لخوادم الشركات
  • المطورون والمهندسون الذين يفضلون كتابة سيناريوهات الأتمتة بلغات برمجية حديثة
  • مديرو المرافق لمراقبة استهلاك الطاقة وأنظمة التكييف والحساسات في المكاتب والمباني التجارية

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

  • دمج إضاءات Philips Hue مع ريليهات Shelly وحساسات الحركة Zigbee في سيناريوهات إضاءة متزامنة
  • ربط شبكات المباني الذكية KNX مع المساعدات الصوتية الحديثة (Apple HomeKit وGoogle Assistant)
  • تحسين استهلاك الطاقة الشمسية بتشغيل مضخات الحرارة وشواحن السيارات تلقائياً عند زيادة توليد الألواح
  • بناء لوحة تحكم لشاشة لوحية مثبتة على الجدار تعرض درجات حرارة الغرف وكاميرات المراقبة والطقس
  • تنفيذ سيناريوهات أمان معقدة: تشغيل كشافات الطوارئ وإرسال تنبيهات للهواتف عند رصد حركة غير معتادة ليلاً

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

  • معمارية إضافات (Bindings) شاملة تدعم أكثر من 400 بروتوكول وعلامة تجارية مختلفة
  • واجهة مستخدم عصرية (Main UI) ببطاقات متجاوبة، ومخططات أرضية للمنزل، ومكونات تفاعلية للشاشات
  • محرك قواعد مرن: إنشاء الأتمتة بصرياً بـ Blockly أو برمجياً عبر JavaScript (ES2021) وPython وRules DSL
  • النموذج الدلالي (Semantic Model): تنظيم الأجهزة هرمياً حسب المواقع (غرف، طوابق)، والمعدات، والنقاط التشغيلية
  • تشغيل محلي بالكامل يضمن عدم الاعتماد على السحابة وسرعة استجابة فائقة في أجزاء من الثانية
  • دعم أصلي للمساعدات الصوتية وأنظمة Apple HomeKit وAmazon Alexa وGoogle Home
  • محرك حفظ تاريخي للبيانات يدعم قواعد RRD4j وInfluxDB وPostgreSQL لتسجيل قراءات الحساسات
  • نشر معزول عبر Docker مع ربط مجلدات ./conf و./userdata و./addons لحفظ الإعدادات بشكل دائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8187 لبدء معالج إعداد openHAB
  • أنشئ حساب المشرف الرئيسي باسم مستخدم وكلمة مرور قوية
  • اضبط الإعدادات الإقليمية (اللغة، الدولة، المنطقة الزمنية، والموقع الجغرافي لتحديد أوقات الشروق والغروب)
  • انتقل إلى Settings ← Bindings لتثبيت إضافات أجهزتك (مثل MQTT وZigbee وPhilips Hue وKNX وShelly)
  • انتقل إلى صندوق الوارد (Inbox) لاستعراض الأجهزة المكتشفة تلقائياً على شبكتك واضغط Add as Thing
  • انتقل لقسم Model لترتيب وتنظيم الأجهزة حسب الغرف والطوابق لإنشاء الواجهات التلقائية
  • انتقل لقسم Rules لإنشاء سيناريوهات الأتمتة (مثل إطفاء الأنوار ليلاً أو تشغيل الإضاءة بالحركة)
  • ضع openHAB خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx أو Caddy) لتأمين الوصول للوحة التحكم عن بُعد

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

  • اختر كلمة مرور قوية لحساب المشرف أثناء معالج الإعداد الأولي لحماية التحكم في أجهزة المنزل المادية
  • لا تفتح المنفذ 8187 للإنترنت العام مباشرة، بل اتصل بمنزلك عن بُعد عبر شبكة VPN آمنة (WireGuard) أو سحابة myopenHAB الآمنة
  • استخدم تشفير HTTPS عبر وكيل عكسي لحماية الاتصال في الشبكات الخارجية
  • اعزل أجهزة إنترنت الأشياء (IoT) في شبكة VLAN منفصلة لمنع الأجهزة الذكية المخترقة من الوصول للسيرفر
  • احمِ مجلدي الإعدادات والبيانات بصلاحيات مناسبة على نظام الملفات
  • حدّث حاوية openhab/openhab دورياً للحصول على التحديثات الأمنية وإصلاحات الإضافات

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

يستمع openHAB لواجهة الويب والواجهات البرمجية REST وقنوات WebSockets على منفذ TCP 8187 (المحول من 8080 الداخلي). يجب السماح بهذا المنفذ على شبكتك المحلية (ufw allow 8187/tcp). وإذا كنت تستخدم ميزات الاكتشاف التلقائي عبر UPnP أو mDNS، فتأكد من ضبط إعدادات شبكة الحاوية للسماح بمرور حزم البث المتعدد (Multicast). وأبقِ المنفذ مغلقاً في جدار الحماية الخارجي.

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

  • انسخ مجلد ./conf احتياطياً، والذي يحتوي على كافة ملفات الإعداد النصية والمستودعات والقواعد والسكريبتات
  • انسخ مجلد ./userdata احتياطياً، والذي يحتوي على قاعدة بيانات JSON الداخلية، وحالة الأجهزة، وحسابات المستخدمين
  • استخدم أداة النسخ الاحتياطي المدمجة داخل الحاوية: `docker exec -it openhab /openhab/runtime/bin/backup`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • اختبر الاستعادة بربط مجلدي conf وuserdata بحاوية تجريبية للتأكد من ظهور كافة الأجهزة والقواعد بنجاح

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

  • توصيل محولات Zigbee أو Z-Wave عبر USB دون تمرير المنفذ التسلسلي للحاوية في ملف docker-compose (مثل `devices: - /dev/ttyUSB0:/dev/ttyUSB0`)
  • عدم ضبط المنطقة الزمنية الصحيحة في متغيرات البيئة، مما يسبب تشغيل الأتمتة المجدولة وجداول الشروق والغروب في أوقات خاطئة
  • فتح المنفذ 8187 للإنترنت العام مباشرة دون حماية، مما يتيح للمخترقين التحكم في الأقفال والإضاءة
  • عدم ربط مجلدي التخزين الدائم ./conf و./userdata، مما يؤدي لفقدان الأجهزة والقواعد والواجهات عند تحديث الحاوية
  • تشغيل النظام على سيرفر بذاكرة أقل من 1.5 جيجابايت RAM، مما يسبب بطئاً وانهياراً لبيئة Java عند تفعيل العديد من الإضافات

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

  • الأجهزة المكتشفة تظهر بحالة 'Offline' — تأكد من عنوان IP للجهاز، وتوصيله بالكهرباء، وصحة إعدادات الإضافة في قسم Settings
  • عدم اكتشاف محول USB التسلسلي — تأكد من منح صلاحيات dialout للمستخدم على السيرفر وتمرير المنفذ في Docker
  • قواعد الأتمتة لا تعمل — افتح Settings ← Developer Tools ← Events لمراقبة تدفق الأحداث وتغير حالات الحساسات لحظياً
  • واجهة الويب لا تفتح — افحص سجلات الحاوية بالأمر: docker logs openhab -f لمعرفة تفاصيل أخطاء بيئة Java
  • استهلاك ذاكرة مرتفع — راجع الإضافات المثبتة وأزل الإضافات غير المستخدمة واضبط معاملات Java Xmx Heap إذا لزم الأمر

البدائل

منصة Home Assistant هي المنظومة الأكثر شهرة عالمياً لأتمتة المنازل والمبنية بـ Python مع مجتمع مستخدمين ضخم. منصة ioBroker منصة أتمتة معيارية مبنية بـ Node.js شائعة في أوروبا. منصة Node-RED أداة برمجية بصرية رائعة لربط الأجهزة عبر تدفقات MQTT. نظام Domoticz نظام خفيف جداً مبني بـ C++.

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

تجنب استخدام openHAB إذا كنت تفضل بيئة العمل المعتمدة على Python وتفضل استخدام قوالب الأتمتة المجتمعية الجاهزة (Blueprints) في Home Assistant. وإذا كنت تحتاج فقط لمنطق أتمتة بصري وبسيط لربط مواضيع MQTT دون الحاجة لنمذجة المنازل الذكية الشاملة، فإن Node-RED أسهل وأسرع.

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

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

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

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

ما الفرق بين openHAB وHome Assistant؟

تم بناء openHAB بلغة Java ويتميز بدعمه القوي للبروتوكولات المؤسسية للمباني (مثل KNX وModbus) والنموذج الدلالي المنظم. بينما بني Home Assistant بلغة Python ويمتلك قاعدة مستخدمين ضخمة وتكاملاً واسعاً مع الأجهزة الاستهلاكية المنزلية.

هل يتطلب openHAB اتصالاً بالإنترنت ليعمل؟

لا، يعتمد openHAB على معمارية محلية بالكامل (Local-First). وتتم كافة الحسابات والأتمتة والتحكم في الأجهزة محلياً داخل شبكة منزلك، وتستمر بالعمل بنسبة 100% حتى مع انقطاع الإنترنت.

ما هو النموذج الدلالي (Semantic Model) في openHAB؟

النموذج الدلالي هو إطار هيكلي يتيح لك تصنيف أجهزتك حسب الموقع (مثل: غرفة المعيشة)، والمعدة (مثل: إضاءة السقف)، والنقطة (مثل: زر التشغيل)، مما يولد واجهات تلقائية ويتيح التحكم الصوتي الذكي.

هل يمكن استخدام Apple HomeKit وGoogle Assistant مع openHAB؟

نعم، يوفر openHAB إضافات رسمية لـ HomeKit وGoogle Assistant تتيح إظهار أجهزتك ومفاتيحك المحلية مباشرة داخل تطبيق Apple Home ومساعد Google Home.

كم يستهلك openHAB من الذاكرة العشوائية (RAM)؟

يعمل openHAB داخل بيئة Java (JVM) ويستهلك عادة ما بين 400 إلى 900 ميجابايت من الذاكرة العشوائية اعتماداً على عدد الإضافات والأجهزة ومحركات الحفظ المفعلة.