Skip to content

ubuntu安装EMQX

  1. 前提条件(支持的ubuntu版本)

    • ubuntu 24.04

    • ubuntu 22.04

    • ubuntu 20.04

    • 查看ubuntu版本命令

      shell
      lsb_release -a

      image-20250812214439294

  2. 手动安装软件包(因为我使用官方提供的apt包管理的方式安装失败)

    1. 添加 EMQX 的deb

      shell
      wget https://www.emqx.com/zh/downloads/enterprise/5.10.0/emqx-enterprise-5.10.0-ubuntu24.04-amd64.deb
    2. 安装 EMQX

      shell
      sudo apt install ./emqx-enterprise-5.10.0-ubuntu24.04-amd64.deb
    3. 启动EMQX

      shell
      sudo systemctl start emqx
    4. 卸载EMQX

      shell
      sudo apt remove --purge emqx
    5. 放行端口(按需,我这里放行18083和8083)

      • 管理后台:18083
      • HTTP:8083
      • HTTPS:8084
      • TCP:1883
      • TLS:8883
      • 集群通信:4369(EPMD)、4370(Erlang 分布式节点)
    6. 访问 ip:18083,打开登录页,使用admin(账号名)和public(密码登录),登录后的第一步修改默认密码

      image-20250812220723871

    7. 测试MQTT通信

      1. 连接客户端

        image-20250812221652156

      2. 测试发布和订阅消息

        image-20250812222006762

    8. 第7步只是使用EMQX提供的诊断工具去测试服务是否可用,这一步我们来使用真正的MQTT客户端(充当后续接入的开发板的角色)连接我们的服务

      • 我使用的工具是 MQTTX,下载地址 MQTTX 下载

        image-20250812222825764

      • 连接EXQX服务

        image-20250812223340217

      • 连接成功后,在后台管理系统的 监控 → 客户端 菜单下就能看到了

        image-20250812223421245

    9. 但是,上面的连接没有设置连接认证,所以任何客户端都能连接,这样肯定是不行的

      1. 打开后台管理系统,在 访问控制 → 客户端认证 菜单下创建认证

        image-20250812223715386

      2. 这里我选择认证方式为密码认证

        image-20250812223739516

      3. 这里我选择内置数据库

        image-20250812223820357

      4. 配置参数里的账号类型可以选择用户名或者客户端ID,这里我都使用默认选项

        image-20250812223905825

      5. 创建客户端认证规则以后,添加用户

        image-20250812223944742

        image-20250812224018213

      6. 添加成功以后,再次使用客户端工具进行连接测试

        • 未配置账号名和密码,连接失败

          image-20250812224118831

        • 配置账号名和密码后,连接成功

          image-20250812224158224

    10. 参考文档

MIT版权,未经许可禁止任何形式的转载