安装

MQTTX CLI 支持 Windows,macOS,Linux 平台,您可以通过以下方式安装 MQTTX CLI:

  1. 命令行:使用二进制文件快速安装。
  2. 桌面客户端:通过桌面应用直接安装。
  3. Docker:使用 Docker 进行安装。
  4. NPM:通过 NPM 安装。
  5. 手动下载GitHub:手动下载并安装。

如果出现网络原因,导致从 GitHub 下载时会出现网速较慢或卡顿的情况时,我们推荐您在 MQTTX CLI 首页中进行下载和安装。

如果您需要查看,下载和使用更多的已发布版本,也可以查看和访问更多下载,选择符合您需要的版本并下载后安装使用。

注意:下载时,注意区分当前系统环境的 CPU 架构,并尽量选择最新版本下载。

macOS

Homebrew

brew install emqx/mqttx/mqttx-cli

Intel Chip

curl -LO https://www.emqx.com/zh/downloads/MQTTX/${version}/mqttx-cli-macos-x64
sudo install ./mqttx-cli-macos-x64 /usr/local/bin/mqttx

Apple Silicon

curl -LO https://www.emqx.com/zh/downloads/MQTTX/${version}/mqttx-cli-macos-arm64
sudo install ./mqttx-cli-macos-arm64 /usr/local/bin/mqttx

Linux

x86-64

curl -LO https://www.emqx.com/zh/downloads/MQTTX/${version}/mqttx-cli-linux-x64
sudo install ./mqttx-cli-linux-x64 /usr/local/bin/mqttx

ARM64

curl -LO https://www.emqx.com/zh/downloads/MQTTX/${version}/mqttx-cli-linux-arm64
sudo install ./mqttx-cli-linux-arm64 /usr/local/bin/mqttx

Windows

Windows 用户请到 MQTTX CLI 首页GitHub,找到对应的系统架构的 exe 包,手动下载后使用。

注意:在使用需要输入字符串数据的命令时,在 Windows cmd 中使用双引号,而在 PowerShell 中可以使用单引号。此外,路径使用的是 \,而在其他操作系统中,则使用 /

Docker

首先,拉取镜像:

docker pull emqx/mqttx-cli

交互模式

启动容器内的交互式 Shell 会话(允许执行多条命令):

docker run -it --rm emqx/mqttx-cli

进入容器的 Shell 后,您可以运行 mqttx 命令(例如 mqttx connmqttx pub)。例如:

❯ docker run -it --rm emqx/mqttx-cli
/app # mqttx conn -h broker.emqx.io -p 1883
✔ Connected
- Press Ctrl+C to disconnect and exit

一次性命令执行

直接执行单个 MQTTX 命令而无需进入 Shell:

# 示例:连接 Broker
docker run --rm emqx/mqttx-cli mqttx conn -h broker.emqx.io -p 1883

# 示例:发布消息
docker run --rm emqx/mqttx-cli mqttx pub -t test -m "hello world" -h broker.emqx.io

# 示例:订阅主题
docker run --rm emqx/mqttx-cli mqttx sub -t test -h broker.emqx.io

NPM

npm install mqttx-cli -g

其它平台

从 MQTTX 的发布页面内,下载对应的二进制文件。

验证安装

安装完成后,可以通过以下命令验证是否安装成功:

mqttx -v