mqtt服务器集群搭建，开源mqtt服务器搭建

一、安装预置条件

EMQ X 跨平台运行于Linux、FreeBSD、MacOS、Windows Server，甚至Raspberry Pi。

服务器最低配置为512MB 内存和至少1GB 硬盘空间。

二、二进制包安装

EMQ 官方网站提供流行Linux 发行版、MacOS、Windows 操作系统和Docker 镜像的二进制包下载。请查看官网下载页面了解当前支持的操作系统和平台。

三、源码编译安装

对于某些官网没有提供二进制包的操作系统和平台，例如Linux ARM、FreeBSB，可以使用源码编译安装。

EMQ

EMQ X 3.0+ 依赖于Erlang R21+ 版本。

EMQ X Enterprise 暂不提供源码编译和安装。如果您有任何特殊的操作需求，请联系我们：contact@emqx.io。

四、首次安装 EMQ X

在安装EMQ X 之前，请确保满足安装先决条件。

版本选择

EMQ X 支持多种操作系统。请选择合适的版本进行下载。

1、在 Linux 下安装

对于Linux 发行版，EMQ X 提供两种安装方法。一种是基于各种Linux发布的安装包。使用安装包安装EMQ X 后，您可以使用系统管理工具轻松启动和停止EMQ X 服务。第二种是使用zip 压缩打包的通用包。要安装zip 包，只需解压缩zip 文件即可。您可以使用zip 包在同一系统上安装多个EMQ X 集。在开发/实验室环境中，使用zip 包安装EMQ X 非常实用。

CentOS/RHEL

目前EMQ X 支持CentOS/RHEL 6 和7，两个版本的安装过程相同。以下安装过程以CentOS 7为例。

解压缩

使用 zip 包安装

zip 文件。

解压emqx-centos7-v3.0.zip。在控制台调试模式下启动emqx，检查EMQ X 是否能够成功启动。

cd emqx ./bin/emqx console 如果安装成功，您将在控制台看到以下输出：

在节点’emqx@127.0.0.1′ 上启动emqx emqx ctl 启动.[ok]emqx hook 启动.[ok]emqx router 启动.[ok]emqx pubsub 启动.[ok]]emqx 统计正在启动.[ok]emqx 指标正在启动.[ok]emqx 池化器正在启动.[ok]emqx 跟踪正在启动.[ok]emqx 客户端管理器正在启动.[ok]emqx 会话管理器正在启动.[ok]emqx 会话主管正在启动.[ok]emqx wsclient 主管正在启动.[ok]emqx 代理正在启动.[ok]emqx 警报正在启动。[ok]emqx mod Supervisor 正在启动.[ok]emqx 网桥Supervisor 正在启动.[ok]emqx 访问控制正在启动.[ok]emqx 系统监视器正在启动.[ok]dashboard:http 正在监听0.0 .0.0:18083 有两个受体。 mqtt:tcp 用8 个接受器监听0.0.0.0:1883。 mqtt:ssl 用4 个接受器监听0.0.0.0:8883。使用mqtt:ws 收听。 3608083 有4 个受体。 Erlang MQTT Broker 3.0 正在运行CTRL+C 关闭控制塔。启动守护进程模式：

在CentOS 上使用./bin/emqx start

使用 rpm 包安装

rpm 工具安装EMQ X。

rpm -ivh emqx-centos7-v3.0-beta.4.rpm 安装完成后，EMQ X 配置、日志和数据文件位于以下目录中： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*.conf 日志文件：/var/log/emqx 数据文件：/var/lib/emqx/

通过命令行启动和停止EMQ X。

systemctl start|stop|restart emqx.service

Ubuntu

EMQ X 目前支持Ubuntu 12.04、14.04、16.04、18.04，各版本的安装流程一致。以下安装过程以Ubuntu 18.04为例。

解压缩

使用 zip 包安装

zip 文件。

解压emqx-ubuntu18.04-v3.0.zip。在控制台调试模式下启动emqx，检查EMQ X 是否能够成功启动。

cd emqx ./bin/emqx console 如果安装成功，您将在控制台看到以下输出：

