qipai/docs/local-dev-mqtt.md

本地 MQTT 调试环境

环境边界：WSL 本地 Broker 仅用于开发/测试，不代表生产 101.42.38.246 已完成部署。

已核验服务级基线

项目	期望	本轮结果	状态
EMQX 包版本	5.8.9	emqx 5.8.9	PASS
EMQX 服务状态	active	active	PASS
EMQX 自启	enabled	enabled	PASS
MQTTX CLI 路径	/usr/local/bin/mqttx	/usr/local/bin/mqttx	PASS
MQTTX CLI 版本	1.13.0	1.13.0	PASS
MQTT TCP	1883 监听	0.0.0.0:1883	PASS
MQTT TLS	8883 监听	0.0.0.0:8883	PASS
WebSocket	8083 监听	0.0.0.0:8083	PASS
WebSocket TLS	8084 监听	0.0.0.0:8084	PASS
Dashboard	18083 监听	0.0.0.0:18083	PASS

可重复检查

bash scripts/dev/wsl/check-local-mqtt.sh

验收边界

端口监听正常只证明服务级可用，不能证明以下项目已完成：

• TLS 证书链和客户端校验。
• MQTT 客户端认证账号。
• 错误密码拒绝。
• ACL 越权拒绝。
• MQTT 3.1 / QoS 1 业务协议联调。
• 遗嘱消息。
• 重复消息幂等。
• 真实控制箱、门锁、插座执行结果。

账号记录规则

• 本地 admin 账号只能记录为“已知调试账号”，不得在 Git 中记录口令。
• 需要区分 Dashboard 管理员账号与 MQTT 客户端认证账号。
• MQTT 客户端账号应在后续测试中使用最小权限账号和 ACL。