微信小程序控制空调之EMQX服务器安装与配置

目录

前言

一、EMQX服务器安装与配置

1. Windows系统安装（推荐Docker方式）

二、MQTTX客户端安装与使用

1. 下载安装

2. 连接EMQX服务器

三、客户端与服务器通信测试

1：MQTTX自收发测试

四、安全加固建议（生产环境必做）

修改默认密码

启用TLS加密

IP访问限制

常见问题排查

总结

---

---

前言

以下是EMQX服务器安装配置、MQTTX客户端使用及通信测试的完整教程，主要Windows平台实现，并附客户端通信代码示例。

---

一、EMQX服务器安装与配置

1. Windows系统安装（推荐Docker方式）

1. 安装Docker Desktop

   • 访问Docker官网下载安装包，完成后启动Docker服务。

拉取并运行EMQX容器

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 18083:18083 emqx/emqx:latest

• 端口说明：

  • 1883：MQTT TCP协议端口

  • 8083：MQTT WebSocket端口

  • 18083：Dashboard管理界面端口

• 访问Dashboard

  • 打开浏览器访问 http://localhost:18083

  • 默认账号：admin，密码：public

二、MQTTX客户端安装与使用

1. 下载安装

• Windows/macOS：官网下载安装包（.exe或.dmg）

2. 连接EMQX服务器

1. 打开MQTTX → 点击“+”新建连接

2. 配置参数：

   • Name：自定义名称（如My_Server）

   • Host：127.0.0.1（若服务器在本地）或服务器IP

   • Port：1883（TCP）或 8083（WebSocket）

   • 取消用户名/密码（默认未启用认证）

三、客户端与服务器通信测试

1：MQTTX自收发测试

1. 订阅主题

   • 在MQTTX中点击“New Subscription” → 输入主题 test/topic → QoS 0 → 确认。

2. 发布消息

   • 底部消息框输入相同主题 test/topic，消息内容 Hello EMQX! → 点击发送

   • 结果：消息即时显示在接收区域。

四、安全加固建议（生产环境必做）

1. 修改默认密码

   • 在EMQX Dashboard → 访问控制 → 用户管理 中重置admin密码。

2. 启用TLS加密

   • 在etc/emqx.conf中配置SSL证书，客户端连接端口改为8883（TCP TLS）或8084（WebSocket TLS）。

3. IP访问限制

   • Dashboard → 监听器 → 编辑规则，限制访问IP段。

常见问题排查

问题现象	解决方案
连接超时	检查防火墙是否放行1883/8083端口
Dashboard无法登录	确认EMQX进程运行（emqx_ctl status）
MQTTX收不到消息	检查主题名拼写及QoS等级一致性

---

总结

完整代码见EMQX示例库https://github.com/emqx/emqx/tree/master/examplesMQTT,微信小程序文档

使用微信小程序接入 | EMQX 文档

ESP32接入文档

https://github.com/emqx/MQTT-Client-Examples/tree/master/mqtt-client-ESP32

各种接入方式文档总页

客户端 TLS 接入示例 | EMQX 文档