在节点’emqx@127.0.0.1′ 上启动emqx emqx ctl 启动.[ok]emqx hook 启动.[ok]emqx router 启动.[ok]emqx pubsub 启动.[ok]]emqx 统计正在启动.[ok]emqx 指标正在启动.[ok]emqx 池化器正在启动.[ok]emqx 跟踪正在启动.[ok]emqx 客户端管理器正在启动.[ok]emqx 会话管理器正在启动.[ok]emqx 会话主管正在启动.[ok]emqx wsclient 主管正在启动.[ok]emqx 代理正在启动.[ok]emqx 警报正在启动。[ok]emqx mod Supervisor 正在启动.[ok]emqx 网桥Supervisor 正在启动.[ok]emqx 访问控制正在启动.[ok]emqx 系统监视器正在启动.[ok]dashboard:http 正在监听0.0 .0.0:18083 有两个受体。 mqtt:tcp 用8 个接受器监听0.0.0.0:1883。 mqtt:ssl 用4 个接受器监听0.0.0.0:8883。使用mqtt:ws 收听。 3608083 有4 个受体。 Erlang MQTT Broker 3.0 正在运行CTRL+C 关闭控制塔。启动守护进程模式：

./bin/emqx start

使用 deb 包安装

sudo dpkg -i emqx-ubuntu18.04-v3.0_amd64.deb 安装后，EMQ X 配置、日志和数据文件位于以下目录中： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*.conf 日志文件：/var/log/emqx 数据文件：/var/lib/emqx/

通过命令行启动和停止EMQ X。

service emqx start|stop|restart

Debian

EMQ X 目前支持Debian 7、8、9，各版本的安装流程一致。以下安装过程以Debian 9为例。

解压缩

使用 zip 包安装

zip 文件。

解压emqx-debian9-v3.0.zip。在控制台调试模式下启动emqx，检查EMQ X 是否能够成功启动。

cd emqx ./bin/emqx console 如果安装成功，您将在控制台看到以下输出：

在节点’emqx@127.0.0.1′ 上启动emqx emqx ctl 启动.[ok]emqx hook 启动.[ok]emqx router 启动.[ok]emqx pubsub 启动.[ok]]emqx 统计正在启动.[ok]emqx 指标正在启动.[ok]emqx 池化器正在启动.[ok]emqx 跟踪正在启动.[ok]emqx 客户端管理器正在启动.[ok]emqx 会话管理器正在启动.[ok]emqx 会话主管正在启动.[ok]emqx wsclient 主管正在启动.[ok]emqx 代理正在启动.[ok]emqx 警报正在启动。[ok]emqx mod Supervisor 正在启动.[ok]emqx 网桥Supervisor 正在启动.[ok]emqx 访问控制正在启动.[ok]emqx 系统监视器正在启动.[ok]dashboard:http 正在监听0.0 .0.0:18083 有两个受体。 mqtt:tcp 用8 个接受器监听0.0.0.0:1883。 mqtt:ssl 用4 个接受器监听0.0.0.0:8883。使用mqtt:ws 收听。 3608083 有4 个受体。 Erlang MQTT Broker 3.0 正在运行CTRL+C 关闭控制塔。启动守护进程模式：

./bin/emqx start

使用 deb 包安装

