Mosquitto 安装与配置教程：支持 JavaScript 网页 WebSocket 连接

cd "C:\Program Files\mosquitto"
mosquitto_passwd.exe -b pwfile.conf admin admin123456

注意：-b 参数表示非交互式创建，首次创建时使用 -c 会覆盖文件，后续添加用户时请勿使用 -c。

3. 启动与验证服务

启动服务：

net start mosquitto

或通过 Windows 服务管理器（services.msc）查找 Mosquitto Broker 并启动。

验证服务状态：

sc query mosquitto

状态应为 RUNNING。

4. 测试 MQTT 通信

打开两个命令提示符窗口进行测试。

窗口 A（订阅主题）：

mosquitto_sub -h localhost -p 1883 -t "test/topic" -u admin -P admin123456

窗口 B（发布消息）：

mosquitto_pub -h localhost -p 1883 -t "test/topic" -m "Hello from Mosquitto"

如果窗口 A 成功收到消息，则说明 Mosquitto 服务运行正常，认证和通信均无问题。

5. 配置防火墙（允许局域网访问）

若需让局域网内其他设备连接此 Mosquitto 服务器，需开放端口 1883。不然局域网内可能无法 ping 得通。

1. 打开'Windows Defender 防火墙'高级设置
   • 按下 Win + R，输入 wf.msc，回车；
   • 或打开'控制面板' → '系统和安全' → 'Windows Defender 防火墙' → 左侧点击'高级设置'。
2. 创建入站规则（允许外部访问本机端口）
   • 在左侧点击'入站规则' → 右侧点击'新建规则'。
   • 选择'端口' → 点击'下一步'。
   • 选择协议类型（TCP 或 UDP）→ 输入具体端口号（如 1883）→ 点击'下一步'。
   • 选择'允许连接' → 点击'下一步'。
   • 选择适用的网络类型（域、专用、公用，通常全选）→ 点击'下一步'。
   • 输入规则名称（如 'Open Port 1883'）→ 点击'完成'。
3. 创建出站规则（允许本机访问外部端口，如需）
   • 步骤同上，但在'高级设置'中选择'出站规则' → 新建规则。

6. 高级功能（可选）

• WebSocket 支持：在 mosquitto.conf 中添加 listener 8083 并设置 protocol websockets，可支持浏览器端 MQTT 连接。

浏览器端连接示例

使用 Paho MQTT.js 或 MQTT.js 库连接：

<script src="https://cdn.bootcdn.net/ajax/libs/mqtt/4.3.7/mqtt.min.js"></script>
<script>
  const client = mqtt.connect('ws://your-server-ip:8083/mqtt', {
    clientId: 'web-client-' + Math.random().toString(16).substr(2, 8),
    clean: true,
    reconnectPeriod: 3000
  });
  client.on('connect', () => {
    console.log('Connected');
    client.subscribe('test/topic');
  });
  client.on('message', (topic, payload) => {
    console.log(`Received: ${payload.toString()} on ${topic}`);
  });
</script>

⚠️ 注意：若使用 wss://（加密），需确保服务器配置了有效 SSL 证书。

• TLS/SSL 加密：如需加密通信，需配置 cafile、certfile 和 keyfile，建议参考安全指南。
• ACL 访问控制：通过 acl_file 配置不同用户对不同主题的读写权限。

7. 常见问题

• Q：连接被拒绝（Connection Refused）？ A：检查 allow_anonymous false 是否设置，且是否提供了正确的用户名和密码。
• Q：命令提示符找不到 mosquitto_sub？ A：确保安装时勾选了 'Add to PATH'，或手动进入 C:\Program Files\mosquitto\ 目录执行命令。
• Q：服务无法启动？ A：检查配置文件语法是否正确，日志文件 mosquitto.log 会记录具体错误信息。