作为一款用于物联网边缘的超轻量级 MQTT 消息服务器，NanoMQ 支持在各种边缘平台运行，例如支持 x86_64 和 ARM 等架构。

正式安装前，请先安装以下依赖项：

在 NanoMQ 的安装目录，运行以下命令进行编译： Ninja非必须，可以使用传统 Make 命令编译

编译完成后，您将在命令行窗口看到类似提示：

编译完成后，您可在 build -> NanoMQ 找到相关可执行文件。

运行以下命令启动 NanoMQ：

成功启动后，您可在命令行窗口看到以下提示：

除常见设置（如 CMAKE_BUILD_TYPE）外，你还可通过 CMake 配置更多高级功能，如启用 MQTT over QUIC 数据桥接或 ZMQ 网关，一些常见的编译选项参见下表：

依赖项：libmsquic

NanoMQ 支持通过 MQTT over QUIC 协议与 EMQX 5 进行桥接。

由于兼容性问题，目前尚未发布支持 QUIC 的二进制包。如希望使用 MQTT over QUIC，应通过编译方式安装 NanoMQ，命令如下：

依赖项: mbedTLS

默认情况下，TLS 为未启用状态。如希望启用，可在编译阶段通过 -DNNG_ENABLE_TLS=ON 启用。

Ninja：

make：

TIP

关于 TLS 的详细配置参数，可参考配置文件 etc/nanomq_example.conf

NanoMQ 会在构建时默认安装客户端工具（pub、sub 、conn）。如希望禁用客户端工具，可通过 -DBUILD_CLIENT=OFF 实现：

默认情况下，网关为未启用状态。如希望启用，如 ZMQ 网关，可通过 -DBUILD_ZMQ_GATEWAY=ON 实现：

默认情况下，Benchmark 为未启用状态。如希望启用，可通过 -DBUILD_BENCH=ON 实现：

HTTP Server 的 JWT 依赖默认未启用。如希望启用，可通过 -DENABLE_JWT=ON 实现：

NanoMQ 支持通过 SQLite3 实现消息的持久化，该功能默认未启用。如希望启用，可通过 -DNNG_ENABLE_SQLITE=ON 实现：

如通过以静态库的方式编译 NanoMQ，可通过 -DBUILD_STATIC_LIB=ON 实现：

如通过以共享库的方式编译 NanoMQ，可通过 -DBUILD_SHARED_LIBS=ON 实现：

NanoNNG 是含 MQTT 支持的 NNG 仓库分支，由 NanoMQ 自行维护，可单独编译：

NanoMQ 提供了多种性能调优方式，您可根据需求进行选择。

线程数量限制

调试：NanoMQ 提供调试功能，启用后，将按照 Syslog 标准记录所有线程信息。您可选择禁用/启用该功能。

MQTT 客户端：MQTT 客户端默认启用，您可通过 -DBUILD_CLIENT=OFF 禁用。

消息队列：mqueue 消息队列默认启用，但 macOS 系统中暂不支持，您可通过 -DMQ=0 禁用。

TIP

运行以下命令前，请根据实际场景替换 {size}、 {PARALLEL} 字段。

为 MQTT 数据包设置固定头加可变头最大长度，默认为 64 字节：

为 MQTT 数据包设置固定头最大长度，默认为 5 字节：

为 MQTT 数据包设置属性最大长度，默认为 32 字节：

为 QOS > 0的消息设置队列长度，默认为 64：

设置重发消息的队列长度，默认为 64：

设置逻辑并发数限制，默认为 32，使用 -DPARALLEL 指定：