MQTT怎么在Windows上搭建？一篇讲清楚从零到可用的完整教程

目标关键词：MQTT怎么在Windows上搭建

如果你想在 Windows 上搭一个能用的 MQTT 服务，最常见、最省事的办法就是直接装一套 EMQX 或 Mosquitto。
前者功能更全，适合开发、测试、物联网项目；后者更轻量，适合入门和本地学习。

这篇文章会按“问题分析 → 解决方案 → 注意事项”的思路，手把手讲清楚：

MQTT 是什么
Windows 上怎么搭建 MQTT 服务器
如何测试发布和订阅
常见报错怎么处理
进阶一点怎么做开机自启、远程访问和安全设置

一、先搞清楚：MQTT到底是什么

MQTT 全称是 Message Queuing Telemetry Transport，是一种轻量级消息协议。
它最常见的用途就是：

智能家居设备互相通信
传感器上传数据
远程控制开关、灯、摄像头
物联网项目的数据转发
多台设备之间做消息订阅

它的核心思路很简单：

发布者（Publisher）：负责发消息
代理服务器（Broker）：负责转发消息
订阅者（Subscriber）：负责接收消息

你可以把 MQTT 理解成一个“消息中转站”。
比如温度传感器往主题 home/room1/temp 发数据，手机 App 订阅这个主题后，就能实时收到温度变化。

二、Windows 上搭建 MQTT，有哪几种方案

在 Windows 上搭建 MQTT，常见有 3 种方式：

方案 1：安装 Mosquitto

适合：

新手
本地测试
占用资源少
想快速跑起来

优点：

安装简单
轻量
免费
上手快

缺点：

管理界面弱
高级功能不如 EMQX

方案 2：安装 EMQX

适合：

做项目
需要 Web 管理界面
想要更完整的功能

优点：

功能强
有控制台
支持更多扩展
更适合实际项目

缺点：

比 Mosquitto 占资源
初次部署稍复杂一点

方案 3：用 Docker 跑 MQTT

适合：

会一点命令行
想快速部署、方便删除
电脑上已经装了 Docker

优点：

环境隔离好
迁移方便
适合开发测试

缺点：

小白上手略难
需要先装 Docker

三、最推荐的新手方案：Windows 安装 Mosquitto

如果你是第一次搭建 MQTT，建议先用 Mosquitto。
下面直接讲完整步骤。

方案一：在 Windows 上安装 Mosquitto

1. 下载 Mosquitto

打开 Mosquitto 官方下载页面，选择 Windows 版本安装包。
一般下载的是类似下面这种：

mosquitto-xxx-install-windows-x64.exe

建议优先装 64 位版本，大多数 Windows 都支持。

2. 安装 Mosquitto

双击安装包后，一路下一步即可。
建议安装到默认目录，例如：

C:\Program Files\mosquitto

安装过程中如果出现组件选项，建议勾选：

Mosquitto Broker
Command Line Clients

这样后面测试会方便很多。

3. 检查安装是否成功

安装完成后，按下 Win + R，输入：

cmd

打开命令提示符，然后输入：

mosquitto -v

如果能看到版本信息或启动日志，说明安装基本正常。

如果提示“不是内部或外部命令”，通常有两种可能：

没有把 Mosquitto 加到环境变量
你当前命令行不在安装目录下

可以直接进入安装目录执行：

cd "C:\Program Files\mosquitto"
mosquitto -v

4. 启动 MQTT 服务端

Mosquitto 默认可以直接作为服务运行。
如果安装时已经注册为服务，可以在 Windows 服务里查看：

按 Win + R
输入 services.msc
找到 Mosquitto Broker
看状态是否为“正在运行”

如果没有运行，可以手动启动。

5. 本地测试 MQTT 是否可用

Mosquitto 自带两个非常实用的命令行工具：

mosquitto_sub：订阅消息
mosquitto_pub：发布消息

第一步：打开一个命令行窗口，订阅主题

输入：

mosquitto_sub -h 127.0.0.1 -t test/topic

这表示：

连接本机 MQTT 服务器
订阅主题 test/topic

第二步：再打开一个命令行窗口，发布消息

输入：

mosquitto_pub -h 127.0.0.1 -t test/topic -m "hello mqtt"

如果前面的订阅窗口立刻显示：

hello mqtt

说明 MQTT 搭建成功。

四、如果想要更强功能，推荐安装 EMQX

如果你不是只想本地测试，而是想要一个更像“正式服务”的 MQTT 服务器，建议直接上 EMQX。

