Eclipse Mosquitto – オープンソースMQTTブローカー
Eclipse Mosquitto – An open source MQTT broker (github.com)
要約
Eclipse Mosquittoは、MQTTプロトコルバージョン5.0、3.1.1、3.1の実装であるオープンソースのMQTTブローカーです。C/C++クライアントライブラリや、パブリッシュ/サブスクライブ用のユーティリティ、ブローカー管理用アプリケーションも含まれています。インストール方法、基本的な使い方、認証設定、ドキュメント、ソースからのビルド方法などが詳細に解説されています。
全文翻訳
Eclipse Mosquitto
Mosquittoは、MQTTプロトコルバージョン5.0、3.1.1、および3.1の実装であるオープンソースのサーバーです。また、CおよびC++クライアントライブラリ、パブリッシュおよびサブスクライブ用のユーティリティであるmosquitto_pub mosquitto_rr、mosquitto_sub、そしてブローカーの管理を支援するためのアプリケーションであるmosquitto_ctrl、mosquitto_signal、mosquitto_passwdも含まれています。
リンク
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
Mosquittoプロジェクトの情報は、以下の場所で入手できます。
- メインホームページ: https://mosquitto.org/
- 既存のバグの検索または新規バグの報告: https://github.com/eclipse-mosquitto/mosquitto/issues
- ソースコードリポジトリ: https://github.com/eclipse-mosquitto/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 として実行できます。
設定ファイルを開始するには、リスナーを定義し、必要な認証について検討する必要があります。公開されているブローカーを匿名アクセスで実行することは推奨されません。
これを行う方法の詳細については、利用可能な認証方法と動的セキュリティプラグインを参照してください。
ドキュメント
ブローカー、クライアント、およびクライアントライブラリAPIのドキュメントは、manページで入手でき、オンラインで https://mosquitto.org/man/ で公開されています。また、MQTTの機能の紹介、ユーザー名/パスワードを扱うためのmosquitto_passwdユーティリティ、ブローカーで利用可能な設定ファイルオプションの説明を含むページもあります。
詳細なクライアントライブラリAPIドキュメントは https://mosquitto.org/api/ で入手できます。
ソースからのビルド
ソースからビルドする場合、エンドユーザーにとって推奨される方法は、https://mosquitto.org/download/ からアーカイブをダウンロードすることです。
WindowsとMacではcmakeを使用してビルドします。その他のプラットフォームでは、makeを実行してビルドします。Windowsについては、README-windows.mdも参照してください。
gitリポジトリからビルドする場合、ドキュメントはまだビルドされていません。manページをスキップするにはmake binaryを使用するか、Debian/Ubuntuシステムにdocbook-xslをインストールしてください。
ビルド依存関係
- cJSON - 必須
- c-ares (Debianベースのシステムではlibc-ares-dev) - オプション、
WITH_SRV=yesで有効化 - libedit - mosquitto_ctrlインタラクティブシェルのため - オプション、
WITH_EDITLINE=noで無効化 - libmicrohttpd - ブローカーHTTP APIサポートのため - オプション、
WITH_HTTP_API=noで無効化 - openssl (Debianベースのシステムではlibssl-dev) - オプション、
WITH_TLS=noで無効化 - pthreads - クライアントライブラリのスレッドサポートのため。これは
mosquitto_loop_start()およびmosquitto_loop_stop()関数をサポートするために必要です。pthreadサポートなしでコンパイルされた場合、ライブラリはスレッドセーフであることが保証されません。 - sqlite3 - ブローカーでの永続化サポートのため - オプション、
WITH_SQLITE=noで無効化 - uthash / utlist - これらのヘッダーのバンドルバージョンが提供されています。
WITH_BUNDLED_DEPS=noでそれらの使用を無効化できます。 - xsltproc (Debian/Ubuntuシステムではxsltprocとdocbook-xsl) - gitソースからのビルドにのみ必要 -
WITH_DOCS=noで無効化
CMakeビルドを使用する場合、機能の有効化/無効化のための同等のオプションが利用可能です。CMakeビルドでは、特定のプラグインのビルドを有効化/無効化することも可能です。
mosquittoのビルド - vcpkgの使用
vcpkgパッケージマネージャーを使用してmosquittoをダウンロードしてインストールできます。
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install mosquitto
vcpkgのmosquittoポートは、Microsoftチームメンバーおよびコミュニティ貢献者によって最新の状態に保たれています。バージョンが古い場合は、vcpkgリポジトリでイシューまたはプルリクエストを作成してください。
クレジット
MosquittoはRoger Light roger@atchoo.orgによって書かれました。コードとその他のヘルプの両面で、コミュニティからの多くの貢献がありました。