EMQX 开源版安装指南：Linux 与 Windows 系统部署

EMQX 开源版安装教程

本文介绍在 Linux（以 Ubuntu 22.04 LTS 为例）环境下安装 EMQX 开源版的步骤。Windows 用户可参考类似流程。

系统要求

• 操作系统：Ubuntu 22.04 LTS

下载

访问 EMQX 官方下载页面，选择对应版本（如 5.8.6）及系统架构安装包。

根据系统信息选择对应的安装包，例如 amd64 的 ubuntu22.04 选择：

• emqx-5.8.6-ubuntu22.04-amd64.deb

在 Linux 终端使用 wget 命令下载：

wget https://www.emqx.com/zh/downloads/broker/v5.8.6/emqx-5.8.6-ubuntu22.04-amd64.deb

安装

1. 安装依赖

sudo apt update
sudo apt upgrade
sudo apt install -y libssl-dev

2. 安装 deb 包 使用 dpkg 工具安装下载好的文件：

sudo dpkg -i emqx-5.8.6-ubuntu22.04-amd64.deb

启动

# 启动服务
sudo systemctl start emqx
# 检查服务状态
sudo systemctl status emqx

验证安装

访问 EMQX 管理控制台（默认端口 18083）：

• 浏览器输入：http://localhost:18083
• 默认账号 / 密码：admin/public

其他操作命令

操作	命令
停止服务	sudo systemctl stop emqx
重启服务	sudo systemctl restart emqx
开机自启	sudo systemctl enable emqx
查看日志	sudo journalctl -u emqx