FAQ

什么是 MQTTX Web?

MQTTX Web 是一款免费、开源(Apache-2.0)的浏览器端 MQTT 5.0 客户端,通过 WebSocket 连接 MQTT Broker,无需下载安装即可测试 MQTT。访问 mqttx.app/web-client 即可使用。

MQTTX Web 支持哪些 MQTT 版本和协议?

MQTTX Web 支持基于 WebSocket(ws:// 和 wss://)的 MQTT 5.0 和 3.1.1。浏览器无法建立原生 TCP 连接,因此不支持 1883、8883 等端口上的 MQTT over TCP 和 TLS 连接,这类场景请使用 MQTTX 桌面客户端或 MQTTX CLI。

为什么在线版无法使用 ws:// 连接?

在线版 MQTTX Web 通过 https:// 提供服务,浏览器会阻止安全页面发起不安全的 ws:// 连接。请改用 wss://,或通过 http:// 私有化部署 MQTTX Web。详见开始使用。

MQTTX Web 支持双向 TLS 认证吗?

MQTTX Web 无法配置双向 TLS 认证所需的客户端证书和私钥文件。需要提供这些文件时,请使用 MQTTX 桌面客户端或 MQTTX CLI。

可以将 MQTTX Web 部署到自己的服务器吗?

可以。运行官方 Docker 镜像:

docker run -d --name mqttx-web -p 80:80 emqx/mqttx-web

也可以从源码构建,并修改默认 Broker 地址、部署路径等配置,详见开发。

MQTTX Web 和桌面客户端有什么区别?

创建连接、订阅和发布消息的基本流程相同,但 Web 版仅支持 WebSocket,通过 HTTPS 提供服务时需使用 wss://,且无法配置客户端证书文件。桌面版的 MQTTX Agent、Viewer 等功能尚未在 Web 版中提供。功能差异与部署方式请参考 Web 开始使用,共通的操作流程可参考桌面客户端的开始使用。