6.0 KiB
Брокер EMQ X
English | 简体中文 | 日本語 | русский
EMQ X — это масштабируемый, высоко доступный, распределённый MQTT брокер с полностью открытым кодом для интернета вещей, межмашинного взаимодействия и мобильных приложений, который поддерживает миллионы одновременных подключений.
Начиная с релиза 3.0, брокер EMQ X полностью поддерживает протокол MQTT версии 5.0, и обратно совместим с версиями 3.1 и 3.1.1, а также протоколами MQTT-SN, CoAP, LwM2M, WebSocket и STOMP. Начиная с релиза 3.0, брокер EMQ X может масштабироваться до более чем 10 миллионов одновременных MQTT соединений на один кластер.
- Полный список возможностей доступен по ссылке: EMQ X Release Notes.
- Более подробная информация доступна на нашем сайте: EMQ X homepage.
Установка
Брокер EMQ X кросплатформенный, и поддерживает Linux, Unix, macOS и Windows. Он может работать на серверах с архитектурой x86_64 и устройствах на архитектуре ARM, таких как Raspberry Pi.
Более подробная информация о запуске на Windows по ссылке: Windows.md
Установка EMQ X с помощью Docker-образа
docker run -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx
Установка бинарного пакета
Сборки для различных операционных систем: Загрузить EMQ X.
Сборка из исходного кода
Начиная с релиза 3.0, для сборки требуется Erlang/OTP R21 или выше.
Инструкция для сборки версии 4.3 и выше:
git clone https://github.com/emqx/emqx.git
cd emqx
make
_build/emqx/rel/emqx/bin console
Более ранние релизы могут быть собраны с помощью другого репозитория:
git clone https://github.com/emqx/emqx-rel.git
cd emqx-rel
make
_build/emqx/rel/emqx/bin/emqx console
Первый запуск
Если emqx был собран из исходников: cd _build/emqx/rel/emqx.
Или перейдите в директорию, куда emqx был установлен из бинарного пакета.
# Запуск:
./bin/emqx start
# Проверка статуса:
./bin/emqx_ctl status
# Остановка:
./bin/emqx stop
Веб-интерфейс брокера будет доступен по ссылке: http://localhost:18083
Тесты
Полное тестирование
make eunit ct
Запуск части тестов
Пример:
make apps/emqx_bridge_mqtt-ct
Dialyzer
Статический анализ всех приложений
make dialyzer
Статический анализ части приложений (список через запятую)
DIALYZER_ANALYSE_APP=emqx_lwm2m,emqx_auth_jwt,emqx_auth_ldap make dialyzer
Сообщество
FAQ
Наиболее частые проблемы разобраны в EMQ X FAQ.
Вопросы
Задать вопрос или поделиться идеей можно в GitHub Discussions.
Предложения
Более масштабные предложения можно присылать в виде pull request в репозиторий EIP.
Разработка плагинов
Инструкция по разработке собственных плагинов доступна по ссылке: lib-extra/README.md
Спецификации стандарта MQTT
Следующие ссылки содержат спецификации стандартов:
Лицензия
Apache License 2.0, см. LICENSE.