MQTT部署

一、下载与安装

1. ‌获取安装包‌

   • 访问EMQX官网下载页面，选择适用于Windows的版本（如emqx-5.3.0-windows-amd64.zip）。

   • 解压至非中文、无特殊字符的目录（如D:\Program Files\emqx）‌。

2. ‌安装依赖‌

   • 确保系统已安装Java环境（若使用Apollo等需要Java的版本，需配置JAVA_HOME变量）。

二、启动EMQX服务

1. ‌通过命令行启动‌

   • 以管理员身份运行CMD，进入EMQX的bin目录：

     cd D:\Program Files\emqx\bin

   • 执行命令启动服务：

     .\emqx.cmd start

   • 验证运行状态：

     .\emqx_ctl status

     （若返回运行状态为“Running”，则启动成功）‌

2. ‌控制台启动（可选）‌

   • 执行.\emqx.cmd console以控制台模式启动，观察实时日志‌。

三、访问管理控制台

1. ‌登录Dashboard

   • 浏览器访问http://localhost:18083，使用默认账号admin/public登录‌。

   • 首次登录建议修改密码或选择跳过‌。

四、基础配置

1. ‌修改监听端口‌

   • 编辑配置文件etc\emqx.conf，调整listeners.tcp.default下的端口号（如1883）。

2. ‌添加用户认证‌

   • 进入Dashboard的‌认证‌页面，选择“Password-Based”方式，配置内置数据库并设置加密规则（如SHA256）。

   • 在‌用户管理‌中添加新用户（如MQTT1/MQTT2），设置密码及权限‌。

五、客户端连接测试

1. ‌使用MQTTX客户端

   • 下载并安装MQTTX客户端，配置服务器地址为127.0.0.1，端口为1883，输入创建的用户名和密码进行连接‌。

注意事项

• ‌版本兼容性‌：EMQX 5.3.2及之后版本可能不再提供Windows安装包，建议使用5.3.0或更早版本‌。

• ‌生产环境限制‌：官方不建议在Windows生产环境中部署EMQX，仅推荐用于开发测试‌。

• ‌防火墙设置‌：确保服务器防火墙放行MQTT服务端口（如1883、18083）‌。