📡 تثبيت ThingsBoard — منصة إنترنت الأشياء (IoT) ولوحات المراقبة على Docker

نشر منصة ThingsBoard Community Edition على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لإدارة أجهزة إنترنت الأشياء، ووسيط MQTT، ولوحات قياس الحساسات على المنفذ 8158.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر ThingsBoard على المنفذ 8158 مع قاعدة بيانات PostgreSQL ووسيط MQTT على المنفذ 1884 ومحرك القواعد جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x thingsboard-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات البيانات (`./mytb-data`) والسجلات (`./mytb-logs`) وتهيئة قاعدة بيانات PostgreSQL وتشغيل ThingsBoard على المنفذ 8158 وMQTT على المنفذ 1884.

sudo bash thingsboard-ubuntu.sh

4 تسجيل الدخول وربط أول جهاز IoT

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8158. سجل الدخول ببيانات المشرف الافتراضية (`sysadmin@thingsboard.org` / `sysadmin`)، وأنشئ جهازك الأول بتوكن الوصول، وصمم لوحة مراقبة تفاعلية حية لحساساتك.

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

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

المنفذالغرض
8158Web UI + REST API (host → container 9090)
1884MQTT telemetry (host → container 1883)
5683-5688/udpCoAP telemetry

نظرة عامة

تعد ThingsBoard منصة إنترنت الأشياء (IoT Platform) مفتوحة المصدر الرائدة عالمياً لربط الأجهزة الذكية، وجمع بيانات الحساسات اللحظية، ومعالجة البيانات بصرياً، وإدارة أساطيل الأجهزة. تعمل المنصة عبر المنفذ 8158 (لوحة الويب والـ REST API)، والمنفذ 1884 (وسيط MQTT للحساسات)، ومنفذ CoAP 5683 بالاعتماد على قاعدة بيانات PostgreSQL، لتتيح لمهندسي الأنظمة ربط آلاف المتحكمات (ESP32 وArduino وRaspberry Pi وبوابات LoRaWAN)، وتصميم لوحات تحكم بصرية غنية (عدادات، خرائط جغرافية، رسوم بيانية)، وبناء محركات قواعد بالسحب والإفلات وتوليد التنبيهات والتحكم بالأجهزة عن بُعد (RPC).

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

تفرض منصات الـ IoT السحابية التجارية (مثل AWS IoT Core وAzure IoT Hub) تكاليف باهظة تُحسب بعدد الرسائل، وتقيدك بحزم برمجية مغلقة، وتخزن بيانات مصانعك وحساساتك الحساسة بسحابات خارجية. تمنحك ThingsBoard حزمة إنترنت أشياء مؤسسية متكاملة ومستضافة ذاتياً مع سيادة كاملة لبياناتك: اربط آلاف الأجهزة ببروتوكولات MQTT وHTTP وCoAP بدون أي رسوم للرسائل، وصمم لوحات تحكم متجاوبة بالكامل، وعالج منطق البيانات محلياً على سيرفرك الخاص.

متى تحتاجه

  • تحتاج إلى منصة إنترنت أشياء قابلة للتوسع لإدارة مئات أو آلاف المتحكمات الذكية (ESP32 وRaspberry Pi وLoRaWAN)
  • تريد استقبال بيانات الحساسات ببروتوكولات متعددة تشمل MQTT (منفذ 1884) وHTTP/REST وCoAP (منفذ 5683)
  • تحتاج إلى لوحات تحكم متجاوبة وفورية تضم عدادات رقمية، ورسوم بيانية زمنية، وخرائط تتبع جغرافية، ومفاتيح تحكم
  • تريد محرك قواعد بصري بالسحب والإفلات لفلترة ومعالجة بيانات الحساسات وإرسال تنبيهات فورية عبر البريد وتيليجرام
  • تريد إمكانية التحكم الثنائي بالأجهزة عن بُعد (RPC) لتشغيل المحركات، وتغيير الإعدادات، وإرسال تحديثات الفيرموير

