README-RU.md

Брокер 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

Следующие ссылки содержат спецификации стандартов:

MQTT Version 3.1.1

MQTT Version 5.0

MQTT SN

Лицензия

см. LICENSE.