目录

1. 通过 Yum 源安装（CentOS7 单机安装）

1.1. 通过以下命令配置 EMQX Yum 源：

1.2. 运行以下命令安装 EMQX：

1.3. 运行以下命令启动 EMQX：

1.4. 访问 http://192.168.88.130:18083，默认用户名: admin，密码：public

2. 集群搭建

2.1. 在两台机器上启用以下端口⬇️

2.2. 修改一下配置文件

2.3. 重启 EMQX（让修改后的配置文件生效）

2.4. 加入集群

3. 节点退出集群

---

1. 通过 Yum 源安装（CentOS7 单机安装）

1.1. 通过以下命令配置 EMQX Yum 源：

curl -s https://assets.emqx.com/scripts/install-emqx-rpm.sh | sudo bash

1.2. 运行以下命令安装 EMQX：

sudo yum install emqx -y

1.3. 运行以下命令启动 EMQX：

sudo systemctl start emqx

例：两台机器上执行相同命令进行安装

附：EMQX 重启命令

sudo systemctl restart emqx

附：卸载 EMQX 命令

sudo yum remove emqx

符：关闭 EMQX 命令

sudo systemctl stop emqx

1.4. 访问 http://192.168.88.130:18083，默认用户名: admin，密码：public

2. 集群搭建

2.1. 在两台机器上启用以下端口⬇️

1883 MQTT 协议端口
8883 MQTT/SSL 端口
8083 MQTT/WebSocket 端口
8080 HTTP API 端口
18083 Dashboard 管理控制台端口

a. 启动防火墙

systemctl start firewalld

b. 开启端口

firewall-cmd --zone=public --add-port=1883/tcp --permanent
firewall-cmd --zone=public --add-port=8883/tcp --permanent
firewall-cmd --zone=public --add-port=8083/tcp --permanent
firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --zone=public --add-port=18083/tcp --permanent

2.2. 修改一下配置文件

如果不知道 emqx.conf 文件位置，可以使用以下命令查找

find / -name emqx.conf 2>/dev/null

进入并修改

cd /etc/emqx
vim emqx.conf

另一台

⚠️⚠️注意：

• 配置文件中 cluster.name = emqx，指集群名称，两台节点的 cluster.name 必须一致，并且 node.name 的前缀 xxx@ 也要与 cluster.name相同，否则不能加入集群显示无响应（EMQ-3.1.0 版本官方文档有问题）。
• 192.168.88.130 和 192.168.88.131 均是内网 IP。

2.3. 重启 EMQX（让修改后的配置文件生效）

sudo systemctl restart emqx

2.4. 加入集群

这里是在机器 192.168.88.131 上执行加入机器 192.168.88.130 的集群

emqx_ctl cluster join emqx@192.168.88.130

任意节点查询集群状态

emqx_ctl cluster status

在EMQX Dashboard 可以看到集群概览

3. 节点退出集群

节点退出集群，有两种方式:

• leave: 本节点退出集群
• force-leave: 从集群删除其他节点

例：

emqx@192.168.88.131 主动退出集群:

emqx_ctl cluster leave

emqx@192.168.88.130 节点上，从集群删除emqx@192.168.88.131 节点:

emqx_ctl cluster force-leave emqx@192.168.88.131