من يحتاجه

  • مهندسو إنترنت الأشياء ومطورو العتاد الذكي لبناء ومراقبة المنتجات التجارية والحساسات الصناعية
  • مهندسو الأتمتة الصناعية وأنظمة SCADA لمراقبة ماكينات المصانع، ومستويات الخزانات، وعدادات الطاقة
  • مديرو المزارع الذكية والبيوت المحمية لمراقبة رطوبة التربة، ومحطات الطقس، والتحكم بمضخات الري آلياً
  • مديرو أساطيل النقل والمدن الذكية لتتبع المركبات بالـ GPS على الخرائط ومراقبة عدادات المرافق العامة
  • أصحاب السيرفرات المنزلية لبناء شبكة مراقبة شاملة لحساسات المنزل والطاقة بالاعتماد على متحكمات ESP32

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

  • بث قراءات الحرارة والرطوبة من 50 متحكم ESP32 عبر بروتوكول MQTT إلى لوحة مراقبة موحدة بالزمن الفعلي
  • تفعيل تنبيه طوارئ آلي وإرسال رسالة في تيليجرام والبريد الإلكتروني فور تجاوز حرارة غرفة السيرفرات 30 درجة مئوية
  • تشغيل وإيقاف مضخة مياه زراعية عن بُعد عبر مفتاح تحكم تفاعلي باللوحة يرسل أمر RPC للمتحكم
  • تتبع أسطول سيارات التوصيل على خريطة تفاعلية حية توضح المسار والسرعة الحالية باستخدام إحداثيات GPS
  • تجميع بيانات استهلاك الطاقة الأسبوعية من عدادات Modbus الكهربائية وتصديرها كتقارير CSV

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

  • استقبال ببروتوكولات متعددة: دعم أصلي لـ MQTT (منفذ 1884)، وHTTP، وCoAP (منفذ 5683)، وبروتوكول LwM2M
  • مصمم لوحات تفاعلي على المنفذ 8158: أكثر من 30 حزمة أدوات بصرية (رسوم بيانية، عدادات، خرائط، مفاتيح تحكم)
  • محرك قواعد بصري بالسحب والإفلات: بناء مسارات معالجة الأحداث والتحويلات الرياضية وتوليد التنبيهات برمجياً
  • إدارة الإنذارات والتنبيهات: إنشاء وتصعيد وإلغاء التنبيهات وفق مستويات خطورة متعددة (حرجة، كبرى، صغرى)
  • تحكم ثنائي الاتجاه بـ RPC: إرسال أوامر التحكم المباشرة للأجهزة واستقبال تأكيد التنفيذ فورياً
  • معمارية متعددة المستأجرين (Multi-Tenant): فصل حسابات العملاء والمنظمات الفرعية ومجموعات الأجهزة والصلاحيات
  • تحديث الفيرموير عبر الهواء (FOTA): إدارة وتوزيع ملفات التحديث البرمجي للأجهزة عن بُعد
  • معمارية Docker Compose تجمع ThingsBoard Community Edition مع قاعدة PostgreSQL على المنفذ 8158

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8158 لعرض لوحة تحكم ThingsBoard
  • سجل الدخول بحساب المشرف الرئيسي (`sysadmin@thingsboard.org` / `sysadmin`) وغيّر كلمة المرور فورياً
  • سجل الدخول بحساب المنظمة (`tenant@thingsboard.org` / `tenant`) وانتقل إلى 'Device Groups' ← '+ Add Device'
  • اكتب اسم الجهاز (مثل `ESP32-Sensor-01`) وانسخ توكن الوصول (Device Access Token)
  • برمج متحكمك أو اختبر الإرسال بأمر MQTT: `mosquitto_pub -h ip-سيرفرك -p 1884 -t 'v1/devices/me/telemetry' -u 'التوكن' -m '{"temperature":24.5}'`
  • أنشئ لوحة تحكم جديدة، وأضف رسم بياني زمني، واربطه بمفتاح القياس `temperature`
  • ضع ThingsBoard خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة

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

  • تنبيه أمني حاسم: غيّر كلمات المرور الافتراضية لحسابات `sysadmin` و`tenant` فور تسجيل الدخول لأول مرة
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لتأمين جلسات الدخول وإدارة الأجهزة عن بُعد
  • استخدم تشفير MQTTS (منفذ 8883 مع شهادات SSL) عند نشر الأجهزة عبر شبكات الإنترنت الخلوية العامة
  • أبقِ منفذ قاعدة البيانات الداخلي PostgreSQL 5432 مغلقاً في جدار الحماية الخارجي
  • احمِ مجلد البيانات `./mytb-data` الذي يحتوي على توكنات الأجهزة والبيانات بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات البروتوكولات

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

