长沙做网站建设价格网站建设推广优化
目录
前言
一、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 文档