在 Debian 上安装 EMQX

本页将指导您如何在 Debian 系统中下载安装并启动最新版 EMQX。

支持的 Debian 版本：

• Debian 13
• Debian 12
• Debian 11

如希望在其他支持系统中进行安装，或体验其他版本，可前往 EMQX 企业版下载页面获取安装信息。

TIP

从 EMQX 6.3.0 开始，通过 DEB 包安装的 EMQX 可使用与 Docker 镜像相同的 /opt/emqx/... 路径。路径映射参见文件和目录。

通过 deb 安装

1. 前往官方下载页面，选择 Debian 页签。
2. 选择最新版本 6.3.0，在安装包类型中根据需要的版本和 CPU 架构选择 deb 安装包。
3. 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。

启动 EMQX

systemctl 启动：

sudo systemctl start emqx

TIP

从 EMQX 6.3.0 开始，可在 /etc/emqx/emqx.env 中设置启动期环境变量，例如 EMQX_SECURITY_PROFILE。emqx 命令每次执行时都会加载该文件，包括以服务方式启动、前台启动以及运行 emqx ctl 时。软件包升级会保留对该文件的修改。修改启动期环境变量后，重启 EMQX 节点以使更改生效。参见启动期环境变量。

卸载 EMQX

安装完成后，可通过如下命令卸载 EMQX：

sudo apt remove --purge emqx

通过 tar.gz 安装

1. 前往官方下载页面，选择 Debian 页签。
2. 选择最新版本 6.3.0，在安装包类型中根据需要的版本和 CPU 架构选择 tar.gz 安装包。
3. 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。

安装完成后，可通过如下命令启动 EMQX。

./emqx/bin/emqx foreground