单机版 EMQX 的安装和基本配置说明。单机部署适用于开发测试或小型项目环境，单个 EMQX 实例支持 10000 个并发连接（需要优化配置）。若需求包括高可用性或横向扩展，请配置 EMQX 集群。

安装与启动

1. 创建 EMQX 目录

在 /data 下创建一个目录用于安装 EMQX：

1
2
3
cd /data
mkdir emqx
cd /data/emqx

2. 下载 EMQX 安装包

使用 wget 下载所需版本的 EMQX 安装包：

1
wget https://www.emqx.com/zh/downloads/broker/4.4.4/emqx-4.4.4-otp24.1.5-3-el7-amd64.zip

3. 解压安装包

如果未安装解压工具，请先安装 unzip：

1
yum -y install zip unzip

然后解压下载的安装包：

1
unzip emqx-4.4.4-otp24.1.5-3-el7-amd64.zip

4. 安装依赖（若需要）

如 EMQX 启动时提示缺少依赖，可安装以下依赖项：

1
yum -y install make gcc gcc-c++ kernel-devel m4 ncurses-devel openssl-devel

启动与检查

1. 启动 EMQX

进入解压后的 EMQX 目录并启动服务：

1
2
cd /data/emqx/emqx
./bin/emqx start

2. 检查 EMQX 状态

检查 EMQX 是否启动成功：

1
./bin/emqx_ctl status

成功启动时，输出如下信息：

1
2
Node 'emqx@127.0.0.1' is started
EMQX 4.4.4 is running

3. 停止 EMQX

若需要停止 EMQX 服务：

1
./bin/emqx stop

访问 EMQX 管理控制台

1. 打开浏览器

在浏览器中访问 EMQX 管理控制台，替换 <你的服务器IP> 为实际 IP：

1
http://<你的服务器IP>:18083

2. 登录控制台

  • 用户名：admin
  • 密码：public

3. 修改默认账户密码

为系统安全，建议登录后立即修改默认密码。

测试 MQTT 连接

1. 使用 MQTT 客户端工具

推荐使用工具如 MQTTX 或 Mosquitto 进行测试。连接信息如下：

  • Broker 地址：<你的服务器IP>
  • 端口：1883（非加密）或 8883（加密）
  • 用户名/密码：默认无需填写

2. 发布与订阅测试

在两个客户端中分别发布和订阅主题 test/topic，验证消息是否正常传递。

优化与认证配置

1. 禁用匿名访问

编辑配置文件 /data/emqx/emqx/etc/emqx.conf：

1
vi /data/emqx/emqx/etc/emqx.conf

找到以下配置并设置为 false：

1
allow_anonymous = false

保存后重启 EMQX 服务：

1
./bin/emqx restart

2. 设置用户名和密码认证

编辑文件 /data/emqx/emqx/etc/plugins/emqx_auth_mnesia.conf，添加以下内容：

1
2
auth.user.1.username = admin123
auth.user.1.password = 123456

3. 启动认证插件

在管理控制台启用 emqx_auth_mnesia 插件：

  1. 登录 EMQX 管理控制台
  2. 导航到 “插件管理” 页面
  3. 找到 emqx_auth_mnesia 插件并点击启用