📡 تثبيت EMQX — وسيط MQTT عالي الأداء وقابل للتوسع

انشر EMQX على Ubuntu بـ Docker — وسيط MQTT قابل للتوسع بشكل هائل لمراسلة إنترنت الأشياء، بلوحة إدارة غنية، يتعامل مع كل شيء من مختبر منزلي وحتى ملايين الأجهزة، مع MQTT على المنفذ 1885.

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

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

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

سكريبت تثبيت آلي — ينشر EMQX مع MQTT على المنفذ 1885، وMQTT آمن على 8883، ولوحة الإدارة على 18083. بيانات دخول اللوحة الافتراضية هي admin / public — غيّرها عند أول تسجيل دخول.
عرض على GitHub

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

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

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

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

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

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

chmod +x emqx-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر ويشغّل EMQX، كاشفاً MQTT على المنفذ 1885، وMQTT الآمن (TLS) على 8883، ولوحة الإدارة على 18083. تُحفظ بياناته وسجلاته في أحجام مُركّبة.

sudo bash emqx-ubuntu.sh

4 فتح لوحة الإدارة وتغيير كلمة المرور

افتح لوحة إدارة EMQX، سجّل الدخول ببيانات الاعتماد الافتراضية admin / public، وغيّر كلمة المرور فوراً:

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

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

المنفذالغرض
1885MQTT (host → container 1883)
8883Secure MQTT over TLS
18083Management dashboard — default login admin / public, change it

نظرة عامة

EMQX هو وسيط MQTT عالي الأداء وقابل للتوسع بشكل هائل، مبني بلغة Erlang/OTP — نفس البيئة المُختبرة ميدانياً التي تقف خلف ejabberd وبنية WhatsApp المبكرة، اختيرت لقدرتها على التعامل مع أعداد هائلة من الاتصالات المتزامنة منخفضة زمن الاستجابة. MQTT هو بروتوكول مراسلة نشر/اشتراك خفيف يشغّل معظم أجهزة إنترنت الأشياء والمنزل الذكي، ويُوجّه EMQX تلك الرسائل بين الناشرين والمشتركين على نطاق واسع. صدر لأول مرة عام 2012 باسم emqttd، ومنذ 2025 (من الإصدار 5.9 فصاعداً) وحّد EMQX نسختي Community وEnterprise في منصة واحدة تحت ترخيص Business Source License (BSL 1.1) — مجاني للاستضافة الذاتية للتطوير والاختبار وحتى الاستخدام الإنتاجي بعقدة واحدة، مع الحاجة لترخيص تجاري فقط للتجميع (clustering) متعدد العقد؛ ويعود كل إصدار تلقائياً لترخيص Apache 2.0 المفتوح بالكامل بعد أربع سنوات من إصداره.

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

يمنحك EMQX وسيط MQTT بجودة إنتاجية يتوسع من عدد قليل من أجهزة المختبر المنزلي وحتى ملايين اتصالات إنترنت الأشياء المتزامنة دون الحاجة لتغيير البرنامج لاحقاً — نفس الوسيط الذي يُشغّل مشروعاً هوائياً يستطيع من حيث المبدأ تشغيل نشر صناعي لإنترنت الأشياء. بخلاف الوسطاء البسيطين، يأتي بلوحة ويب كاملة لمراقبة الاتصالات والمواضيع، ومصادقة وقوائم تحكم بالوصول (ACL) مدمجة، ومحرك قواعد قائم على SQL بعشرات التكاملات الجاهزة التي تُوجّه بيانات الأجهزة مباشرة إلى Kafka أو PostgreSQL أو Elasticsearch أو webhooks دون كتابة كود ربط مخصص. لمختبر منزلي أو نشر صغير، يعني السماح المجاني بالاستخدام الإنتاجي بعقدة واحدة ضمن الترخيص الحالي أنك تحصل على أدوات بمستوى المؤسسات دون أي تكلفة.

