6.3 KiB
Брокер EMQX
English | 简体中文 | 日本語 | русский
EMQX — это масштабируемый, высоко доступный, распределённый MQTT брокер с полностью открытым кодом для интернета вещей, межмашинного взаимодействия и мобильных приложений, который поддерживает миллионы одновременных подключений.
Начиная с релиза 3.0, брокер EMQX полностью поддерживает протокол MQTT версии 5.0, и обратно совместим с версиями 3.1 и 3.1.1, а также протоколами MQTT-SN, CoAP, LwM2M, WebSocket и STOMP. Начиная с релиза 3.0, брокер EMQX может масштабироваться до более чем 10 миллионов одновременных MQTT соединений на один кластер.
- Полный список возможностей доступен по ссылке: EMQX Release Notes.
- Более подробная информация доступна на нашем сайте: EMQX homepage.
Установка
Брокер EMQX кросплатформенный, и поддерживает Linux, Unix, macOS и Windows. Он может работать на серверах с архитектурой x86_64 и устройствах на архитектуре ARM, таких как Raspberry Pi.
Более подробная информация о запуске на Windows по ссылке: Windows.md
Установка EMQX с помощью 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
Установка бинарного пакета
Сборки для различных операционных систем: Загрузить EMQX.
Сборка из исходного кода
Начиная с релиза 3.0, для сборки требуется Erlang/OTP R21 или выше.
Инструкция для сборки версии 4.3 и выше:
git clone https://github.com/emqx/emqx.git
cd emqx
make
_build/emqx/rel/emqx/bin/emqx 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_retainer-ct
Dialyzer
Статический анализ всех приложений
make dialyzer
Статический анализ части приложений (список через запятую)
DIALYZER_ANALYSE_APP=emqx_lwm2m,emqx_authz make dialyzer
Сообщество
FAQ
Наиболее частые проблемы разобраны в EMQX FAQ.
Вопросы
Задать вопрос или поделиться идеей можно в GitHub Discussions.
Предложения
Более масштабные предложения можно присылать в виде pull request в репозиторий EIP.
Разработка плагинов
Инструкция по разработке собственных плагинов доступна по ссылке: PLUGIN.md
Спецификации стандарта MQTT
Следующие ссылки содержат спецификации стандартов:
Лицензия
см. LICENSE.