يستخدم ThingsBoard منفذ TCP 8158 للوحة الويب والـ API (المحول من 9090 الداخلي)، ومنفذ TCP 1884 لحركة MQTT (المحول من 1883 الداخلي)، ومنفذ UDP 5683 لـ CoAP. اسمح بالمنفذ 8158 محلياً (`ufw allow 8158/tcp`). وافتح منفذ MQTT 1884 للأجهزة بالشبكة (`ufw allow 1884/tcp`). وفي الإنتاج، وجه حركة الويب عبر وكيل عكسي مشفر بـ SSL على المنفذ 443.

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

  • انسخ مجلد `./mytb-data` احتياطياً، والذي يحتوي على ملفات الإعداد وحالة الأجهزة
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec thingsboard-db pg_dump -U postgres thingsboard > thingsboard_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع لوحات الحساسات والأجهزة بنجاح

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

  • ترك بيانات تسجيل الدخول الافتراضية (`sysadmin` و`tenant`) دون تغيير مما يتيح للغرباء السيطرة على أجهزتك
  • نشر رسائل MQTT إلى مسار (Topic) خاطئ (المسار الافتراضي الصحيح هو `v1/devices/me/telemetry`)
  • تشغيل ThingsBoard على سيرفر بذاكرة RAM أقل من 2 إلى 4 جيجابايت (حيث يتطلب محرك جافا ذاكرة كافية)
  • عدم ربط مجلد التخزين الدائم `./mytb-data`، مما يسبب فقدان توكنات الأجهزة وسجلات الحساسات عند تحديث الحاوية
  • كشف منفذ قاعدة البيانات الداخلي PostgreSQL 5432 للإنترنت العام مباشرة

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

  • ظهور خطأ 502 Bad Gateway في الواجهة — انتظر دقيقة إلى دقيقتين لاكتمال إقلاع جافا وقاعدة البيانات ثم راجع السجلات: `docker logs thingsboard -f`
  • أجهزة الـ MQTT تفشل في الاتصال — تأكد من وضع توكن الجهاز في حقل اسم المستخدم (Username) وفتح المنفذ 1884
  • بيانات الحساسات لا تظهر باللوحة — راجع تبويب Latest Telemetry داخل صفحة الجهاز للتأكد من وصول مفاتيح الـ JSON
  • محرك القواعد لا يرسل التنبيهات — راجع مسار الربط في شجرة الـ Rule Chain وافحص سجلات الـ Debug
  • انهيار الحاوية بسبب نفاد الذاكرة — خصص على الأقل 2 جيجابايت RAM للحاوية واضبط متغيرات جافا: `JAVA_OPTS=-Xms1g -Xmx2g`

البدائل

منصة Home Assistant لإدارة المنازل الذكية. حزمة Grafana مع InfluxDB وTelegraf للبيانات الزمنية. خدمات AWS IoT Core وAzure IoT السحابية. أداة Node-RED لربط مسارات البيانات. وسطاء MQTT المباشرون مثل Mosquitto وEMQX.

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

تجنب استخدام ThingsBoard إذا كنت تبحث فقط عن نظام تحكم منزلي سكني للمصابيح الذكية ومقابس Zigbee/Z-Wave (حيث صُممت Home Assistant للأتمتة المنزلية السكنية). وإذا كنت تحتاج فقط لوسيط MQTT بسيط بدون لوحات قياس أو محركات قواعد أو إدارة أجهزة، فإن وسيط Mosquitto أخف بكثير.

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

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

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

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

ما هي منصة ThingsBoard وكيف تتعامل مع بيانات الحساسات؟

تعد ThingsBoard منصة إنترنت أشياء مؤسسية مفتوحة المصدر، تتصل بالأجهزة عبر MQTT أو HTTP أو CoAP، وتجمع وتخزن قراءات الحساسات الزمنية بقاعدة بيانات PostgreSQL، وتعالج البيانات بمحرك قواعد بصري، وتعرضها على لوحات تحكم حية.

ما هي بيانات تسجيل الدخول الافتراضية لمنصة ThingsBoard؟

تتضمن المنصة 3 حسابات افتراضية: مدير النظام (`sysadmin@thingsboard.org` / `sysadmin`)، ومدير المنظمة (`tenant@thingsboard.org` / `tenant`)، ومستخدم العميل (`customer@thingsboard.org` / `customer`). ويجب تغيير كافة كلمات المرور فور التثبيت.

ما هي البروتوكولات التي تدعمها ThingsBoard لربط الأجهزة؟

تدعم ThingsBoard أصلياً بروتوكولات MQTT (منفذ 1884 / 8883) وHTTP/REST وCoAP (منفذ 5683) وLwM2M وSNMP، مما يتيح ربط أي نوع من المتحكمات أو الحساسات الصناعية بسهولة.

ما هو محرك القواعد (Rule Engine) في ThingsBoard؟

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

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

تم بناء ThingsBoard بلغة Java وتتضمن طابور رسائل مدمج وقاعدة بيانات PostgreSQL، وتستهلك عادة ما بين 1 إلى 2.5 جيجابايت من الذاكرة العشوائية داخل Docker.