Windows 系统部署 Mosquitto MQTT broker 完整指南

Mosquitto 是轻量级的 MQTT 消息代理，适用于物联网、消息通信等场景。

本文将详细介绍 Windows 系统下的部署步骤，帮助新手快速搭建 MQTT 服务。

一、下载 Mosquitto 安装包

1. 访问 Mosquitto 官网下载页：https://mosquitto.org/download/
2. 找到 Windows 版本，选择 mosquitto-2.0.xx-install-windows-x64.exe（xx 为具体版本号，建议选择最新稳定版）
3. 双击安装包，按默认向导完成安装（默认路径为 C:\Program Files\mosquitto）

二、修改配置文件（允许匿名访问与外部连接）

1. 打开安装目录 C:\Program Files\mosquitto，找到配置文件 mosquitto.conf
2. 用记事本或 Notepad++ 打开，在文件末尾添加以下两行配置：
   

   listener 1883 0.0.0.0  # 监听1883端口，允许所有IP访问
   
   allow_anonymous true   # 允许匿名登录（测试环境使用，生产环境需关闭并配置认证）

3. 保存文件（若提示权限不足，右键编辑器选择 “以管理员身份运行” 后重试）

三、启动 Mosquitto 服务

1. 按下 Win+R，输入 cmd 打开命令提示符，切换到安装目录：cd C:\Program Files\mosquitto
2. 执行启动命令（带日志输出，便于排查问题）：mosquitto.exe -c mosquitto.conf -v
3. 若命令行显示 “Opening ipv4 listen socket on port 1883”，说明服务启动成功
   

   

四、解决服务启动异常问题

若执行启动命令后报错，或服务无法正常运行，可按以下步骤处理：

1. 按下 Win+R，输入 services.msc 打开系统服务列表
2. 找到 Mosquitto Broker 服务，右键选择 “停止”（若服务处于运行状态）
3. 关闭所有与 Mosquitto 相关的命令行窗口，重新执行步骤三的启动命令
4. 若仍异常，检查配置文件是否有语法错误，或 1883 端口是否被其他程序占用（可通过 netstat -ano | findstr "1883" 查看端口占用情况）

五、使用 MQTTx 测试服务

　　官网：https://mqttx.app/