📡 تثبيت Domoticz — أتمتة منزلية خفيفة
انشر Domoticz على Ubuntu بـ Docker — نظام أتمتة منزلية خفيف يدعم أجهزة Z-Wave وMQTT وRFXCOM، وخفيف بما يكفي للعمل على Raspberry Pi، على المنفذ 8284.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/domoticz/domoticz-ubuntu.sh
chmod +x domoticz-ubuntu.sh
./domoticz-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/domoticz/domoticz-ubuntu.sh
2 جعله قابلاً للتنفيذ
chmod +x domoticz-ubuntu.sh
3 تشغيل المثبّت
./domoticz-ubuntu.sh
4 فتح واجهة الويب وإضافة الأجهزة
http://your-server-ip:8284
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8284 | Domoticz web interface (mapped from container port 8080) |
نظرة عامة
Domoticz نظام أتمتة منزلية خفيف ومفتوح المصدر لمراقبة والتحكم في الإضاءة والمفاتيح والثرموستات والحساسات من واجهة ويب واحدة. يتواصل مباشرة مع أجهزة المنزل الذكي الحقيقية عبر بروتوكولات مثل Z-Wave وZigbee وMQTT وRFXCOM، ويوفّر أتمتة قائمة على القواعد (سكربتات Lua أو dzVents أو Blockly المرئية)، ويحتفظ بسجل كامل لكل قراءة حساس — كل ذلك دون الحاجة لسيرفر قوي.
لماذا تستخدمه
يعمل Domoticz بارتياح على أجهزة متواضعة — Raspberry Pi أو VPS صغير — حيث تعاني منصات أثقل مثل Home Assistant. يتواصل مع أجهزة Z-Wave وMQTT وRFXCOM محلياً دون سحابة أي شركة مصنّعة في المنتصف، لذا تبقى أتمتتك ولوحاتك تعمل حتى بدون اتصال إنترنت. للمستخدمين الذين يملكون بالفعل أجهزة Z-Wave أو RFXCOM ويريدون متحكماً مستقراً منخفض الموارد بدلاً من أكبر نظام تكامل ممكن، يُعد Domoticz خياراً ناضجاً ومُثبَتاً بأكثر من عقد من التطوير النشط.
متى تحتاجه
- تملك أجهزة منزل ذكي تعمل بـ Z-Wave أو Zigbee أو RFXCOM أو MQTT وتحتاج متحكماً مركزياً يوحّدها
- تُشغّل أتمتة منزلية على جهاز محدود الموارد، مثل Raspberry Pi أو VPS منخفض الإمكانيات، حيث يبدو Home Assistant ثقيلاً جداً
- تريد أتمتة قائمة على القواعد (تشغيل الأضواء عند الغروب، تنبيه عند حساس باب) دون الاعتماد على تطبيق سحابي من الشركة المصنّعة
- تحتاج تسجيلاً تاريخياً طويل الأمد لبيانات حساسات الحرارة والطاقة والمرافق مع رسوم بيانية مدمجة
- تريد أتمتة منزلية محلية بالكامل تستمر في العمل أثناء انقطاع الإنترنت
- تدمج عداد طاقة ذكي من نوع P1 أو أجهزة قياس مرافق أخرى شائعة في المنازل الأوروبية
من يحتاجه
- أصحاب المنازل الذين يملكون أجهزة Z-Wave أو Zigbee أو RFXCOM بالفعل ويريدون لوحة واحدة للتحكم بكل شيء
- هواة Raspberry Pi والحواسيب أحادية اللوحة الذين يحتاجون منصة أتمتة منزلية تتناسب مع ذاكرة ومعالج محدودين
- المستخدمون المهتمون بالخصوصية الذين يريدون تشغيل أتمتتهم بالكامل على جهاز محلي دون اعتماد على سحابة
- الأسر المهتمة بالطاقة التي تتابع بيانات عدادات المرافق (غاز وكهرباء وماء) عبر اتصال عداد ذكي P1
- مستخدمو Domoticz القدامى الذين يرحّلون إعدادهم الحالي إلى سيرفر جديد قائم على Docker لسهولة الصيانة
- المستضيفون الذاتيون الذين يريدون نظام أتمتة ثانوياً خفيفاً بجانب منصة أكبر لدعم الأجهزة القديمة
حالات الاستخدام الشائعة
- أتمتة الإضاءة والمفاتيح بناءً على وقت اليوم أو الغروب/الشروق أو تشغيل حساس الحركة
- مراقبة حساسات الحرارة والرطوبة والمرافق (غاز/كهرباء/ماء) مع رسوم بيانية تاريخية
- التحكم بأقفال الأبواب وثرموستات وحساسات النوافذ من نوع Z-Wave من لوحة واحدة
- استلام إشعارات فورية أو تنبيهات عند تشغيل حساس باب/نافذة أو انقطاع جهاز عن الشبكة
- ربط أجهزة RFXCOM 433MHz مثل محطات الطقس والحساسات البعيدة بمنصة أتمتة حديثة
- بناء قواعد أتمتة مخصصة بسكربتات dzVents (المبنية على Lua) لمنطق شرطي
الميزات الرئيسية
- دعم واسع لبروتوكولات الأجهزة — Z-Wave وZigbee (عبر MQTT) وRFXCOM وعدادات ذكية P1 وواحد سلك 1-Wire والمزيد
- محرك أتمتة قائم على القواعد بسكربتات dzVents (Lua) ومحرر Blockly المرئي لغير المبرمجين
- تسجيل تاريخي ورسوم بيانية مدمجة لكل حساس — الحرارة والرطوبة والطاقة واستهلاك المرافق
- بصمة موارد منخفضة — يعمل بارتياح على Raspberry Pi أو VPS صغير باستخدام أدنى قدر من الذاكرة والمعالج
- تكامل MQTT للربط مع Zigbee2MQTT وأجهزة Tasmota وأنظمة أخرى قائمة على MQTT
- لوحة ويب متوافقة مع الجوال مع أدوات قابلة للتخصيص ومخططات طوابق وتكامل كاميرات
- دعم الإشعارات عبر البريد الإلكتروني وPushover وTelegram وخدمات أخرى عند تشغيل تنبيهات الحساسات
- لا حاجة لحساب سحابي إلزامي أو اشتراك — يعمل النظام بالكامل محلياً على سيرفرك الخاص
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:8284 واضبط فوراً اسم مستخدم وكلمة مرور للمشرف تحت Setup → Settings
- اذهب إلى Setup → Hardware وأضف متحكم Z-Wave USB أو جهاز RFXCOM أو اتصال وسيط MQTT الخاص بك
- بمجرد إضافة الجهاز، اذهب إلى تبويب Devices لاكتشاف وإضافة الحساسات والمفاتيح الفردية إلى لوحتك
- نظّم الأجهزة في غرف وأنشئ أدوات لوحة تحكم مخصصة تحت تبويب Floorplans أو Dashboard
- أعدّ سكربتات أتمتة dzVents أو Blockly تحت Setup → More Options → Event لأتمتة الإضاءة والتنبيهات والجداول
- اضبط خدمات الإشعارات (بريد إلكتروني، Pushover، Telegram) تحت Setup → Settings → Notifications لتنبيهات الحساسات
- إذا كنت تستخدم عداد ذكي P1، صله تحت Hardware واربط قراءات المرافق بأجهزة الطاقة في Domoticz
- تحقق بانتظام من تبويب Setup → Log لأخطاء اتصال الأجهزة، خاصة بعد إعادة تشغيل Docker أو تغيير أجهزة USB
أفضل ممارسات الأمان
- اضبط اسم مستخدم وكلمة مرور للمشرف فوراً بعد أول تشغيل — يبدأ Domoticz بدون أي مصادقة مُعدّة على الإطلاق
- ضع Domoticz خلف وكيل عكسي مع HTTPS إذا احتجت وصولاً عن بُعد، فواجهة الويب الافتراضية HTTP عادي
- لا تكشف المنفذ 8284 مباشرة للإنترنت دون مصادقة وTLS — التحكم في الأتمتة المنزلية هدف جدي
- استخدم VPN مثل WireGuard للوصول عن بُعد بدلاً من إعادة توجيه منفذ Domoticz مباشرة للإنترنت
- قيّد وصول الشبكة المحلية لواجهة ويب Domoticz بقواعد جدار ناري إذا كانت أجهزة غير موثوقة عديدة تشارك شبكتك
- أبقِ صورة Domoticz Docker محدّثة لتحصل على إصلاحات أمنية، خاصة لسيرفر الويب المدمج
- راجع قسم Setup → Users دورياً إذا أنشأت حسابات إضافية لأفراد الأسرة
- انسخ إعداداتك احتياطياً قبل تفعيل أي سكربت Lua أو dzVents مخصص من مصدر غير موثوق، فالسكربتات يمكنها تشغيل أي منطق أتمتة
المنافذ وإعدادات جدار الحماية
تعمل واجهة ويب Domoticz على منفذ المضيف 8284، المُعيّن من منفذ الحاوية الداخلي 8080. هذا هو المنفذ الوحيد الذي يحتاج معظم المستخدمين كشفه، وفقط على الشبكة المحلية — فـ Domoticz لا يملك أي مصادقة حتى تُعدّها بنفسك، لذا يجب ألا يكون قابلاً للوصول من الإنترنت أبداً دون وكيل عكسي يضيف HTTPS وفرض تسجيل دخول، أو VPN. إذا وصلت جهاز USB من نوع Z-Wave أو Zigbee أو RFXCOM، يجب تمرير ذلك الجهاز للحاوية (عبر تعيين جهاز في Docker Compose) بدلاً من كشفه كمنفذ شبكة — فهو غير مرئي داخل Docker تلقائياً.
النسخ الاحتياطي والصيانة
- انسخ دليل بيانات Domoticz احتياطياً، الذي يحتوي قاعدة بيانات SQLite بكل الأجهزة والسجل والإعدادات
- صدّر سكربتات dzVents وBlockly الخاصة بك بشكل منفصل، فالمنطق المخصص قيّم ويسهل فقدان أثره
- وثّق اقترانات أجهزتك (معرّفات عقد Z-Wave، معرّفات أجهزة RFXCOM) لأن إعادة اقترانها بعد الاستعادة قد تكون مملة
- انسخ docker-compose.yml احتياطياً، بما في ذلك أي تعيينات أجهزة USB، لإعادة إنشاء نفس تمرير الأجهزة بالضبط على مضيف جديد
- خزّن النسخ الاحتياطية خارج نفس القرص الذي تعمل عليه الحاوية، خاصة قبل تحديثات برامج تشغيل متحكمات Z-Wave أو Zigbee
- اختبر استعادة كاملة دورياً على جهاز احتياطي للتأكد من بقاء السجل واقترانات الأجهزة سليمة بعد العملية
الأخطاء الشائعة
- ترك Domoticz بدون كلمة مرور مشرف مُعدّة، فهو يبدأ مفتوحاً بالكامل دون طلب تسجيل دخول
- كشف المنفذ 8284 مباشرة للإنترنت، مما يحوّل لوحة أتمتة منزلية غير مُصادَقة إلى هدف عام
- نسيان تمرير جهاز USB من نوع Z-Wave أو RFXCOM لحاوية Docker، فلا يظهر الجهاز أبداً تحت Setup → Hardware
- تشغيل Domoticz بدون restart: unless-stopped، فتترك إعادة تشغيل السيرفر أتمتتك ولوحاتك بلا اتصال
- خلط منطق معقّد كثيراً في إعدادات الأجهزة الفردية بدلاً من مركزة الأتمتة في سكربتات dzVents
- عدم عمل نسخة احتياطية لقاعدة بيانات SQLite قبل ترقية إصدار رئيسي، مما يعرّض سنوات من بيانات الحساسات التاريخية للفقدان
- افتراض أن Domoticz يكتشف أجهزة MQTT تلقائياً دون إعداد اتصال جهاز MQTT يدوياً أولاً
- تجاهل تبويب Setup → Log، الذي يُظهر عادة السبب الدقيق لعدم اتصال قطعة من الأجهزة
استكشاف الأخطاء وإصلاحها
- واجهة الويب غير قابلة للوصول على المنفذ 8284 — تحقق من أن الحاوية تعمل بـ docker ps وأن المنفذ 8284 غير محظور بجدار الحماية المضيف
- عصا Z-Wave أو RFXCOM USB غير مكتشفة — تأكد من تمرير الجهاز للحاوية بمسار الجهاز الصحيح في docker-compose.yml
- لا يوجد طلب تسجيل دخول وتحكم كامل باللوحة — هذا متوقع حتى تُعدّ حساب مشرف تحت Setup → Settings
- أجهزة MQTT لا تظهر — تحقق من أن إدخال جهاز MQTT تحت Setup → Hardware يحتوي عنوان الوسيط الصحيح وبادئة الموضوع
- سجل الحساسات مفقود أو الرسوم البيانية فارغة — تحقق من ضبط فاصل تسجيل الجهاز وأن قاعدة بيانات SQLite ليست ممتلئة أو تالفة
- سكربتات dzVents لا تُشغَّل — تحقق من Setup → Log لأخطاء صياغة السكربت وتأكد من تعريف حدث التشغيل (تغيير جهاز، وقت، إلخ) بشكل صحيح
- الجهاز يظهر غير متاح بعد إعادة تشغيل Docker — مسارات أجهزة Z-Wave/RFXCOM USB قد تتغير عند إعادة التشغيل؛ فكّر باستخدام مسار ثابت /dev/serial/by-id بدلاً من /dev/ttyUSB0
- عداد الطاقة الذكي P1 لا يقرأ بيانات — تحقق من ضبط المنفذ التسلسلي الصحيح ومعدل البود وأن كابل بيانات العداد موصول بإحكام
البدائل
Home Assistant أقدر بكثير — مكتبة تكاملات أكبر وواجهة أكثر صقلاً ومجتمع أكبر وأدوات أتمتة أقوى — لكنه يتطلب معالجاً وذاكرة أكبر بكثير. openHAB خيار ناضج آخر مستقل عن البروتوكول بمحركات قواعد بأسلوب مؤسسي قوية لكن بمنحنى تعلّم أكثر حدة. Homebridge يركّز تحديداً على إدخال الأجهزة إلى Apple HomeKit بدلاً من كونه متحكماً عاماً. تخصص Domoticz متعمد: متحكم خفيف ومستقر لأجهزة Z-Wave/RFXCOM/MQTT يعمل بشكل جيد على أجهزة محدودة مثل Raspberry Pi حيث سيكون Home Assistant أبطأ بشكل ملحوظ.
متى لا تستخدمه
إذا أردت أكبر نظام تكامل ممكن، أو أكثر تطبيق جوال صقلاً، أو توافقاً وثيقاً مع أحدث معايير المنزل الذكي مثل Matter، فـ Home Assistant هو الخيار الأفضل دعماً اليوم. إذا كان هدفك الوحيد تكامل HomeKit للمنازل التي تعتمد على Apple فقط، فـ Homebridge أكثر مباشرة. تجنّب Domoticz إذا كنت تحتاج فريقاً كبيراً من المساهمين يضيفون تكاملات أجهزة جديدة أسبوعياً — وتيرة إصداراته ومجتمعه أصغر من Home Assistant. للإعدادات الأساسية جداً بمقابس ذكية قليلة فقط دون أجهزة Z-Wave/RFXCOM، قد يكون تطبيق الشركة المصنّعة نفسه ببساطة أقل جهداً من تشغيل متحكم مخصص.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Domoticz؟
Domoticz نظام أتمتة منزلية خفيف لمراقبة والتحكم في الإضاءة والمفاتيح والحساسات والمزيد من واجهة ويب واحدة. يدعم البروتوكولات التي تستخدمها أجهزة المنزل الذكي الحقيقية — Z-Wave وMQTT وRFXCOM وغيرها — ويوفّر أتمتة قائمة على القواعد ويسجّل تاريخ الحساسات.
ما المنفذ الذي يستخدمه وما بيانات تسجيل الدخول؟
يعمل Domoticz على منفذ المضيف 8284، المُعيّن من منفذ الحاوية 8080. والأهم أنه يبدأ بدون أي مصادقة مُعدّة — لا يوجد تسجيل دخول افتراضي لأنه لا يوجد تسجيل دخول أصلاً حتى تضبط واحداً بنفسك.
هل يمكنه استخدام عصا Z-Wave USB الخاصة بي؟
نعم، لكن يجب تمرير متحكم USB للحاوية. عصا Z-Wave أو Zigbee موصولة بالمضيف ليست مرئية تلقائياً داخل Docker — يحتاج إعداد compose لتعيين جهاز USB هذا داخل الحاوية.
كيف يقارَن بـ Home Assistant؟
Home Assistant أقدر بكثير — تكاملات أكثر، وواجهة أكثر صقلاً، ومجتمع أكبر، وأتمتة أقوى — لكنه أثقل بكثير ويطلب موارد أكثر. Domoticz خفيف عمداً ويعمل بشكل جيد على أجهزة يعاني عليها Home Assistant.
هل يعمل بدون إنترنت؟
نعم — هذه فائدة أساسية. يتواصل Domoticz مع أجهزة Z-Wave وMQTT وRFXCOM الخاصة بك محلياً ومباشرة، دون سحابة أي شركة مصنّعة في المنتصف، لذا تستمر أتمتتك وتحكمك حتى عند انقطاع اتصال الإنترنت.