1. 下载 EMQX Windows 版本

进入 EMQX 官方网站，下载 Windows 安装包。
通常会提供：

Windows 安装程序
ZIP 压缩包
Docker 镜像

新手推荐直接下载安装程序。

2. 安装 EMQX

双击安装包，按照提示下一步安装。
安装完后，一般会包含：

MQTT Broker 服务
Web 管理控制台
默认监听端口

3. 启动 EMQX

安装成功后，打开浏览器，访问控制台地址。
常见形式类似：

http://127.0.0.1:18083

第一次登录时，通常会有默认账号密码。
不同版本默认值可能不一样，安装界面或官方说明里会写清楚。

登录后你可以看到：

客户端连接情况
主题消息
认证配置
规则引擎
日志信息

这对于调试 MQTT 项目非常方便。

4. 用客户端测试 MQTT

你可以使用以下工具测试：

MQTTX
MQTT Explorer
PuTTY/命令行
Python 脚本

用 MQTTX 测试最简单

MQTTX 是很常用的 MQTT 图形化客户端，适合新手。
你只需要：

打开 MQTTX
新建连接
填写 Broker 地址：127.0.0.1
填写端口：1883
点击连接
订阅一个主题，比如 demo/test
发送一条消息

如果能收到消息，就说明一切正常。

五、MQTT在Windows上搭建成功后，怎么让外部设备也能连进来

这是很多人卡住的地方。
本机能连，不代表手机、树莓派、其他电脑也能连。

1. 确认监听端口

MQTT 默认端口通常是：

1883：普通 MQTT
8883：MQTT over TLS/SSL

先确保 Broker 真的在监听 1883。

可以在命令行执行：

netstat -ano | findstr 1883

如果看到监听信息，说明端口已经打开。

2. 放行 Windows 防火墙

如果外部设备连不上，第一步就查防火墙。

操作方法：

打开“Windows 安全中心”
进入“防火墙和网络保护”
点击“高级设置”
新建入站规则
选择“端口”
TCP
输入 1883
允许连接
选择适用配置文件
保存规则

如果你用的是 EMQX 控制台，还可以把管理端口一起放行，比如：

18083

3. 连接时要用正确的 IP

如果客户端不在本机，就不要再写 127.0.0.1 了。
应该改成 Windows 电脑的局域网 IP，比如：

192.168.1.100

查看本机 IP：

按 Win + R，输入：

cmd

然后执行：

ipconfig

找到当前网卡的 IPv4 地址。

4. 确保路由器没有限制内网通信

如果同一个局域网里的设备都连不上，可能是：

设备不在同一个网段
路由器开启了 AP 隔离
防火墙拦截了连接
Wi-Fi 和有线网络处于隔离状态

这种情况可以先做最简单的验证：

手机连同一个 Wi-Fi
用 MQTT 客户端连接电脑 IP
测试发布/订阅

六、如果你想自己改配置文件，可以这样做

以 Mosquitto 为例，配置文件一般叫：

mosquitto.conf

常见配置示例：

listener 1883
allow_anonymous true
persistence true
persistence_location C:\Program Files\mosquitto\data\
log_dest stdout

这几行什么意思：

listener 1883：监听 1883 端口
allow_anonymous true：允许匿名访问
persistence true：开启持久化，重启后保留数据
persistence_location：数据保存位置
log_dest stdout：输出日志到控制台

更安全的写法

如果不是测试环境，建议不要长期开放匿名访问。
可以改成：

listener 1883
allow_anonymous false
password_file C:\Program Files\mosquitto\passwd

然后创建账号密码：

mosquitto_passwd -c C:\Program Files\mosquitto\passwd user1

输入密码后，就能用账号认证连接了。

七、用 Python 测试 MQTT 是否正常

如果你是做开发的，Python 测试特别方便。

先安装库：

pip install paho-mqtt

订阅示例

import paho.mqtt.client as mqtt

def on_connect(client, userdata, flags, rc):
    print("连接结果：", rc)
    client.subscribe("test/topic")

def on_message(client, userdata, msg):
    print(msg.topic, msg.payload.decode())

client = mqtt.Client()
client.on_connect = on_connect
client.on_message = on_message

client.connect("127.0.0.1", 1883, 60)
client.loop_forever()

发布示例

import paho.mqtt.client as mqtt

client = mqtt.Client()
client.connect("127.0.0.1", 1883, 60)
client.publish("test/topic", "hello from python")
client.disconnect()

如果订阅端收到消息，说明 MQTT 服务正常。