windows 安装 mqtt 操作步骤

windows 安装 mqtt 操作步骤

下载地址

https://mosquitto.org/download/

安装步骤

1. 选择Windows 64 位安装包（如mosquitto-2.0.18-install-windows-x64.exe），下载最新稳定版

2. 安装流程
   双击安装包，按向导操作：
   勾选Install as a Windows Service（安装为系统服务，开机自启）。
   选择安装路径（默认C:\Program Files\mosquitto，建议保留）。
   勾选Add install directory to PATH for all users（自动配置环境变量，推荐）。
   点击Install完成安装，等待约 30 秒。

3. 验证：
   在如果没有 添加环境path 的话需要在 进入安装目录下 cmd
   输入

   mosquitto --version
   显示版本号即配置成功。本机输出如下：
   D:\workSoft\Mosquitto>mosquitto --versionmosquitto 2.1.0Copyright 漏 2025 Roger Light.License EPL-2.0 OR BSD-3-Clause.1770709147: mosquitto version 2.1.0 terminating
   

安装后设置

1. 进入安装目录

   cd "C:\Program Files\mosquitto"
   或者
   在安装目录地址栏中输入 cmd 
   

2. 创建密码文件（示例：admin/123456） 需要 创建文件：pwfile.conf

    mosquitto_passwd.exe -b pwfile.conf admin admin123456解释 设置 用户名 admin密码   admin123456
   

3. 修改配置文件
   复制 mosquitto.conf.example 为 mosquitto.conf ，编辑关键配置：

   listener 1883 0.0.0.0
   persistence true
   persistence_location ./data/
   log_dest file ./mosquitto.log
   allow_anonymous false
   password_file ./pwfile.conf命令解释， 监听本机的 1883 端口 需要在文件的末尾打开就行，使用记事本打开
   

4. 启动服务

     启动Mosquitto服务net start mosquitto或直接运行（前台调试）mosquitto.exe -c mosquitto.conf
   

5. 服务验证 查看状态

     sc query mosquitto
   

   输出如下内容

   D:\workSoft\Mosquitto>sc query mosquittoSERVICE_NAME: mosquittoTYPE               : 10  WIN32_OWN_PROCESSSTATE              : 1  STOPPEDWIN32_EXIT_CODE    : 0  (0x0)SERVICE_EXIT_CODE  : 0  (0x0)CHECKPOINT         : 0x0WAIT_HINT          : 0x0D:\workSoft\Mosquitto>
   

6. 测试
   测试连接

   ```cmd
   mosquitto_sub.exe -h localhost -p 1883 -t test/topic -u admin -P admin123456
   

   新打开cmd 执行发送命令：
   mosquitto_pub.exe -h localhost -p 1883 -t test/topic -m "hello-mqtt" -u admin -P admin123456
   ，订阅端收到消息即成功。

如果需要局域网访问的话，添加防火墙端口

```cmd
win11
开放 MQTT 核心端口 1883（TCP）
New-NetFirewallRule -DisplayName "MQTT-TCP-1883" -Direction Inbound -LocalPort 1883 -Protocol TCP -Action Allow -Profile Any
可选：开放 WebSocket 端口 9001
New-NetFirewallRule -DisplayName "MQTT-WS-9001" -Direction Inbound -LocalPort 9001 -Protocol TCP -Action Allow -Profile Any
删除 MQTT 1883 端口规则
Remove-NetFirewallRule -DisplayName "MQTT-TCP-1883"
删除 9001 端口规则
Remove-NetFirewallRule -DisplayName "MQTT-WS-9001"
win10：
开放 MQTT 核心端口 1883
netsh advfirewall firewall add rule name="MQTT-TCP-1883" dir=in action=allow protocol=TCP localport=1883 enable=yes
可选：开放 WebSocket 端口 9001
netsh advfirewall firewall add rule name="MQTT-WS-9001" dir=in action=allow protocol=TCP localport=9001 enable=yes
删除 1883 端口规则
netsh advfirewall firewall delete rule name="MQTT-TCP-1883"
删除 9001 端口规则
netsh advfirewall firewall delete rule name="MQTT-WS-9001"
```