快速开始

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

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

TIP

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

安装 EMQX

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

• RedHat
• CentOS
• RockyLinux
• AmazonLinux
• Ubuntu
• Debian
• macOS
• Linux

如您需要 FreeBSD、国产硬件平台以及操作系统适配（如麒麟、深度、红旗等）或其他 Linux 发行版安装包，可 联系我们 获取支持。

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

快速安装启动

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

• 通过 Docker 容器运行
• 通过 zip/tar.gz 压缩包快速安装

容器化部署是体验 EMQX 的最快方式，因此本节将以容器化部署为例，带您开始完整的 EMQX 使用旅程。

1. 在命令行工具中输入如下命令，下载并运行最新版 EMQX。

   运行此命令前，请确保 Docker 已安装且已启动。

   docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx-enterprise:latest

2. 通过浏览器访问 http://localhost:18083/（localhost 可替换为您的实际 IP 地址）以访问 EMQX Dashboard 管理控制台，进行设备连接与相关指标监控管理。

​ 默认用户名及密码：

​ admin

​ public

您也可以选择通过 zip/tar.gz 压缩包的形式在本地进行安装部署，方便后续进行配置调整以及性能调优。本节我们将以 macOS (macOS12 amd64) 为例演示如何下载并安装 EMQX。

由于手动安装过程中涉及比较多的依赖项目，因此推荐在测试或热升级环境中采用安装包方式，不建议在生产环境中使用。

1. 在命令行工具中输入如下命令，下载 zip 文件。

   wget https://www.emqx.com/en/downloads/enterprise/5.0.0/emqx-enterprise-5.0.0-macos12-amd64.zip

2. 通过以下命令安装 EMQX。

   mkdir -p emqx && unzip emqx-enterprise-5.0.0-macos12-amd64.zip -d emqx

3. 运行以下命令启动 EMQX。

   ./emqx/bin/emqx start

4. 现在您可通过浏览器访问 http://localhost:18083/（localhost 可替换为您的实际 IP 地址）以访问 EMQX Dashboard 管理控制台，进行设备连接与相关指标监控管理。

   默认用户名及密码：

   admin

   public

5. 运行以下命令停止 EMQX。

   ./emqx/bin/emqx stop

后续如需卸载 EMQX，您可直接删除 EMQX 目录即可完成卸载。

通过 MQTTX 快速验证

MQTTX 是 EMQX 开源的一款跨平台 MQTT 5.0 客户端工具，它支持 macOS、Linux、Windows，并且支持自定义脚本模拟测试、MQTT 消息格式转换、日志记录等多个功能。您可通过 MQTTX 一键式的连接方式和图形界面，您可轻松测试 MQTT/TCP、MQTT/TLS、MQTT/WebSocket 连接。

本节讲介绍如何通过 MQTTX Web 端 快速验证 MQTT 连接，无需下载或安装任何程序。

前置准备

测试连接之前，应首先获取：

• 服务器地址：通常是您的服务器 IP 地址；
• 端口信息：可在 EMQX Dashboard 功能配置的监听器部分获取。

1. 访问 MQTTX Web 页面。

2. 配置并建立 MQTT 连接。点击 + 新建连接 进入配置页面，您只需配置：

   • 名称：连接名称，如 MQTTX_Test；

   • 服务器地址

     • 通过选择该连接的协议类型，如 WebSockets 协议，ws://；目前 MQTTX Web 端仅支持 WebSocket 协议，如希望测试 SSL/TLS 认证连接，请下载 MQTT 客户端；
     • 填入之前获取的 EMQX 地址，如 emqx@127.0.0.1

   • 端口：如 WebSockets 协议对应的 8083 端口

     其他项目保持默认配置，你也可以根据具体业务场景修改。有关页面字段的配置说明，可参考 MQTT 手册 - 快速建立连接。

   配置完成后，点击页面右上角的连接按钮建立连接。

3. 订阅相关主题。连接成功后即可快速订阅多个主题。点击页面中部的添加订阅按钮，按照默认配置，我们将订阅匹配 testtopic/# 主题的所有消息，QoS 等级为 0。您可多次重复该项操作以订阅不同主题，MQTTX Web 会通过不同颜色区分各主题。

4. 测试消息的发送与接收。点击页面右下角聊天区域的发送按钮，可以在上方的聊天窗口中看到消息已成功发送。

除上述测试外，您也可以通过 MQTTX 进行单/双向 SSL 认证、或通过自定义脚本模拟测试数据。更多消息，可访问 MQTTX 官方网页。

回到 EMQX Dashboard 的仪表盘部分，可以看到连接数、主题数、和订阅数部分数据的变化，在下方的可视化窗格，还可以看到这段时间流入的消息数量曲线。

进阶操作

至此，我们已经完成基本的 EMQX 安装、启动和接入测试，您还可以继续进行 访问控制、规则引擎数据处理 等操作。

更多主题

本章节还包含了 EMQX 5.x 版本引入的全新功能介绍和已知的使用限制，可点击下方链接继续阅读。

• 使用限制

常见问题解答

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