[{"data":1,"prerenderedAt":325},["ShallowReactive",2],{"blog-post-zh-install-mqtt-broker-on-windows":3},{"post":4,"translationPath":324},{"id":5,"title":6,"author":7,"body":8,"cover":305,"coverHeight":306,"coverWidth":107,"date":307,"description":31,"draft":308,"extension":309,"meta":310,"navigation":311,"path":312,"pinned":308,"seo":313,"sitemap":314,"stem":321,"tags":322,"__hash__":323},"blog_zh\u002Fzh\u002Fblog\u002Finstall-mqtt-broker-on-windows.md","在 Windows 平台搭建 MQTT 服务",null,{"type":9,"value":10,"toc":297},"minimark",[11,15,26,29,32,36,44,52,55,90,93,101,109,125,132,153,172,178,203,206,226,254,257,267,276,282,291,294],[12,13,14],"h2",{"id":14},"引言",[16,17,18,25],"p",{},[19,20,24],"a",{"href":21,"rel":22},"https:\u002F\u002Fwww.emqx.com\u002Fzh\u002Fblog\u002Fthe-easiest-guide-to-getting-started-with-mqtt",[23],"nofollow","MQTT"," 是一种轻量级、基于发布\u002F订阅模式的消息传输协议，旨在用极小的代码空间和网络带宽为物联网设备提供简单、可靠的消息传递服务。MQTT 经过多年的发展，如今已被广泛应用于资源开采、工业制造、移动通信、智能汽车等各行各业，使得 MQTT 成为了物联网传输协议的事实标准。",[16,27,28],{},"出于稳定性、可靠性、成本等多方面的考虑，众多 MQTT 服务实现更倾向于选择拥有丰富开源生态系统的 Linux 环境，Windows 平台上可选的 MQTT 服务相对有限。NanoMQ 是用于物联网边缘的超轻量级 MQTT 消息服务器，具有极高的性能性价比，适用于各类边缘计算平台。NanoMQ 有着强大的跨平台和可兼容能力，不仅可以用于以 Linux 为基础的各类平台，也为 Windows 平台提供了 MQTT 服务的新选择。",[16,30,31],{},"本文将以 NanoMQ 为例，使用二进制包和源代码编译两种方式演示如何在 Windows 平台中快速搭建 MQTT 服务。",[12,33,35],{"id":34},"nanomq-简介","NanoMQ 简介",[16,37,38,43],{},[19,39,42],{"href":40,"rel":41},"https:\u002F\u002Fgithub.com\u002Fnanomq\u002Fnanomq",[23],"NanoMQ"," 是 EMQ 于 2021 年发布的开源项目，旨在为物联网边缘场景提供轻量级、快速、支持多线程的 MQTT 消息服务器和消息总线。NanoMQ 基于 NNG 的异步 I\u002FO 构建，内置 Actor 多线程模型。相较于 Mosquitto 的单线程设计，NanoMQ 能够充分发挥现代 SMP 系统的多核优势，在边缘多核环境中展现出了比 Mosquitto 高达 10 倍的性能表现。NanoMQ 基于标准 POSIX 接口开发，可以轻松通过 MinGW 的 POSIX 编译环境移植到各类 Windows 环境中。经过三年研发迭代，NanoMQ 于 2024 年 1 月正式加入 LF Edge 基金会，未来将与 LF Edge 旗下的 EdgeX Foundry 框架深度集成，共同促进物联网边缘设备和应用之间的互操作性。",[16,45,46],{},[47,48],"img",{"alt":42,"src":49,"width":50,"height":51},"\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002F01.webp",865,477,[16,53,54],{},"NanoMQ 主要具有以下特性：",[56,57,58,66,72,78,84],"ul",{},[59,60,61,65],"li",{},[62,63,64],"strong",{},"超轻量化","：安装包约 200KB 左右，运行占用资源极小。根据编译和启动的配置，启动所需内存资源从300Kb 到 3Mb 不等。",[59,67,68,71],{},[62,69,70],{},"兼容性和可移植性","：NanoMQ 采用纯净的 C\u002FC++ 开发，只依赖于标准 POSIX API，同时支持大小端兼容，可无缝对接各类网络应用，零成本迁移到各类嵌入式平台。",[59,73,74,77],{},[62,75,76],{},"可伸缩性","：借助内置的异步 IO 架构和多线程模型，NanoMQ 在保持轻量化的同时仍具备一定可横向拓展的并发吞吐能力。仅需不到 10MB 的内存消耗，即可支持超过 10W 的消息吞吐。",[59,79,80,83],{},[62,81,82],{},"SMP 支持","：NanoMQ 在边缘多核平台上对 SMP 有着良好的支持，能够充分发挥多处理器的能力，从而提升系统性能。",[59,85,86,89],{},[62,87,88],{},"容器支持","：NanoMQ 能够轻松地通过容器进行部署和运行，并且与主流的边缘容器编排方案兼容，使得部署过程更加灵活和便捷。",[12,91,92],{"id":92},"二进制包安装",[16,94,95,96,100],{},"首先进入 NanoMQ 官网",[19,97,99],{"href":98},"\u002Fzh\u002Fdownloads","下载页面","，选择 Windows 平台下载安装包：",[16,102,103],{},[47,104],{"alt":105,"src":106,"width":107,"height":108},"下载 NanoMQ","\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002F02.webp",1520,931,[16,110,111,112,116,117,120,121,124],{},"可以在解压后文件夹中的",[113,114,115],"code",{},"bin","目录下用 Windows 命令行使用 NanoMQ。将解压后的",[113,118,119],{}," C:\\xxx\\nanomq-0.21.10-windows-x86_64\\bin"," 目录添加到环境变量中，则可以在 Windows 命令行或者 PowerShell 中直接使用 NanoMQ。输入 ",[113,122,123],{},"nanomq --help"," 可以看到简要的使用说明。",[16,126,127],{},[47,128],{"alt":129,"src":130,"width":50,"height":131},"NanoMQ 命令","\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002F03.webp",570,[16,133,134,135,138,139,142,143,146,147,152],{},"使用 ",[113,136,137],{},"nanomq start --conf C:\\nanomq\\config\\nanomq.conf"," 启动 NanoMQ。其中",[113,140,141],{}," C:\\nanomq\\config\\nanomq.conf"," 为 NanoMQ 配置文件的地址，配置文件示例可以在解压后文件夹中的",[113,144,145],{}," config"," 目录下找到。NanoMQ 的详细配置说明请参见",[19,148,151],{"href":149,"rel":150},"https:\u002F\u002Fnanomq.io\u002Fdocs\u002Fzh\u002Flatest\u002Fconfig-description\u002Fintroduction.html",[23],"官方文档","。",[16,154,155,156,161,162,165,166,168,169,171],{},"接下来使用 NanoMQ 的 ",[19,157,160],{"href":158,"rel":159},"https:\u002F\u002Fwww.emqx.com\u002Fzh\u002Fblog\u002Fmqtt-client-tools",[23],"MQTT 客户端","工具 ",[113,163,164],{},"nanomq_cli"," 来进行 NanoMQ 的使用说明。",[113,167,164],{}," 同样可以在 ",[113,170,115],{}," 目录下找到。",[16,173,174],{},[47,175],{"alt":164,"src":176,"width":50,"height":177},"\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002F04.webp",449,[16,179,180,181,183,184,187,188,191,192,194,195,198,199,202],{},"从上图中可以看到 ",[113,182,164],{}," 的通过 ",[113,185,186],{},"sub"," 命令订阅了主题 ",[113,189,190],{},"nmqtest","，接收到了 ",[113,193,164],{}," 通过 ",[113,196,197],{},"pub"," 命令发布的 ",[113,200,201],{},"HelloWorld"," 消息。",[12,204,205],{"id":205},"源码编译与运行",[16,207,208,209,214,215,220,221,152],{},"在 Windows 平台编译需要提前准备 ",[19,210,213],{"href":211,"rel":212},"https:\u002F\u002Fwww.mingw-w64.org\u002F",[23],"MinGW-w64","、",[19,216,219],{"href":217,"rel":218},"https:\u002F\u002Fgnuwin32.sourceforge.net\u002Fpackages\u002Fmake.htm",[23],"Make"," 和 ",[19,222,225],{"href":223,"rel":224},"https:\u002F\u002Fcmake.org\u002F",[23],"CMake",[56,227,228,233],{},[59,229,230,232],{},[62,231,213],{}," 是将 GCC 编译器和 GNU Binutils 移植到 Windows 平台下的产物，包括一系列头文件（Win32API）、库和可执行文件，是一个在 Windows 平台上开发和运行原生 Windows 应用程序的开源软件开发环境。Cygwin 同 MinGW 类似，也用于移植 Unix 软件到 Windows，但它们采用截然不同的实现。Cygwin 重视兼容性优先于性能，MinGW 则着重于简化与性能。本文将以 MinGW 为例进行 NanoMQ 的编译。",[59,234,235,238,239,244,245,244,249,253],{},[62,236,237],{},"Make 和 CMake"," 则是用于 NanoMQ 项目自动化构建的工具。参考下载地址：",[19,240,243],{"href":241,"rel":242},"https:\u002F\u002Fwww.mingw-w64.org\u002Fdownloads\u002F#mingw-builds",[23],"MingGW-w64","，",[19,246,219],{"href":247,"rel":248},"https:\u002F\u002Fsourceforge.net\u002Fprojects\u002Fgnuwin32\u002Ffiles\u002Fmake\u002F3.81\u002Fmake-3.81.exe\u002Fdownload?use_mirror=jaist&download=",[23],[19,250,225],{"href":251,"rel":252},"https:\u002F\u002Fcmake.org\u002Fdownload\u002F",[23],"。其中 MinGW-w64 应尽量选择较新版本。",[16,255,256],{},"接下来在 Windows 命令行、PowerShell 或者 Git Bash 中输入以下命令：",[258,259,264],"pre",{"className":260,"code":262,"language":263},[261],"language-text","# 1. clone 源码 （已通过ZIP下载源代码则不需要这一步）\nPS: D:\\Project> git clone https:\u002F\u002Fgithub.com\u002Fnanomq\u002Fnanomq.git\nPS: D:\\Project> cd nanomq\n\n# 2. 更新和初始化 git 子模块\nPS: D:\\Project\\nanomq> git submodule update --init --recursive\n\n# 3. 创建并进入 build 目录\nPS: D:\\Project\\nanomq> mkdir build\nPS: D:\\Project\\nanomq> cd build\n\n# 4. 编译 NanoMQ\nPS: D:\\Project\\nanomq\\build> cmake -G \"MinGW Makefiles\" ..\nPS: D:\\Project\\nanomq\\build> make -j 8\n\n# 5. 运行 NanoMQ\nPS: D:\\Project\\nanomq\\build> .\\nanomq\\nanomq.exe broker start\n","text",[113,265,262],{"__ignoreMap":266},"",[16,268,269,270,275],{},"除了 NanoMQ 自带的客户端工具，还可以使用开源 MQTT 客户端工具 ",[19,271,274],{"href":272,"rel":273},"https:\u002F\u002Fmqttx.app\u002Fzh",[23],"MQTTX"," 来进行消息收发测试。",[16,277,278],{},[47,279],{"alt":274,"src":280,"width":50,"height":281},"\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002F05.webp",450,[16,283,284,285,287,288,202],{},"从上图中同样可以看到，订阅了 ",[113,286,190],{}," 主题的客户端通过 NanoMQ 收到了另一个客户端发布的 ",[113,289,290],{},"hello",[12,292,293],{"id":293},"结语",[16,295,296],{},"本文通过二进制包和源码编译的方式完成了 NanoMQ 在 Windows 平台的安装，并对其使用进行了演示测试。NanoMQ 为在 Windows 平台上构建物联网边缘计算应用提供了一个便捷而强大的选择。它的轻量级、高性能以及专注于边缘计算的设计使其成为一个理想的消息传输解决方案。",{"title":266,"searchDepth":298,"depth":298,"links":299},2,[300,301,302,303,304],{"id":14,"depth":298,"text":14},{"id":34,"depth":298,"text":35},{"id":92,"depth":298,"text":92},{"id":205,"depth":298,"text":205},{"id":293,"depth":298,"text":293},"\u002Fimages\u002Fblog\u002Fzh\u002Finstall-mqtt-broker-on-windows\u002Fcover.webp",684,"2026-07-03",false,"md",{},true,"\u002Fzh\u002Fblog\u002Finstall-mqtt-broker-on-windows",{"title":6,"description":31},{"loc":312,"images":315,"lastmod":307},[316,317,318,319,320],{"loc":49},{"loc":106},{"loc":130},{"loc":176},{"loc":280},"zh\u002Fblog\u002Finstall-mqtt-broker-on-windows",[],"u-CTtsEFfhlVxUbJSyooS3RBeDQ11Sqf465JD-RuSgs","\u002Fblog\u002Finstall-mqtt-broker-on-windows",1794542897029]