文章目录
- 1. EMQ X
- EMQ X与emqttd的关系
- EMQ X支持的协议
- EMQ X支持的部署平台
- 2. 使用zip压缩包部署
- 获取zip包下载链接
- 下载软件包
- 解压zip包
- 启动EMQ X
- 3. 使用docker部署
- 安装docker
- 获取docker镜像
- 启动 docker 容器
- 停止docker服务
- 4. 访问DashBoard并进行简单设置
- 访问DashBoard
- 语言和主题设置
- 用户设置
1. EMQ X
EMQ X与emqttd的关系
EMQ X全称Erlang/Enterprise/Elastic MQTT Broker，它是基于Erlang/OTP语言平台开发，支持大规模连接和分布式集群，发布订阅模式的百万级开源MQTT消息服务器。
说起EMQ-X，其它的前身就是emqttd消息服务器，自emqttd 3.0 版本起更名为EMQ-X。
EMQ X支持的协议
EMQ X 消息服务器完整支持 MQTT V3.1/V3.1.1/V5.0 版本协议规范，并扩展支持 MQTT-SN 、WebSocket、CoAP、LwM2M、Stomp 以及私有 TCP/UDP 协议。
其中，MQTT-SN、CoAP 协议已在2.0-rc.1版本发布，LwM2M、LoRaWan 协议在 3.0 版本中发布。
EMQ X支持的部署平台
EMQ X 的每个版本都提供如下平台的软件包：
- Linux：CentOS、Ubuntu、Debian、FreeBSD、OpenSUSE
- MacOS
- Windows
部署时直接在官方下载链接下载zip压缩包，解压后直接运行即可。
另外，EMQ X 还提供Docker镜像，可以在Docker中直接部署。
关于各个平台的部署方法，可以参考官方部署文档，本文中只讲述如何在Linux服务器上使用zip方式部署和使用docker方式部署，本文所使用的是腾讯云服务器，配置1核2G，系统是Ubuntu 18.04 64位。
2. 使用zip压缩包部署
使用v3.1.0版本，其它高版本测试有问题！
获取zip包下载链接
访问官方下载链接，选择需要下载的版本和系统，之后复制下载链接：
下载软件包
登录云服务器，使用wget工具下载：
wget <刚刚复制的下载链接>比如这里我的下载命令是：
wget https://www.emqx.io/downloads/broker/v3.1.0/emqx-ubuntu18.04-v3.1.0.zip
解压zip包
zip包需要使用unzip工具解压，使用如下命令查询unzip是否安装：
unzip -v我的电脑上已安装，所以查询结果如图：
如果没有查询到，请使用如下命令安装：
sudo apt-get install unzip确保已经安装unzip之后，解压刚刚下载的压缩包：
unzip e<按一下Tab自动补全>
启动EMQ X
进入解压出的文件夹：
cd emqx然后使用如下命令启动emqx：
sudo ./bin/emqx start启动成功之后如图：
查询一下emqx的状态，检查一下是否真正成功启动：
sudo ./bin/emqx_ctl status
特别注意：如果云服务器默认有安全组配置（阿里云），或者开启了宝塔面板，一定要记得放行如下TCP端口。
EMQ X 消息服务器默认占用的 TCP 端口包括:
| 端口 | 说明 |
|---|---|
| 1883 | MQTT 协议端口 |
| 8883 | MQTT/SSL 端口 |
| 8083 | MQTT/WebSocket 端口 |
| 8080 | HTTP API 端口 |
| 18083 | Dashboard 管理控制台端口 |
接下来可以跳至第4节，登录后面控制面板。
3. 使用docker部署
安装docker
参考我的博客：Docker-ce最新版在Ubuntu18.04上的安装、更新、卸载方法（存储库方式）。
获取docker镜像
通过 Docker Hub 获取docker镜像：
sudo docker pull emqx/emqx:v3.0.1
- 1
启动 docker 容器
使用如下命令启动docker容器：
sudo docker run -d --name emqx31 -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx:v3.0.1启动之后如图：
启动之后查看docker进程，检查一下是否运行：
sudo docker ps特别注意：如果云服务器默认有安全组配置（阿里云），或者开启了宝塔面板，一定要记得放行如下TCP端口。
EMQ X 消息服务器默认占用的 TCP 端口包括:
| 端口 | 说明 |
|---|---|
| 1883 | MQTT 协议端口 |
| 8883 | MQTT/SSL 端口 |
| 8083 | MQTT/WebSocket 端口 |
| 8080 | HTTP API 端口 |
| 18083 | Dashboard 管理控制台端口 |
停止docker服务
如果不需要使用EMQ-X，使用如下命令停止docker服务：
sudo docker stop <查看到的进程号>如图：
4. 访问DashBoard并进行简单设置
访问DashBoard
访问http://<服务器ip地址或域名>:18083即可访问到EMQ-X的后台登录界面，使用用户名admin和密码public登录：
登陆成功之后，后台界面如图：
语言和主题设置
默认是英文和dark-themes，可以在setting界面进行更改：
中文界面如下：
用户设置
刚刚登录面板使用的是默认用户名和密码，安全起见，可以在user界面修改：