متى تحتاجه

  • تربط أجهزة إنترنت الأشياء أو المنزل الذكي (حساسات، بوابات Zigbee/Z-Wave، لوحات ESP32/ESP8266) تتحدث MQTT وتحتاج وسيطاً لتوجيه الرسائل بينها
  • تريد لوحة إدارة لمراقبة العملاء المتصلين والمواضيع ومعدل الرسائل بدلاً من وسيط بلا واجهة
  • تحتاج مصادقة وقوائم تحكم بالوصول (ACL) مدمجة حتى تستطيع فقط الأجهزة الموثوقة النشر أو الاشتراك في مواضيع محددة
  • قد ينمو نشرك من بضعة أجهزة إلى آلاف أو ملايين ولا تريد ترحيل الوسيط لاحقاً
  • تحتاج توجيه بيانات إنترنت الأشياء مباشرة إلى قاعدة بيانات أو Kafka أو webhook دون كتابة كود تكامل مخصص، باستخدام محرك قواعد مدمج
  • تتكامل مع منصات أتمتة منزلية مثل Home Assistant أو Node-RED التي تتواصل عبر MQTT
  • تحتاج MQTT آمناً عبر TLS (المنفذ 8883) للأجهزة التي تتواصل عبر شبكات غير موثوقة

من يحتاجه

  • هواة المختبرات المنزلية والمنزل الذكي الذين يربطون حساسات ومفاتيح ومنصات أتمتة مثل Home Assistant عبر MQTT
  • مطورو إنترنت الأشياء وصانعو الأجهزة الذين يبنون منتجات على ESP32/ESP8266 أو Raspberry Pi أو حساسات صناعية
  • فرق إنترنت الأشياء الصناعي (IIoT) التي تربط حساسات المصانع وPLCs وأنظمة قريبة من SCADA وتحتاج وسيطاً موثوقاً وقابلاً للتوسع
  • الشركات التي تبني منصات مركبات متصلة أو تتبع أساطيل تحتاج MQTT على نطاق واسع
  • المطورون الذين يريدون محرك قواعد لتوجيه بيانات الأجهزة إلى قواعد بيانات أو خطوط تحليلات دون كود مخصص
  • مديرو الأنظمة الذين ينتقلون من وسيط بسيط مثل Mosquitto بمجرد احتياجهم للوحة إدارة أو ACL أو تجميع
  • الفرق الصغيرة التي تريد أدوات MQTT بمستوى المؤسسات مجاناً ضمن السماح بالاستخدام الإنتاجي بعقدة واحدة

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

  • مركز منزل ذكي يربط حساسات ومفاتيح ومنصات أتمتة مثل Home Assistant وNode-RED عبر MQTT
  • جمع بيانات إنترنت الأشياء الصناعي من حساسات ومعدات أرضية المصنع
  • استيعاب بيانات المركبات المتصلة أو تتبع الأساطيل على نطاق واسع
  • توجيه بيانات الأجهزة مباشرة إلى Kafka أو PostgreSQL أو Elasticsearch باستخدام محرك القواعد المدمج، دون كود مخصص
  • لوحات مراقبة فورية تعرض الأجهزة المتصلة والمواضيع ومعدل الرسائل عبر واجهة الإدارة
  • مراسلة أجهزة آمنة عبر TLS للحساسات المنشورة على شبكات غير موثوقة أو عامة
  • بناء نماذج أولية لمنتجات إنترنت الأشياء بعقدة واحدة مجاناً، مع مسار ترقية واضح للتجميع إذا توسع المنتج

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

  • نواة Erlang/OTP قابلة للتوسع بشكل هائل قادرة على التعامل مع ملايين اتصالات MQTT المتزامنة
  • لوحة إدارة ويب كاملة الميزات لمراقبة العملاء والمواضيع والاشتراكات ومعدلات الرسائل بزمن فعلي
  • مصادقة وقوائم تحكم بالوصول (ACL) مدمجة لتقييد أي الأجهزة يمكنها النشر أو الاشتراك في أي مواضيع
  • محرك قواعد قائم على SQL بعشرات التكاملات الجاهزة للبيانات (Kafka، PostgreSQL، Elasticsearch، webhooks، وغيرها)
  • دعم MQTT 3.1 و3.1.1 و5.0، إضافة إلى MQTT عبر WebSocket وQUIC لعملاء المتصفح ومنخفضي زمن الاستجابة
  • MQTT مؤمّن بـ TLS (المنفذ 8883) لتواصل مشفّر بين الأجهزة عبر شبكات غير موثوقة
  • دعم التجميع (clustering) للتوسع الأفقي عبر عقد متعددة في النشرات الأكبر (يتطلب ترخيصاً تجارياً اعتباراً من الإصدار 5.9)
  • استخدام إنتاجي مجاني بعقدة واحدة، وللتطوير والاختبار، ضمن ترخيص Business Source License الحالي

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

  • افتح لوحة الإدارة عبر http://your-server-ip:18083 وسجّل الدخول ببيانات الاعتماد الافتراضية admin / public
  • غيّر كلمة مرور اللوحة الافتراضية فوراً من قسم Users — هذه أهم خطوة أولى على الإطلاق
  • أنشئ بيانات اعتماد MQTT مخصصة لأجهزتك بدلاً من السماح باتصالات مجهولة
  • اضبط قوائم التحكم بالوصول (ACL) لتقييد كل جهاز أو مستخدم على المواضيع التي يحتاجها فعلياً فقط
  • اربط جهازك أو عميلك الأول باستخدام مكتبة MQTT (مثل paho-mqtt) موجّهة للمنفذ 1885، أو 8883 لـ TLS
  • استكشف عروض العملاء والمواضيع الفورية في اللوحة للتأكد أن الرسائل تتدفق بشكل صحيح
  • أعدّ تكاملات محرك القواعد إذا أردت توجيه بيانات الأجهزة تلقائياً إلى قاعدة بيانات أو نظام خارجي

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

  • غيّر كلمة مرور لوحة الإدارة الافتراضية admin / public فوراً بعد أول تسجيل دخول — هذه أهم خطوة على الإطلاق
  • عطّل اتصالات MQTT المجهولة واطلب مصادقة لكل عميل ينشر أو يشترك
  • اضبط قوائم التحكم بالوصول (ACL) حتى تستطيع الأجهزة الوصول فقط للمواضيع المحددة التي تحتاجها، لا شجرة المواضيع بأكملها
  • استخدم MQTT الآمن عبر TLS (المنفذ 8883) لأي جهاز يتواصل عبر الإنترنت أو شبكة غير موثوقة
  • ضع لوحة الإدارة (المنفذ 18083) خلف وكيل عكسي مع HTTPS، أو قيّدها على VPN أو نطاق IP موثوق
  • حدّث صورة Docker الخاصة بـ EMQX بانتظام لتحصل على تصحيحات أمنية
  • استخدم بيانات اعتماد لكل جهاز بدلاً من اسم مستخدم/كلمة مرور مشتركة واحدة، حتى يمكن إلغاء جهاز مُخترق بشكل فردي
  • راقب سجلات اتصال اللوحة دورياً بحثاً عن عملاء غير متوقعين أو أنماط نشر/اشتراك غير معتادة

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

