Skip to content

在 Ubuntu 上安装 EMQX ​

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

支持的 Ubuntu 版本:

  • Ubuntu 24.04
  • Ubuntu 22.04

TIP

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

使用 Apt 包管理器安装 ​

EMQX 支持使用 Apt 包管理器进行安装,为用户提供了一种便捷且可靠的方式来管理 EMQX 的安装和更新。以下是使用 apt 安装 EMQX 的步骤:

  1. 添加 EMQX 的 apt 仓库:

    bash
    curl -s https://packagecloud.io/install/repositories/emqx/emqx-enterprise5/script.deb.sh | sudo bash
  2. 安装 EMQX:

    bash
    sudo apt-get install emqx
  3. 启动 EMQX:

    bash
    sudo systemctl start emqx

手动安装软件包 ​

EMQX 支持通过 .deb 软件包或 .tar.gz 压缩包进行安装。如希望在其他支持系统中进行安装,或体验其他版本,可前往 EMQX 企业版下载页面获取安装信息。

通过 deb 安装 ​

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

启动 EMQX ​

启动为一个 systemd 服务:

bash
sudo systemctl start emqx

TIP

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

卸载 EMQX ​

安装完成后,可通过如下命令卸载 EMQX:

shell
sudo apt remove --purge emqx

通过 tar.gz 安装 ​

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

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

bash
./emqx/bin/emqx foreground