Mosquitto est une implémentation open source d'un serveur pour les versions 5.0, 3.1.1 et 3.1 du protocole MQTT. Il comprend également une bibliothèque client C et C++, ainsi que les utilitaires mosquitto_pub
et mosquitto_sub
pour la publication et l'abonnement.
Consultez les liens suivants pour plus d’informations sur MQTT :
Les informations sur le projet Mosquitto sont disponibles aux endroits suivants :
Il existe également un serveur de test public disponible sur https://test.mosquitto.org/
Voir https://mosquitto.org/download/ pour plus de détails sur l'installation de binaires pour diverses plates-formes.
Si vous avez installé un package binaire, le courtier aurait dû être démarré automatiquement. Sinon, il peut être démarré avec une configuration très basique :
mosquitto
Utilisez ensuite mosquitto_sub
pour vous abonner à un sujet :
mosquitto_sub -t 'test/topic' -v
Et pour publier un message :
mosquitto_pub -t 'test/topic' -m 'hello world'
Notez que démarrer le courtier de cette manière permet un accès anonyme/non authentifié, mais uniquement à partir de l'ordinateur local, ce n'est donc vraiment utile que pour les tests initiaux.
Si vous souhaitez que des clients d'un autre ordinateur se connectent, vous devrez fournir un fichier de configuration. Si vous avez installé à partir d'un package binaire, vous aurez probablement déjà un fichier de configuration quelque part comme /etc/mosquitto/mosquitto.conf
. Si vous avez compilé à partir des sources, vous pouvez écrire votre fichier de configuration puis l'exécuter en tant que mosquitto -c /path/to/mosquitto.conf
.
Pour démarrer votre fichier de configuration, vous définissez un écouteur et vous devrez réfléchir à l'authentification dont vous avez besoin. Il n'est pas conseillé d'exécuter votre courtier avec un accès anonyme lorsqu'il est accessible au public.
Pour plus de détails sur la façon de procéder, consultez les méthodes d'authentification disponibles et le plugin de sécurité dynamique.
La documentation relative au courtier, aux clients et à l'API de la bibliothèque client est disponible dans les pages de manuel, disponibles en ligne sur https://mosquitto.org/man/. Il existe également des pages avec une introduction aux fonctionnalités de MQTT, l'utilitaire mosquitto_passwd
pour gérer les noms d'utilisateur/mots de passe et une description des options du fichier de configuration disponibles pour le courtier.
La documentation détaillée de l'API de la bibliothèque client est disponible sur https://mosquitto.org/api/
Pour créer à partir des sources, l'itinéraire recommandé aux utilisateurs finaux consiste à télécharger l'archive depuis https://mosquitto.org/download/.
Sous Windows et Mac, utilisez cmake
pour créer. Sur d'autres plateformes, exécutez simplement make
to build. Pour Windows, voir également README-windows.md
.
Si vous construisez à partir du référentiel git, la documentation ne sera pas déjà créée. Utilisez make binary
pour ignorer la création des pages de manuel ou installez docbook-xsl
sur les systèmes Debian/Ubuntu.
make WITH_SRV=yes
make WITH_CJSON=no
Auto détecté avec CMake.make WITH_WEBSOCKETS=yes
make WITH_TLS=no
mosquitto_loop_start()
et mosquitto_loop_stop()
. Si elle est compilée sans le support de pthread, il n'est pas garanti que la bibliothèque soit thread-safe.make WITH_BUNDLED_DEPS=no
make WITH_DOCS=no
Des options équivalentes pour activer/désactiver des fonctionnalités sont disponibles lors de l’utilisation de la version CMake.
Mosquitto a été écrit par Roger Light [email protected]