يكشف هذا النشر ثلاثة منافذ: 1885 على المضيف (مربوط بمنفذ MQTT القياسي 1883 للحاوية) لـ MQTT العادي، و8883 لـ MQTT الآمن عبر TLS، و18083 للوحة الإدارة. يرسل MQTT العادي على المنفذ 1885 بيانات الاعتماد والرسائل دون تشفير، لذا يُفضّل تقييده على الشبكات المحلية الموثوقة أو VPN؛ استخدم المنفذ 8883 مع TLS لأي جهاز على شبكة غير موثوقة. لوحة الإدارة على المنفذ 18083 تتحكم في كامل إعدادات وسيطك والأجهزة المتصلة، لذا لا تكشفها أبداً مباشرة للإنترنت العام بدون وكيل عكسي يوفر HTTPS، أو قيّد الوصول على VPN أو نطاق IP موثوق.

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

  • انسخ دليل بيانات EMQX احتياطياً، والذي يحتوي بيانات اعتماد المصادقة وقواعد ACL وإعدادات لوحة الإدارة
  • صدّر إعدادات محرك القواعد وتكاملات البيانات، فإعادة بناء قواعد توجيه معقدة من الصفر يستغرق وقتاً
  • وثّق هيكل مواضيعك وتصميم ACL بشكل منفصل، فهذا يحدد كيفية تنظيم أسطول أجهزتك بأكمله
  • انسخ ملف docker-compose.yml أو إعدادات التشغيل احتياطياً حتى يمكن إعادة إنشاء الحاوية بشكل مطابق على مضيف جديد
  • خزّن النسخ الاحتياطية بعيداً عن المضيف الذي تعمل عليه الحاوية الفعلية، خاصة إذا كان EMQX مركزياً في نشر إنترنت أشياء إنتاجي
  • اختبر استعادة نسخة احتياطية على نسخة تجريبية قبل الحاجة إليها في حالة طارئة، وتأكد أن الأجهزة تستطيع إعادة الاتصال والمصادقة بشكل صحيح

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

  • ترك اللوحة على بيانات الاعتماد الافتراضية admin / public، مما يمنح أي شخص يصل للمنفذ 18083 تحكماً كاملاً بالوسيط
  • السماح باتصالات MQTT مجهولة في نشر يتجاوز مختبراً منزلياً شخصياً، مما يسمح لأي جهاز بالنشر أو الاشتراك في أي موضوع
  • كشف MQTT العادي (المنفذ 1885) مباشرة للإنترنت بدلاً من استخدام TLS (المنفذ 8883) للشبكات غير الموثوقة
  • كشف لوحة الإدارة على المنفذ 18083 مباشرة للإنترنت العام بدون HTTPS أو قيود وصول
  • افتراض أن التجميع (clustering) مشمول مجاناً — اعتباراً من EMQX 5.9، يتطلب التجميع متعدد العقد ترخيصاً تجارياً ضمن BSL
  • عدم إعداد قوائم التحكم بالوصول، مما يجعل بيانات اعتماد جهاز مُخترق قادرة على القراءة أو الكتابة في أي موضوع في النظام
  • تجاهل محرك القواعد بالكامل وكتابة كود تكامل مخصص يدوياً بينما الموصلات المدمجة تتعامل معه بالفعل
  • نسيان أن الوصول للوحة عبر HTTP العادي على المنفذ 18083 يرسل كلمة مرور تسجيل الدخول دون تشفير إن لم تُوضع خلف HTTPS

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

  • تعذر تسجيل الدخول للوحة — تحقق أنك تستخدم بيانات الاعتماد الافتراضية الصحيحة (admin / public) إذا كان تثبيتاً جديداً، أو أن كلمة المرور لم تُغيّر بالفعل من قِبل شخص آخر
  • تعذر اتصال الأجهزة على المنفذ 1885 — تحقق أن الجدار الناري يسمح بالمنفذ وأن الجهاز موجّه لعنوان الوسيط الصحيح وليس localhost
  • فشل اتصالات TLS على المنفذ 8883 — تحقق أن الشهادة صالحة وأن عميل MQTT للجهاز مضبوط ليثق بها
  • الرسائل لا تُوجّه بين الناشر والمشترك — تحقق أن قواعد ACL لا تحظر الموضوع، وتأكد أن كلا العميلين يستخدمان نفس اسم الموضوع بالضبط بنفس حالة الأحرف
  • اللوحة غير متاحة بعد إعادة التشغيل — راجع سجلات docker logs بحثاً عن أخطاء بدء التشغيل وتأكد أن أحجام الحاوية مُركّبة بشكل صحيح
  • معدل انقطاع اتصال عالٍ — راجع إعدادات keep-alive للعملاء وتحقق من عدم استقرار الشبكة بين الأجهزة والوسيط
  • تكامل محرك القواعد لا يعمل — تحقق أن جملة SQL WHERE في القاعدة تطابق موضوعك وبنية حمولة البيانات، وراجع حالة اتصال التكامل في اللوحة

