安装
MQTTX CLI 支持 Windows,macOS,Linux 平台,您可以通过以下方式安装 MQTTX CLI:
如果出现网络原因,导致从 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 conn
、mqttx 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