TCP、TLS 与 WebSocket

协议与默认端口

这些端口只是工具默认值，不是 broker 必须使用的端口。切换协议会更新端口，保存前再次核对。

选择正确的入口

普通 MQTT TCP 监听端口不能直接作为 WebSocket 入口。TLS 端口也不能用普通 mqtt:// 连接。向服务提供方确认协议、主机、端口以及 WebSocket 路径。

桌面工具可以使用原生网络能力；本产品站本身不提供浏览器 MQTT 连接功能。

WebSocket 路径限制

当前连接表单没有 WebSocket 路径输入项，不要把 /mqtt 拼进主机地址。

当前实现中，Tauri 的空路径默认使用 /mqtt，Electron 使用连接中保存的路径，空值时不附加路径。依赖自定义路径的 broker 不能仅按同一套表单保证两端都能连接。遇到此情况，优先使用服务方提供的 TCP/TLS 入口，或记录运行环境与所需路径反馈。

TLS 证书限制

当前 UI 没有导入自定义 CA、客户端证书、私钥或跳过证书校验的入口。mqtts:// / wss:// 使用运行时默认 TLS 配置，不能因此推导出双向 TLS 或自签名证书配置已支持。

连接失败时检查主机名与证书是否匹配、系统时间是否正确，以及服务端证书链。

MQTT 协议版本

连接表单当前不提供 MQTT 3.1.1 / 5.0 的切换和 MQTT 5 属性配置。虽然「关于」展示协议概览，现有连接实现与验证主要对应 MQTT 3.1.1；不要按手册宣称所有 MQTT 5 能力都已覆盖。