测试和调试 MQTT

在桌面、终端或浏览器里连接、发布和查看 MQTT 消息。

下载 MQTTX 文档
MQTTX Desktop 中收到的 JSON 传感器消息

所有 Broker，收进一个侧栏

分组管理，同时打开，在线状态一眼可见。

连接指南

zsh · CLI

  • MQTT 5.0、3.1.1 与 3.1

    支持 TCP、TLS 和 WebSocket，含双向 TLS。

  • 多窗口

    在独立窗口中并排查看两个 Broker。

  • CLI 里也能复用

    保存一次，用 --load-options 加载。

像聊天一样收发 MQTT 消息

发出的在右，收到的在左，按订阅着色。

  • 订阅颜色标记

    每个主题过滤器有自己的颜色。

  • 搜索与高亮

    按主题或内容查找，结果就地高亮。

  • 定时发送

    按间隔自动发布，数据持续流动。

  • 完整日志

    连接、发布和错误都有日志可查。

什么格式的 Payload 都能读

格式随时切换，GZIP 消息先解压再解码。

Base64

eyJ0ZW1wIjoyMy41LCJodW0iOjYxfQ==

原始数据

{
  "temp": 23.5,
  "hum": 61
}

  • 六种格式

    以 Plaintext、JSON、Base64、Hex、CBOR 或 MsgPack 发布和查看。

  • Protobuf 与 Avro

    用你自己的 Schema 编解码。

看清主题和流量

主题树、图表、消息速率和消息对比，全部实时。

用脚本生成测试数据

用 JavaScript 加工消息，桌面端和 CLI 都能跑。

  • 自定义脚本

    发布或接收时转换 Payload。

  • 内置场景

    mqttx simulate 自带特斯拉车队等 IoT 数据。

function handlePayload(value) {
  const data = JSON.parse(value)
  data.temp = +(data.temp * 1.8 + 32).toFixed(1)
  data.unit = 'F'
  return JSON.stringify(data, null, 2)
}

execute(handlePayload)

输入

{"temp": 23.5, "hum": 61}

输出

{"temp": 74.3, "hum": 61, "unit": "F"}

在终端里测试 MQTT

在任意终端里发布、订阅、压测和模拟数据。

mqttx sub -t 'sensors/#' -h broker.emqx.io
了解 MQTTX CLI Agent Skill 指南
zsh · MQTTX CLI

mqttx sub

❯ mqttx sub -t 'sensors/#' -h broker.emqx.io -v

✔ Connected

topic:sensors/room2/humpayload:{"hum":62}
topic:sensors/room1/temppayload:{"temp":23.7}
topic:sensors/room2/temppayload:{"temp":24.0}
topic:sensors/room1/humpayload:{"hum":63}
topic:sensors/room1/temppayload:{"temp":24.1}

mqttx pub

❯ mqttx pub -t 'sensors/room1/temp' -m '{"temp":24.1}' -h broker.emqx.io

✔ Message published

❯ ▋

ℹ Start the publish benchmarking, connections: 1000, req interval: 10ms, message interval: 10ms

✔ Connected 1000/1000

ℹ Published total: 0, message rate: 0/s

❯ ▋

ℹ Start simulation publishing, scenario: tesla, connections: 10

✔ Connected 10/10

ℹ Published total: 1,240, message rate: 52/s

❯ ▋

MQTTX Agent

用一句话说需求，Agent 在 MQTTX 里完成，每一步都看得见。

  • 它一边操作，连接和消息列表一边更新。
  • 输入 / 使用 Skills，或接入 MCP Server 调用你自己的工具。
  • 内置 20 家服务商，使用你自己的 API Key。
OpenAIClaudeDeepSeekGeminiQwenKimiGrokMistral
查看 Agent 文档

还有更多

|

浏览器即用

在线使用 MQTTX Web，或用 Docker 自托管。

JSON CSV Excel XML YAML

备份与恢复

JSON、CSV、Excel、XML 或 YAML。

三种主题

浅色、深色和夜间。

🇺🇸 English

六种语言

英语、简体中文、日语、土耳其语、匈牙利语和韩语。

下载 MQTTX

免费开源，支持 macOS、Windows 和 Linux。

下载
$curl -fsSL https://emqx.sh/mqttx | sh