DesktopCLIWeb

安装

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 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

在此页面