البدائل

Mosquitto وسيط MQTT بسيط وخفيف — صغير وموثوق ومثالي لمختبر منزلي، لكن دون لوحة إدارة أو محرك قواعد أو إضافات كثيرة تتجاوز البروتوكول الأساسي. HiveMQ وسيط MQTT آخر بمستوى مؤسسات بأدوات قوية أصلية لـ Kubernetes، لكن نسخته المجتمعية المجانية أكثر محدودية من سماح EMQX الحالي بالاستخدام الإنتاجي بعقدة واحدة. VerneMQ بديل مفتوح المصدر ومبني على Erlang تحت Apache 2.0 مع تجميع مدمج مجاناً، يستحق النظر إذا كان قيد التجميع في ترخيص BSL لـ EMQX عائقاً حاسماً. لوسيط يبدأ بساطة كـ Mosquitto لكنه يتضمن لوحة كاملة ومحرك قواعد ومساراً واضحاً (مجانياً لعقدة واحدة) نحو نطاق هائل، يبقى EMQX أحد أقوى الخيارات — فقط تأكد من مطابقة خطط نموك مع شروط ترخيصه قبل الالتزام بتجميع متعدد العقد.

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

إذا كنت تحتاج فقط وسيطاً صغيراً وموثوقاً لعدد قليل من أجهزة المختبر المنزلي ولا تحتاج لوحة إدارة أو محرك قواعد، فإن Mosquitto أخف وأبسط في التشغيل. إذا كان نشرك سيحتاج تجميعاً متعدد العقد للتوافرية العالية وتريد تجنب ترخيص تجاري تماماً، فقد يناسبك تجميع VerneMQ المرخّص بـ Apache 2.0 أكثر من شروط Business Source License في EMQX. إذا كنت تحتاج عقود دعم مؤسسي مضمونة ومشغلات أصلية لـ Kubernetes كخيار أول، فقد تستحق مستويات HiveMQ التجارية التقييم إلى جانب خيارات EMQX المؤسسية الخاصة. وإذا لم يكن لمشروعك أي مكوّن إنترنت أشياء أو MQTT إطلاقاً، فإن وسيط رسائل عام الغرض مثل RabbitMQ أو منصة تدفق مثل Kafka يناسب نمط مراسلة مختلفاً بشكل أفضل.

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

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

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

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

