消息队列 / 系统课时
创建 RabbitMQ 集群
创建 RabbitMQ 集群
这一课用三台 Linux 主机完成一个 RabbitMQ 4.3 集群:先检查节点名与网络,再统一节点间认证所需的 Erlang Cookie,让两个节点加入种子节点,最后用集群状态验证三台机器已经形成同一集群。
学习目标
- 完成三节点 RabbitMQ 集群的手工组建
- 正确统一 Erlang Cookie、主机名解析和节点间通信条件
- 用
cluster_status验证成员关系并定位常见加入失败
先完成节点前置检查
示例使用 rabbit1、rabbit2、rabbit3 三台新节点,默认节点名分别为 rabbit@rabbit1、rabbit@rabbit2、rabbit@rabbit3。三台机器必须能互相解析主机名,并允许节点间访问 TCP 4369 与 25672;若使用自定义分布式端口,则以实际配置为准。
先在每台机器重复执行下面的检查。示例输出以 rabbit1 为例,<IP> 会因环境不同而变化。
hostname -s
getent hosts rabbit1 rabbit2 rabbit3
sudo -u rabbitmq rabbitmq-diagnostics -q ping预期输出
rabbit1
<IP> rabbit1
<IP> rabbit2
<IP> rabbit3
Ping succeeded统一 Erlang Cookie
RabbitMQ 节点通过 Erlang Cookie 互相认证。Linux 服务常用的 Cookie 文件是 /var/lib/rabbitmq/.erlang.cookie,三个节点必须使用完全相同的内容,并保证文件只允许 RabbitMQ 服务账号读取。
下面假设自动化系统已经把同一份 Cookie 安全地放到每台机器的 <PATH>/erlang.cookie。实际路径不同,生产环境应通过 Secret 管理或配置管理系统分发,不要把 Cookie 明文写进命令历史。
sudo systemctl stop rabbitmq-server
sudo install -o rabbitmq -g rabbitmq -m 600 <PATH>/erlang.cookie /var/lib/rabbitmq/.erlang.cookie
sudo systemctl start rabbitmq-server
sudo systemctl is-active rabbitmq-server
sudo sha256sum /var/lib/rabbitmq/.erlang.cookie预期输出
active
<HASH> /var/lib/rabbitmq/.erlang.cookie三台节点显示的 <HASH> 必须相同。实际哈希值会随 Cookie 内容变化;如果不同,不要继续执行加入操作。

让两个节点加入种子节点
RabbitMQ 4.3 手工建群时,不再需要先执行旧教程里的 stop_app、reset、start_app 组合;join_cluster 会完成加入前所需的准备。先在 rabbit2 执行加入,再在 rabbit3 执行相同操作。
# 在 rabbit2 上执行
sudo -u rabbitmq rabbitmqctl join_cluster rabbit@rabbit1
# 在 rabbit3 上执行
sudo -u rabbitmq rabbitmqctl join_cluster rabbit@rabbit1预期输出
Clustering node rabbit@rabbit2 with [rabbit@rabbit1] ...done.
Clustering node rabbit@rabbit3 with [rabbit@rabbit1] ...done.种子节点只是提供一个已在线的集群成员地址。第二个节点也可以通过任何已经加入且在线的成员找到整个集群,因此 rabbit1 不是永久主节点。
验证三节点已经组成同一集群
在任意一个成员上执行下面的命令。重点检查成员列表和 Running Nodes 都出现三个节点。
sudo -u rabbitmq rabbitmqctl cluster_status预期输出
Disk Nodes
rabbit@rabbit1
rabbit@rabbit2
rabbit@rabbit3
Running Nodes
rabbit@rabbit1
rabbit@rabbit2
rabbit@rabbit3如果三个节点都同时出现在这两部分,说明集群成员关系已经建立并且当前都在线。实际输出还可能包含 RabbitMQ、Erlang 版本、CPU、维护状态和监听器等信息。
加入失败按顺序排查
遇到 Invalid challenge reply、Erlang distribution failed 或无法联系目标节点时,不要反复重置节点。先检查节点名能否互相解析,再确认 4369 与 25672 没有被防火墙阻断,最后比较三台机器的 Cookie 文件是否一致、属主和权限是否正确。
如果主机使用 FQDN,所有节点与 CLI 都必须一致使用长节点名配置;短名和长名混用会导致看似网络正常但节点身份不匹配。生产环境还应优先采用 DNS、Kubernetes、Consul、etcd 等自动发现方式建群,手工 join_cluster 更适合实验、测试和特定恢复场景。