sudo dpkg -i emqx-debian9-v3.0_amd64.deb 安装后，EMQ X 配置、日志和数据文件位于以下目录中： 系统配置文件：/etc/emqx/emqx.conf 插件配置文件：/etc/emqx/plugins/*.conf 日志文件：/var/log/emqx 数据文件：/var/lib/emqx/

通过命令行启动和停止EMQ X。

service emqx start|stop|restart

2、在 MacOS 下安装

目前，EMQ X 在MacOS 上提供zip 包安装方式。解压缩zip 文件。

解压emqx-macos-v3.0.zip。在控制台调试模式下启动emqx，检查EMQ X 是否能够成功启动。

cd emqx ./bin/emqx console 如果安装成功，您将在控制台看到以下输出：

在节点’emqx@127.0.0.1′ 上启动emqx emqx ctl 启动.[ok]emqx hook 启动.[ok]emqx router 启动.[ok]emqx pubsub 启动.[ok]]emqx 统计正在启动.[ok]emqx 指标正在启动.[ok]emqx 池化器正在启动.[ok]emqx 跟踪正在启动.[ok]emqx 客户端管理器正在启动.[ok]emqx 会话管理器正在启动.[ok]emqx 会话主管正在启动.[ok]emqx wsclient 主管正在启动.[ok]emqx 代理正在启动.[ok]emqx 警报正在启动。[ok]emqx mod Supervisor 正在启动.[ok]emqx 网桥Supervisor 正在启动.[ok]emqx 访问控制正在启动.[ok]emqx 系统监视器正在启动.[ok]dashboard:http 正在监听0.0 .0.0:18083 有两个受体。 mqtt:tcp 用8 个接受器监听0.0.0.0:1883。 mqtt:ssl 用4 个接受器监听0.0.0.0:8883。使用mqtt:ws 收听。 3608083 有4 个受体。 Erlang MQTT Broker 3.0 正在运行CTRL+C 关闭控制塔。启动守护进程模式：

./bin/emqx start

3、在 Microsoft Windows 下安装

目前EMQ X 在Windows 上提供zip 包安装。下载并解压程序包后，打开Windows命令行窗口并导航到程序目录。

控制台模式启动：

bin\emqx console

4、在 Docker 中安装

解压emqx docker 镜像包。

解压emqx-docker-v3.0.zip 并加载镜像。

docker load emqx-docker-v3.0 启动容器。

docker run -tid –name emq30 -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 停止emqx-docker-v3.0 容器。

docker stop emq30 启动容器。

运行docker start emq30 进入Docker 控制台。

docker exec -it emq30 /bin/sh

5、使用源代码安装

EMQ

本文中的以下步骤适用于Linux 环境。

注： EMQ b win30 https://github.com/emqx/emqx-rel.gitcd emqx-relx makecd _rel/emqx ./bin/emqx console 如果编译成功，包发布目录为：

_rel/emqx 从控制台启动程序。

复制代码cd _rel/emqx ./bin/emqx console

五、首次运行 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 中创建一些简单的配置，以适应您的操作环境和需求。

对 EMQ X 进行简单的配置

EMQ X 的所有配置都可以通过修改配置文件来完成。配置文件位置：

etc/emqx.conf : EMQ X 服务器参数设置etc/plugins/*.conf : EMQ X 插件配置文件。每个插件都有一个单独的配置文件。 Web 仪表板中一些常见功能的设置也发生了更改。

更改 Dashboard 界面语言

在Web 界面中选择管理> 设置菜单。您可以通过单击“应用”来更改仪表板上使用的语言。目前EMQ X 支持中文和英文。

修改 Dashboard 默认登录名和密码

Dashboard 插件为EMQ 提供管理和控制功能安装后，您可以通过编辑配置文件来更改Dashboard 的默认用户名和密码。设置文件：

修改etc/plugins/emqx_dashboard.conf中以下两行，将等号右边的值修改为您想要的值。

Dashboard.default_user.login=admindashboard.default_user.password=public 通过公共或网络管理仪表板用户。管理员- 用户菜单允许您更改用户密码以及添加/删除用户。管理员用户只能更改密码而不能删除密码。

配置端口

安装后，EMQ X 默认使用以下端口：

1883: MQTT 协议端口8883: MQTT/SSL 端口8083: MQTT/WebSocket 端口8080: HTTP API 端口18083: 仪表板管理控制台端口您可以根据安装的需要更改上述端口。要更改协议端口，请编辑EMQ

Listener.tcp.external=0.0.0.0:1883listener.ssl.external=8883listener.ws.external=8083 如需更改HTTP API 端口，请编辑emqx_management 插件的配置文件’etc/plugins/emqx_management.conf’。找到以下行并按“您需要更改端口号”。

Management.listener.http=8080 如需更改仪表板管理控制台端口，请编辑emqx_dashboard 插件的配置文件“etc/plugins/emqx_dashboard.conf”，找到以下行并根据需要更改端口号：请更改。

Dashboard.listener.http=18083 您可以在Web 仪表板的管理> 侦听器菜单中查看当前使用的侦听器端口和属性。

启动 / 停止插件

插件是EMQ X 的重要组成部分。 EMQ X 扩展主要通过插件来实现。 Dashbard 也是一个插件实现。您可以使用软件附带的命令行工具emqx_ctl 启动和停止各个插件。

启动插件：

bin/emqx_ctl 插件加载plugin_name 并停止插件。

bin/emqx_ctl plugins unload plugin_name 您还可以在仪表板的管理- 插件菜单中启动和停止插件以及对插件进行简单的配置。

EMQ 仪表板

修改 Erlang 虚拟机启动参数

EMQ X 运行在Erlang 虚拟机上。 “etc/emqx.conf”中有两个限制，限制了虚拟机允许的最大连接数。这两个参数可以在运行EMQ X 之前更改，以适应您的连接要求。

node.process_limit : Erlang 虚拟机EMQ X 允许的最大进程数。一个连接消耗两个Erlang 进程。 node.max_ports : Erlang 虚拟机、EMQ 允许的最大端口数。端口的概念是TCP端口，但可以宽松地理解为文件句柄。 *这两个参数可以设置如下：

node.process_limit：大于允许的最大连接数* 2node.max_ports：大于允许的最大连接数