emqx/nanomq

NanoMQ

快速参考

官方网站：

[***]

获取帮助与提交问题：

https://github.com/emqx/nanomq/issues 或 [] 或 []

支持的架构

POSIX兼容架构

什么是NanoMQ

Nano MQTT Broker（NanoMQ）是一款轻量级且高性能的MQTT Broker，适用于IoT边缘平台。NanoMQ以高效方式统一边缘与云端之间的动态数据和在用数据。

其高性价比、高性能、高兼容性和互操作性使其成为边缘消息代理和数据总线的理想选择。

特性

• 完全兼容MQTT 5.0

  全面支持MQTT 5.0/3.1.1，兼容所有标准开源MQTT SDK。

• MQTT桥接

  支持从边缘向多个云端桥接消息，可直接连接全球云服务。

• 消息持久化

  通过内置数据持久化功能保护业务关键数据，连接恢复后自动恢复上传。

• 规则引擎

  基于SQL的规则引擎释放数据灵活性，与eKuiper集成，为边缘带来流处理能力。

• 可集成性

  通过事件驱动的WebHook降低边缘计算应用集成成本，提供EdgeOps友好的HTTP API，易于维护。

• 全面多协议支持

  支持ZeroMQ/nanomsg/NNG/WebSocket等多种协议，实现边缘灵活多样的路由拓扑。通过TLS/SSL保障IoT连接安全。

如何使用此镜像

bash
docker pull emqx/nanomq:latest

运行特定版本的NanoMQ：

bash
docker run -d -p 1883:1883 -p 8883:8883 --name nanomq emqx/nanomq:latest

NanoMQ Docker镜像分为三种类型：

默认版：基于Alpine镜像，体积最小，仅包含基础MQTT broker功能。

bash
docker pull emqx/nanomq:0.14.1

精简版（Slim）：基于Ubuntu镜像，体积适中，包含TLS/SSL、SQLite和规则引擎等必要功能。

bash
docker pull emqx/nanomq:0.14.1-slim

完整版（Full）：包含所有功能的全面镜像，如QUIC桥接、ZeroMQ网关和基准测试工具。

bash
docker pull emqx/nanomq:0.14.1-full

NanoMQ配置文件

Docker版本： 从主机指定配置文件路径：

bash
docker run -d -p 1883:1883 -v {本地路径}:/etc \            --name nanomq  emqx/nanomq:0.14.1

推荐使用环境变量配置NanoMQ

NanoMQ环境变量

• 指定代理URL。 在主机系统：

  bash
  export NANOMQ_BROKER_URL="nmq-tcp://0.0.0.0:1883"
  export NANOMQ_TLS_ENABLE=true
  export NANOMQ_TLS_URL="tls+nmq-tcp://0.0.0.0:8883"
  

  创建Docker容器：

  bash
  docker run -d -p 1883:1883 -p 8883:8883 \
             -e NANOMQ_BROKER_URL="nmq-tcp://0.0.0.0:1883" \
             -e NANOMQ_TLS_ENABLE=true \
             -e NANOMQ_TLS_URL="tls+nmq-tcp://0.0.0.0:8883" \
             --name nanomq emqx/nanomq:0.14.1-full
  

• 指定NanoMQ配置文件路径。 在主机系统：

  bash
  export NANOMQ_CONF_PATH="/usr/local/etc/nanomq.conf"
  

  创建Docker容器：

  bash
  docker run -d -p 1883:1883 -e NANOMQ_CONF_PATH="/usr/local/etc/nanomq.conf" \
              [-v {本地路径}:{容器路径}] \
              --name nanomq emqx/nanomq:0.14.0-slim
  

性能调优

为在您的平台上获得最佳性能，建议修改以下设置：