# 快速开始

作为全球最具扩展性的 MQTT 消息服务器,EMQX 提供了高效可靠海量物联网设备连接,能够高性能实时移动与处理消息和事件流数据,帮助您快速构建关键业务的物联网平台与应用。

本章节将带您从下载安装开始,带您体验从启动 EMQX 服务,到通过 WebSocket 工具或 MQTT 客户端测试连接并进行消息发布订阅的完整流程。

提示

除了私有部署外,我们也提供了全托管的 EMQX Cloud 服务,您只需几步注册即可轻松体验 EMQX 提供的 MQTT 消息服务,欢迎前往 EMQX Cloud 门户 (opens new window)页面免费试用。

# 版本选择

EMQX 目前提供开源和企业版两个版本,您可根据需要点击下方链接下载对应版本:

# 安装 EMQX

EMQX 支持多种安装方式,比如容器化部署,通过 EMQX Kubernetes Operator 安装部署、或通过安装包的形式部署在物理服务器或虚拟机上,针对安装包部署形式,目前我们支持以下操作系统:

  • RedHat
  • CentOS
  • RockyLinux
  • AmazonLinux
  • Ubuntu
  • Debian
  • MacOS
  • Linux
  • Windows (仅开源版支持)

如您需要 FreeBSD、国产硬件平台以及操作系统适配(如麒麟、深度、红旗等)或其他 Linux 发行版安装包,可参考 源码编译安装联系我们 (opens new window) 获取支持。

此外,您还可通过 EMQX Terraform (opens new window) 在主流公有云上一键部署包含 EMQX Enterprise 集群在内的所有基础设施,如阿里云 (opens new window)亚马逊云科技 (opens new window)

# 快速安装启动

在本篇快速上手中,我们将带您通过容器化部署或解压安装的形式快速体验 EMQX。

接下来我们将通过 Dashboard 自带的 WebSocket 工具进行连接测试。

# 通过 WebSocket 工具快速验证

EMQX 提供了标准的 MQTT 协议包括 MQTT over WebSocket 支持,启动后即可接入 MQTT 客户端,本节我们将演示如何通过 Dashboard 自带的 WebSocket 客户端工具接入 EMQX,从而进行消息通信验证。

在 Dashboard 页面,点击左侧导航栏的 问题分析 -> WebSocket 客户端,即可进入相关页面。您可按照如下步骤完成客户端与 EMQX 的连接、订阅相关主题,并测试消息的发送与接收情况。

  1. 连接客户端与 EMQX。点击页面右侧的连接按钮,系统将提示当前客户端已成功连接。
  2. 订阅相关主题。点击页面中部的订阅按钮,此时我们将订阅 testtopic/#主题下所有 QoS 为 0 的消息,您可以根据需要增加多个主题或测试其他 QoS 等级。
  3. 测试消息的接收。点击页面底部的发布按钮,此时可以看到页面底部的已发送和已接收窗格各出现了一条消息,证明连接已成成功。

EMQX MQTT WebSocket 连接

  1. 此时我们通过点击左侧导航栏的仪表盘返回主界面,在概览页,可以看到当前的连接数,主题数、以及订阅数,节点信息,以及实时的消息发送及接收情况。

如您希望进行更复杂的测试,比如单/双向 SSL 认证、通过自定义脚本模拟测试数据等,也可通过 MQTTX 桌面客户端 (opens new window)进行更多测试。

# 进阶操作

至此,我们已经完成基本的 EMQX 安装、启动和接入测试,您还可以继续进行 访问控制集成第三方数据系统 等操作。

# 常见问题解答

您可以访问 EMQ 问答社区 (opens new window) 参与交流,提出、解答 EMQX 以及 EMQ 相关产品使用问题,与 EMQX 用户交流物联网相关技术的使用经验,此外也欢迎随时 联系我们 (opens new window) 获取专业技术支持。