微信小程序控制空调之EMQX服务器安装与配置
目录
前言
一、EMQX服务器安装与配置
1. Windows系统安装(推荐Docker方式)
二、MQTTX客户端安装与使用
1. 下载安装
2. 连接EMQX服务器
三、客户端与服务器通信测试
1:MQTTX自收发测试
四、安全加固建议(生产环境必做)
修改默认密码
启用TLS加密
IP访问限制
常见问题排查
总结
前言
以下是EMQX服务器安装配置、MQTTX客户端使用及通信测试的完整教程,主要Windows平台实现,并附客户端通信代码示例。
一、EMQX服务器安装与配置
1. Windows系统安装(推荐Docker方式)
-
安装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服务器
-
打开MQTTX → 点击“+”新建连接
-
配置参数:
-
Name:自定义名称(如
My_Server
) -
Host:
127.0.0.1
(若服务器在本地)或服务器IP -
Port:
1883
(TCP)或8083
(WebSocket) -
取消用户名/密码(默认未启用认证)
-
三、客户端与服务器通信测试
1:MQTTX自收发测试
-
订阅主题
-
在MQTTX中点击“New Subscription” → 输入主题
test/topic
→ QoS 0 → 确认。
-
-
发布消息
-
底部消息框输入相同主题
test/topic
,消息内容Hello EMQX!
→ 点击发送 -
结果:消息即时显示在接收区域。
-
四、安全加固建议(生产环境必做)
-
修改默认密码
-
在EMQX Dashboard →
访问控制
→用户管理
中重置admin
密码。
-
-
启用TLS加密
-
在
etc/emqx.conf
中配置SSL证书,客户端连接端口改为8883
(TCP TLS)或8084
(WebSocket TLS)。
-
-
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 文档