ما هو EMQX؟

EMQX هو وسيط MQTT عالي الأداء وقابل للتوسع لإنترنت الأشياء. MQTT هو بروتوكول النشر/الاشتراك الخفيف الذي تستخدمه معظم أجهزة إنترنت الأشياء والمنزل الذكي، ويُوجّه الوسيط الرسائل بينها.

ما المنافذ وما بيانات دخول اللوحة؟

يكشف هذا النشر MQTT العادي على المنفذ 1885 على المضيف (مربوط بـ 1883)، وMQTT الآمن عبر TLS على 8883، ولوحة الإدارة على 18083.

كيف يختلف عن Mosquitto؟

Mosquitto وسيط MQTT بسيط وخفيف — صغير وموثوق، مثالي لمختبر منزلي، لكن دون لوحة إدارة وبميزات إضافية قليلة. EMQX أقوى بكثير: يضيف لوحة إدارة، وضوابط مصادقة وACL، ومحرك قواعد، والقدرة على التوسع لأعداد هائلة من الأجهزة.

هل أحتاج لتأمينه؟

نعم. أولاً، غيّر كلمة مرور لوحة الإدارة الافتراضية admin / public فوراً. ثانياً، لا تترك الوسيط يقبل اتصالات مجهولة — فعّل المصادقة واضبط قوائم التحكم بالوصول حتى تستطيع فقط أجهزتك الموثوقة النشر والاشتراك في مواضيعك.

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

نعم — هذه قوته الأساسية. صُمم EMQX للتوسع لأعداد هائلة من الاتصالات المتزامنة وإنتاجية رسائل عالية، مع دعم التجميع لأكبر النشرات. مختبر منزلي لن يقترب من تلك الحدود، لكن هذه المساحة تعني أنك تستطيع البدء صغيراً والنمو دون تغيير الوسيط.