mosquitto

Nyamuk Gerhana

Mosquitto adalah implementasi server open source untuk protokol MQTT versi 5.0, 3.1.1, dan 3.1. Ini juga mencakup perpustakaan klien C dan C++, serta utilitas mosquitto_pub dan mosquitto_sub untuk penerbitan dan berlangganan.

Tautan

Lihat tautan berikut untuk informasi lebih lanjut tentang MQTT:

• Halaman komunitas: http://mqtt.org/
• Standar MQTT v3.1.1: https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
• Standar MQTT v5.0: https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html

Informasi proyek Mosquitto tersedia di lokasi berikut:

• Beranda utama: https://mosquitto.org/
• Temukan bug yang ada atau kirimkan bug baru: https://github.com/eclipse/mosquitto/issues
• Repositori kode sumber: https://github.com/eclipse/mosquitto

Ada juga server pengujian publik yang tersedia di https://test.mosquitto.org/

Menginstal

Lihat https://mosquitto.org/download/ untuk detail tentang pemasangan binari untuk berbagai platform.

Mulai cepat

Jika Anda telah menginstal paket biner, broker seharusnya sudah dimulai secara otomatis. Jika tidak, ini dapat dimulai dengan konfigurasi yang sangat mendasar:

 mosquitto

Kemudian gunakan mosquitto_sub untuk berlangganan suatu topik:

 mosquitto_sub -t 'test/topic' -v

Dan untuk mempublikasikan pesan:

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

Perhatikan bahwa memulai broker seperti ini memungkinkan akses anonim/tidak diautentikasi tetapi hanya dari komputer lokal, jadi ini hanya berguna untuk pengujian awal.

Jika Anda ingin klien dari komputer lain terhubung, Anda perlu menyediakan file konfigurasi. Jika Anda telah menginstal dari paket biner, Anda mungkin sudah memiliki file konfigurasi di suatu tempat seperti /etc/mosquitto/mosquitto.conf . Jika Anda telah mengkompilasi dari sumber, Anda dapat menulis file konfigurasi lalu dijalankan sebagai mosquitto -c /path/to/mosquitto.conf .

Untuk memulai file konfigurasi, Anda menentukan pendengar dan Anda perlu memikirkan otentikasi apa yang Anda perlukan. Tidak disarankan untuk menjalankan broker Anda dengan akses anonim ketika tersedia untuk umum.

Untuk detail tentang cara melakukan ini, lihat metode autentikasi yang tersedia dan plugin keamanan dinamis.

Dokumentasi

Dokumentasi untuk broker, klien, dan API perpustakaan klien dapat ditemukan di halaman manual, yang tersedia online di https://mosquitto.org/man/. Ada juga halaman dengan pengenalan fitur MQTT, utilitas mosquitto_passwd untuk menangani nama pengguna/kata sandi, dan deskripsi opsi file konfigurasi yang tersedia untuk broker.

Dokumentasi API perpustakaan klien terperinci dapat ditemukan di https://mosquitto.org/api/

Membangun dari sumber

Untuk membangun dari sumber, rute yang disarankan bagi pengguna akhir adalah mengunduh arsip dari https://mosquitto.org/download/.

Di Windows dan Mac, gunakan cmake untuk membangun. Di platform lain, jalankan saja make to build. Untuk Windows, lihat juga README-windows.md .

Jika Anda membangun dari repositori git maka dokumentasinya belum akan dibuat. Gunakan make binary untuk melewati pembuatan halaman manual, atau instal docbook-xsl pada sistem Debian/Ubuntu.

Bangun Ketergantungan

• c-ares (libc-ares-dev pada sistem berbasis Debian) - hanya jika dikompilasi dengan make WITH_SRV=yes
• cJSON - untuk dukungan keluaran JSON klien. Nonaktifkan dengan make WITH_CJSON=no terdeteksi otomatis dengan CMake.
• libwebsockets (libwebsockets-dev) - aktifkan dengan make WITH_WEBSOCKETS=yes
• openssl (libssl-dev pada sistem berbasis Debian) - nonaktifkan dengan make WITH_TLS=no
• pthreads - untuk dukungan thread perpustakaan klien. Ini diperlukan untuk mendukung fungsi mosquitto_loop_start() dan mosquitto_loop_stop() . Jika dikompilasi tanpa dukungan pthread, perpustakaan tidak dijamin aman untuk thread.
• uthash / utlist - versi paket dari header ini disediakan, nonaktifkan penggunaannya dengan make WITH_BUNDLED_DEPS=no
• xsltproc (xsltproc dan docbook-xsl pada sistem berbasis Debian) - hanya diperlukan saat membangun dari sumber git - nonaktifkan dengan make WITH_DOCS=no

Opsi yang setara untuk mengaktifkan/menonaktifkan fitur tersedia saat menggunakan build CMake.

Kredit

Nyamuk ditulis oleh Roger Light [email protected]