Windows小白也能懂：EMQX安装使用图文教程

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   创建一个交互式教程应用，引导用户在Windows上逐步安装和配置EMQX。包含视频演示、图文步骤、实时错误检测和解决方案。最后测试基本MQTT功能并给出成功提示。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果

最近在研究物联网项目时接触到了EMQX这款强大的MQTT消息服务器，发现它在Windows上的安装过程对新手特别友好。作为从零开始摸索的过来人，记录下完整操作流程和避坑要点，希望能帮到同样入门的朋友们。

1. 准备工作

• 确保Windows系统是64位版本（右键「此电脑」→「属性」可查看）
• 预留至少2GB磁盘空间，EMQX安装包约150MB
• 关闭杀毒软件避免误拦截（完成后再开启）

2. 下载与安装

1. 访问EMQX官网下载Windows版安装包（选择带.exe后缀的版本）
2. 双击安装包，一路点击「Next」使用默认配置
3. 注意勾选「Add EMQX to system PATH」方便后续命令行操作
4. 安装完成后不要立即运行，先进行基础配置

3. 基础配置调整

• 配置文件位于安装目录下的etc/emqx.conf
• 用记事本打开后重点关注：
• listener.tcp.default = 1883（默认MQTT端口）
• dashboard.listener.http = 18083（管理后台端口）
• 初次使用建议保持默认，保存后关闭文件

4. 启动与验证

1. 在开始菜单找到「EMQX Command Prompt」并打开
2. 输入命令emqx start启动服务（看到「EMQX is started!」即成功）
3. 浏览器访问http://localhost:18083进入控制台
4. 默认账号密码均为admin，首次登录需修改密码

5. 常见问题解决

• 端口冲突：如果启动失败，可能是端口被占用。修改emqx.conf中的端口号后重启服务
• 内存不足：32位系统可能报错，建议换用64位系统
• 无法访问控制台：检查防火墙是否放行18083端口

6. 功能测试

用MQTTX工具（官网可下载）测试消息收发： 1. 新建连接，地址填localhost，端口1883 2. 订阅主题如test/topic3. 发布消息到同一主题，确认接收正常

整个过程在InsCode(快马)平台的在线环境里也能流畅完成，他们的云服务直接预装了EMQX，不需要本地配置就能快速体验MQTT消息流转。特别适合想先试玩再决定是否安装的新手，部署过程比我手动安装省心多了，还能随时分享给小伙伴一起测试。

遇到任何卡点都欢迎留言交流，刚开始可能会觉得步骤多，实际操作几次就会发现EMQX的Windows版确实对小白很友好~

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

   创建一个交互式教程应用，引导用户在Windows上逐步安装和配置EMQX。包含视频演示、图文步骤、实时错误检测和解决方案。最后测试基本MQTT功能并给出成功提示。

3. 点击'项目生成'按钮，等待项目生成完整后预览效果