TCP、TLS 与 WebSocket
理解 mqtt、mqtts、ws、wss 选项和当前配置入口的限制。
浏览全部手册
本页目录
协议与默认端口
| 选项 | 传输方式 | 切换协议时填入的默认端口 |
|---|---|---|
| mqtt:// | MQTT over TCP | 1883 |
| mqtts:// | MQTT over TLS | 8883 |
| ws:// | MQTT over WebSocket | 8083 |
| wss:// | MQTT over 安全 WebSocket | 8084 |
这些端口只是工具默认值,不是 broker 必须使用的端口。切换协议会更新端口,保存前再次核对。
选择正确的入口
普通 MQTT TCP 监听端口不能直接作为 WebSocket 入口。TLS 端口也不能用普通 mqtt:// 连接。向服务提供方确认协议、主机、端口以及 WebSocket 路径。
桌面工具可以使用原生网络能力;本产品站本身不提供浏览器 MQTT 连接功能。
WebSocket 路径
ws/wss 表单提供独立路径输入;两端空值统一访问 /mqtt,显式 / 访问根路径。tenant/mqtt?x=1 补为 /tenant/mqtt?x=1。不要拼进主机字段;路径最多 2048 UTF-8 字节,不含空白、控制字符、反斜线或 # 片段,需要时用百分号编码。
旧 Electron 空路径曾访问根路径,服务若只接受根路径需明确填 /;保存保留原始配置,编辑时还原。TCP 不使用此字段。
TLS 证书限制
当前 UI 没有导入自定义 CA、客户端证书、私钥或跳过证书校验的入口。mqtts:// / wss:// 使用运行时默认 TLS 配置,不能因此推导出双向 TLS 或自签名证书配置已支持。
连接失败时检查主机名与证书是否匹配、系统时间是否正确,以及服务端证书链。
MQTT 协议版本
连接表单当前不提供 MQTT 3.1.1 / 5.0 的切换和 MQTT 5 属性配置。虽然「关于」展示协议概览,现有连接实现与验证主要对应 MQTT 3.1.1;不要按手册宣称所有 MQTT 5 能力都已覆盖。
仍有疑问?按反馈清单整理复现信息 →