服务注册与分布式协调 / 系统课时

选举端口与通信端口

选举端口与通信端口

ZooKeeper 集群里常见的 2181、2888、3888 分别服务于客户端访问、集群数据协同和 Leader 选举。把三类流量混在一起会直接影响防火墙、服务暴露和故障定位,因此部署前应先明确每个端口的通信对象与方向。

学习目标

  • 区分客户端端口、Quorum 通信端口和 Leader 选举端口的职责。
  • 能从 server.X 配置中读出每个成员的节点间通信地址。
  • 能结合节点角色和连接状态判断端口是否正常,而不是只看端口号是否存在。

三类端口分别承载什么

默认端口只是常见约定,实际值可以修改;判断职责时应以当前 zoo.cfg 为准。

类型 常见端口 配置位置 主要通信双方 主要用途
客户端端口 2181 clientPort 客户端 ↔ ZooKeeper 节点 会话、读写、Watch 等客户端请求
Quorum 通信端口 2888 server.X 第一个端口 Leader ↔ Follower/Observer 成员同步、事务提议与确认等集群内部通信
Leader 选举端口 3888 server.X 第二个端口 ZooKeeper 节点 ↔ ZooKeeper 节点 启动、Leader 故障或重新选举时交换选票

ZooKeeper 三类端口的数据流向

2181 与另外两个端口的最大区别是通信参与者不同:2181 面向应用客户端;2888 与 3888 属于集群内部协议。生产环境通常不应把 2888、3888 暴露给业务客户端或公网。

读懂 server.X 的两个端口

典型三节点配置如下:

properties
clientPort=2181

server.1=zk1.example.internal:2888:3888
server.2=zk2.example.internal:2888:3888
server.3=zk3.example.internal:2888:3888

以 server.2 为例,2 必须对应 zk2 数据目录中的 myid=2;2888 是该成员参与 Quorum 通信时使用的端口,3888 是该成员参与 Leader 选举时使用的端口。三个节点可以使用相同端口号,因为它们监听在不同主机上。

clientPort=2181 不属于 server.X 的两个端口。它描述的是当前 ZooKeeper 进程接受客户端连接的入口,因此每台节点通常都会有自己的客户端端口。

用角色与连接状态验证端口

先确认当前节点角色,再观察监听端口和已建立连接。Linux 主机可以使用:

bash
"$ZOOKEEPER_HOME/bin/zkServer.sh" status
ss -lntp | grep -E ':(2181|2888|3888)\b'
ss -ntp | grep -E ':(2888|3888)\b'

预期结果不是“每台机器必须同时监听三个端口”。常见情况下,每个参与者节点会提供客户端端口并参与 3888 选举通信;当前 Leader 会接受其他成员到其 Quorum 端口的连接,而 Follower 可能表现为到 Leader 的 2888 出站已建立连接。关键结果可概括为:

text
Mode: leader|follower
LISTEN ... :2181
LISTEN/ESTAB ... :2888
LISTEN/ESTAB ... :3888

实际进程名、地址、IPv4/IPv6 表示和连接方向可能不同。排障时应结合 Mode、监听状态和 ESTAB 连接判断,不要因为某个 Follower 没有以预期形式监听 2888 就直接认定集群故障。

按流量边界配置网络策略

客户端网络只需要到 ZooKeeper 节点的客户端端口;ZooKeeper 节点之间则必须保证 Quorum 端口和选举端口可达。若启用了防火墙或安全组,可按下面的最小思路划分:

  • 业务客户端 → ZooKeeper:允许 2181,或允许你实际配置的客户端端口。
  • ZooKeeper 节点 ↔ ZooKeeper 节点:允许 2888 和 3888,或 server.X 中实际配置的两个端口。
  • 公网或无关业务网段 → 2888/3888:拒绝。

端口可达但集群仍无法选主时,还要检查 server.X 中的主机名是否能从所有节点解析到正确地址。端口职责分清后,故障定位也会更直接:客户端连接失败先看 2181,Follower 无法同步重点看 2888,节点反复选举则重点检查 3888 及节点间网络。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选举端口与通信端口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通