目录
快速开始
准备
下载及安装
第一次安装EMQ X
版本选择
EMQ X 支持多种操作系统，请选择合适您的版本下载。下载地址：https://www.emqx.io/cn/downloads#broker
在 Microsoft Windows 下安装
目前 EMQ X 在 Windows 下提供 zip 包安装。程序包下载解压后，打开 Windows 命令行窗口，cd 到程序目录（如图1和图2所示）。
控制台模式启动:
binemqx console
图1
图2
在其他电脑系统上的操作使用说明
请查看官方文档：https://docs.emqx.io/tutorial/latest/cn/quick_start/install_first.html
第一次运行EMQ X
在安装以后您可以直接运行 EMQ X 来获得最初步的经验。除了在控制台，您也可以通过浏览器访问 http://127.0.0.1:18083 来使用 EMQ X 的 Web 管理控制界面。
默认的登录名是 admin 和密码是 public。
通过浏览器访问 http://127.0.0.1:18083，您将看到一个 EMQ X 登录界面：
在输入用户名和密码后，您就可以使用 EMQ X Dashboard 的各项功能。在首次登入后，您看到的将是 EMQ X 控制台的信息汇总。这个页面显示了系统信息，节点信息，运行统计和一些统计指标。
所有对 EMQ X 的配置都可以通过修改配置文件完成。配置文件的位置：
- etc/emqx.conf : EMQ X 服务器的参数设置
- etc/plugins/*.conf : EMQ X 插件配置文件，每个插件都有单独的配置文件。
一些常用功能的配置也在 Web Dashboard 上进行修改。
更改语言：
在 Web 界面上选择 ADMIN -> Settings 菜单，您可以改变 Dashboard 使用的语言，点击 Apply 后生效。目前 EMQ X 支持中文和英文。
如上图所示是已经更改过的中文语言。
配置端口：
在安装以后，EMQ X 默认会使用以下端口：
- 1883: MQTT 协议端口
- 8883: MQTT/SSL 端口
- 8083: MQTT/WebSocket 端口
- 8080: HTTP API 端口
- 18083: Dashboard 管理控制台端口
按照安装环境需要，可以修改以上端口。
修改协议端口请编辑 EMQ X 系统配置文件'etc/emqx.conf'，找到以下各行，并按需要修改端口号。
其他详情配置
请参考：首次运行 EMQ X：https://docs.emqx.io/tutorial/latest/cn/quick_start/run_first.html
客户端代码
通过前面的步骤读者已经了解了如何安装和运行 EMQ X 的相关产品，接下来开始介绍如何开发简单的 MQTT 客户端应用程序，包括了如下的内容，
- 安装所需的库文件
- 建立 MQTT 连接
- 订阅和发布消息
- 完整的应用程序示例
这里提供了 Java、Python 和 JavaScript 三种语言的实现，读者可以根据自己熟悉的编程语言分别挑选相关的章节进行阅读。
使用 Java 开发 MQTT 客户端：https://docs.emqx.io/tutorial/latest/cn/client_dev/java.html
使用 Python 开发 MQTT 客户端：https://docs.emqx.io/tutorial/latest/cn/client_dev/python.html
使用 JavaScript 开发 MQTT 客户端：https://docs.emqx.io/tutorial/latest/cn/client_dev/javascript.html