NanoMQ 安装与配置指南

NanoMQ 安装与配置指南

nanomq An ultra-lightweight and blazing-fast Messaging broker/bus for IoT edge & SDV 项目地址: https://gitcode.com/gh_mirrors/nano/nanomq

1. 项目基础介绍

NanoMQ 是一个全面的边缘消息平台，包含了一个高速的 MQTT 消息代理和轻量级消息总线，专为物联网（IoT）/工业物联网（IIoT）和智能驾驶车辆（SDV）设计。它基于 NNG 的内部异步 I/O 技术和增强的消息传递与调度系统，旨在最大化整体性能。NanoMQ 完全支持 MQTT V3.1.1 和 MQTT V5.0 版本。

主要编程语言：C

2. 项目使用的关键技术和框架

• NNG: 一个高性能的、跨平台的网络通信库。
• MQTT: 适用于物联网的轻量级消息协议。
• CMake: 用于构建项目的跨平台构建系统。
• Ninja: 一个快速的构建系统，常与 CMake 配合使用。
• mbedTLS: 用于实现 TLS 加密的支持库。

3. 安装和配置准备工作

准备工作

在开始安装之前，请确保您的系统已经安装了以下工具和依赖：

• C99 兼容的编译器（如 GCC 或 Clang）
• CMake（版本 3.13 或更高）
• Ninja（可选，用于编译）
• mbedTLS（如果需要 TLS 支持）

安装步骤

使用 Docker 运行 NanoMQ

最简单的运行方式是使用 Docker，执行以下命令：

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

手动安装和运行 NanoMQ

1. 克隆项目仓库：

git clone https://github.com/emqx/nanomq.git
cd nanomq

2. 更新子模块：

git submodule update --init --recursive

3. 创建构建目录：

mkdir build && cd build

4. 使用 CMake 配置项目：

cmake ..

如果需要编译带有特定选项的版本，可以在 CMake 命令中添加以下定义：

• -DNNG_ENABLE_QUIC=ON：启用 QUIC 桥接特性。
• -DNNG_ENABLE_TLS=ON：启用 TLS 支持（需要预先安装 mbedTLS）。
• -DBUILD_CLIENT=OFF：禁用 NanoMQ 客户端工具集。
• -DBUILD_ZMQ_GATEWAY=ON：启用 ZeroMQ 网关工具。
• -DBUILD_NFTP=ON：启用 NFTP 客户端。
• -DBUILD_DDS_PROXY=ON：启用 DDS 客户端（代理/订阅/发布）。
• -DBUILD_BENCH=ON：启用 MQTT 基准测试工具。
• -DENABLE_JWT=ON：为 HTTP 服务器启用 JWT 依赖。
• -DNNG_ENABLE_SQLITE=ON：启用 SQLite 支持。
• -DBUILD_STATIC_LIB=ON：构建静态库。
• -DBUILD_SHARED_LIBS=ON：构建共享库。
• -DDEBUG=ON：启用调试标志。
• -DASAN=ON：启用地址检查器。
• -DDEBUG_TRACE=ON：启用 ptrace。

5. 编译项目：

使用 Ninja：

ninja

或者使用 make：

make

6. 启动 NanoMQ：

nanomq start

或者使用指定的配置文件：

nanomq start --conf <config_file>

以上步骤完成了 NanoMQ 的安装和配置。您现在可以开始使用它来构建您的物联网应用了。

nanomq An ultra-lightweight and blazing-fast Messaging broker/bus for IoT edge & SDV 项目地址: https://gitcode.com/gh_mirrors/nano/nanomq