mosquitto

كسوف البعوض

Mosquitto هو تطبيق مفتوح المصدر لخادم للإصدارات 5.0 و3.1.1 و3.1 من بروتوكول MQTT. ويتضمن أيضًا مكتبة عملاء C وC++ والأدوات المساعدة mosquitto_pub و mosquitto_sub للنشر والاشتراك.

روابط

راجع الروابط التالية لمزيد من المعلومات حول MQTT:

• صفحة المجتمع: http://mqtt.org/
• معيار MQTT v3.1.1: https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
• معيار MQTT v5.0: https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html

تتوفر معلومات مشروع البعوض في المواقع التالية:

• الصفحة الرئيسية: https://mosquitto.org/
• ابحث عن الأخطاء الموجودة أو أرسل خطأً جديدًا: https://github.com/Eclipse/mosquitto/issues
• مستودع كود المصدر: https://github.com/Eclipse/mosquitto

يوجد أيضًا خادم اختبار عام متاح على https://test.mosquitto.org/

التثبيت

راجع https://mosquitto.org/download/ للحصول على تفاصيل حول تثبيت الثنائيات لمختلف المنصات.

بداية سريعة

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

 mosquitto

ثم استخدم mosquitto_sub للاشتراك في موضوع:

 mosquitto_sub -t 'test/topic' -v

و لنشر الرسالة:

 mosquitto_pub -t 'test/topic' -m 'hello world'

لاحظ أن بدء تشغيل الوسيط بهذه الطريقة يسمح بالوصول المجهول/غير المصادق ولكن فقط من الكمبيوتر المحلي، لذلك فهو مفيد حقًا للاختبار الأولي فقط.

إذا كنت تريد توصيل العملاء من كمبيوتر آخر، فستحتاج إلى توفير ملف تكوين. إذا قمت بالتثبيت من حزمة ثنائية، فمن المحتمل أن يكون لديك بالفعل ملف تكوين في مكان ما مثل /etc/mosquitto/mosquitto.conf . إذا قمت بالتجميع من المصدر، فيمكنك كتابة ملف التكوين الخاص بك ثم تشغيله كـ mosquitto -c /path/to/mosquitto.conf .

لبدء ملف التكوين الخاص بك، عليك تحديد المستمع وستحتاج إلى التفكير في المصادقة التي تحتاجها. لا يُنصح بتشغيل الوسيط الخاص بك مع وصول مجهول عندما يكون متاحًا للعامة.

للحصول على تفاصيل حول كيفية القيام بذلك، انظر إلى طرق المصادقة المتاحة والمكون الإضافي للأمان الديناميكي.

التوثيق

يمكن العثور على وثائق واجهة برمجة تطبيقات الوسيط والعملاء ومكتبة العملاء في صفحات الدليل المتوفرة عبر الإنترنت على https://mosquitto.org/man/. هناك أيضًا صفحات تحتوي على مقدمة عن ميزات MQTT، والأداة المساعدة mosquitto_passwd للتعامل مع اسم المستخدم/كلمات المرور، ووصف لخيارات ملف التكوين المتاحة للوسيط.

يمكن العثور على وثائق واجهة برمجة تطبيقات مكتبة العميل التفصيلية على https://mosquitto.org/api/

البناء من المصدر

للبناء من المصدر، المسار الموصى به للمستخدمين النهائيين هو تنزيل الأرشيف من https://mosquitto.org/download/.

على نظامي التشغيل Windows وMac، استخدم cmake للإنشاء. على الأنظمة الأساسية الأخرى، ما عليك سوى تشغيل make to build. بالنسبة لنظام التشغيل Windows، راجع أيضًا README-windows.md .

إذا كنت تقوم بالإنشاء من مستودع git، فلن يتم إنشاء الوثائق بالفعل. استخدم make binary لتخطي إنشاء صفحات الدليل، أو قم بتثبيت docbook-xsl على أنظمة Debian/Ubuntu.

بناء التبعيات

• c-ares (libc-ares-dev على الأنظمة المستندة إلى دبيان) - فقط عند تجميعها باستخدام make WITH_SRV=yes
• cJSON - لدعم إخراج العميل JSON. قم بالتعطيل باستخدام make WITH_CJSON=no يتم اكتشاف تلقائي باستخدام CMake.
• libwebsockets (libwebsockets-dev) - تمكين مع make WITH_WEBSOCKETS=yes
• openssl (libssl-dev على الأنظمة المستندة إلى Debian) - قم بالتعطيل باستخدام make WITH_TLS=no
• pthreads - لدعم سلسلة رسائل مكتبة العميل. وهذا مطلوب لدعم وظائف mosquitto_loop_start() و mosquitto_loop_stop() . إذا تم تجميعها بدون دعم pthread، فلا نضمن أن تكون المكتبة آمنة لسلسلة الرسائل.
• uthash / utlist - يتم توفير الإصدارات المجمعة من هذه الرؤوس، قم بتعطيل استخدامها مع make WITH_BUNDLED_DEPS=no
• xsltproc (xsltproc وdocbook-xsl على الأنظمة المستندة إلى Debian) - مطلوب فقط عند البناء من مصادر git - قم بتعطيله باستخدام make WITH_DOCS=no

تتوفر خيارات مكافئة لتمكين/تعطيل الميزات عند استخدام إصدار CMake.

الاعتمادات

البعوض كتبه روجر لايت [email protected]