1. 引言
EMQX 是一款开源的高性能物联网消息中间件,基于 Erlang/OTP 构建,支持 MQTT、MQTT-SN、CoAP、LwM2M 等多种协议。它广泛应用于物联网设备接入、车联网、工业数据采集等场景。本文介绍如何在 Windows 系统上安装 EMQX,帮助读者快速搭建本地开发或测试环境。
2. 安装前的准备
在开始安装之前,请确认你的 Windows 系统满足以下条件:
- 操作系统:Windows 10 或 Windows Server 2016 及以上版本(64 位)。
- 硬件要求:至少 2 核 CPU、4 GB 内存,推荐 4 核 CPU、8 GB 内存。
- 网络环境:能够访问 EMQX 官方下载页面或镜像站点。
此外,EMQX 在 Windows 上以 ZIP 压缩包形式分发,无需安装额外的运行时环境,解压即可使用。
3. 下载 EMQX
emqx-Windows安装包 - 123云盘免费不限速|下载免登录
emqx-Windows安装包 - 123云盘免费不限速|下载免登录
4. 解压安装包
将下载好的 ZIP 压缩包解压到指定目录,例如 D:\emqx。解压后,目录结构大致如下:
text
emqx/
├── bin/
├── etc/
├── lib/
├── log/
└── data/
其中 bin 目录存放可执行文件,etc 目录存放配置文件,log 目录用于存放运行日志。
5. 启动 EMQX
打开命令提示符(CMD)或 PowerShell,切换到 EMQX 的 bin 目录,执行以下命令启动服务:
bash
cd D:\emqx\bin
emqx start
启动成功后,控制台会输出 EMQX 的版本信息和监听端口。默认情况下,EMQX 会监听以下端口:
- 1883:MQTT 协议端口。
- 8083:WebSocket 端口。
- 8084:WSS 端口。
- 18083:Dashboard 管理控制台端口。
6. 验证安装
启动完成后,可以通过以下方式验证 EMQX 是否正常运行:
在浏览器中访问 http://localhost:18083,进入 EMQX Dashboard 登录页面。默认用户名和密码为 admin 和 public,登录后即可查看连接状态、消息流量等监控信息。
也可以使用 MQTT 客户端工具(如 MQTTX)连接 localhost:1883,测试消息的发布和订阅功能。
7. 停止与重启
如需停止 EMQX 服务,在 bin 目录下执行:
bash
emqx stop
如需重启服务,执行:
bash
emqx restart
8. 常见问题
以下是一些安装过程中可能遇到的问题及解决方法:
- 端口被占用 :如果 1883 或 18083 端口已被其他程序占用,可以在
etc/emqx.conf配置文件中修改监听端口,然后重启服务。 - 防火墙拦截:Windows 防火墙可能阻止外部设备访问 EMQX 端口,需要在防火墙中放行相关端口。
- 启动失败:如果启动时提示缺少依赖或环境变量问题,请检查是否以管理员身份运行命令提示符,并确认解压路径中不包含中文或空格。
9. 总结
本文介绍了在 Windows 系统上安装 EMQX 的完整流程,包括下载、解压、启动和验证等步骤。EMQX 的 Windows 安装过程相对简单,解压即可运行,适合本地开发和测试。后续可以进一步学习 EMQX 的配置管理、认证授权和插件扩展等高级功能。