服务注册与分布式协调 / 系统课时
三节点集群搭建
三节点集群搭建
三节点 ZooKeeper 集群的关键不是“启动三个进程”,而是让三个节点使用完全一致的成员列表,并通过各自的 myid 建立唯一身份。完成后应能看到一个 Leader、两个 Follower,并能从任意存活节点读到同一份数据。
学习目标
- 配置三节点共同使用的
server.X成员列表和本地数据目录。 - 正确创建
myid,理解它与server.X编号的对应关系。 - 启动集群并用角色状态与跨节点读写验证部署结果。
规划节点与成员身份
下面使用三个独立主机名作为示例。生产环境应让它们落在不同故障域,至少不要把三个 ZooKeeper 进程都放在同一台物理机上,否则“三节点”并不能真正提高可用性。
| 节点 | myid |
客户端端口 | Quorum 通信端口 | Leader 选举端口 |
|---|---|---|---|---|
zk1.example.internal |
1 | 2181 | 2888 | 3888 |
zk2.example.internal |
2 | 2181 | 2888 | 3888 |
zk3.example.internal |
3 | 2181 | 2888 | 3888 |
三节点集群需要至少两个节点组成多数派才能继续对外提供一致性服务,因此最多容忍一个节点同时失效。三个节点之间必须能互相解析主机名并访问节点间通信端口。

编写统一的集群配置
三个节点的 zoo.cfg 应使用同一份成员列表。下面假设 ZooKeeper 的数据目录为 /var/lib/zookeeper;如果安装路径不同,只需保持每台机器上的 dataDir 与实际目录一致。
tickTime=2000
initLimit=10
syncLimit=5
dataDir=/var/lib/zookeeper
clientPort=2181
server.1=zk1.example.internal:2888:3888
server.2=zk2.example.internal:2888:3888
server.3=zk3.example.internal:2888:3888server.X 中的 X 是服务器 ID,必须与该节点数据目录中的 myid 完全一致。冒号后的第一个端口用于集群成员之间的 Quorum 通信,第二个端口用于 Leader 选举;客户端连接仍使用 clientPort。
在每台主机创建数据目录,并写入该主机对应的 ID。以 zk1 为例:
sudo install -d -m 0755 /var/lib/zookeeper
printf '1\n' | sudo tee /var/lib/zookeeper/myid
cat /var/lib/zookeeper/myid预期输出:
1在 zk2 和 zk3 上分别写入 2 与 3。myid 只包含数字 ID,不要写主机名,也不要让两个节点使用同一个 ID。
启动并确认 Leader 与 Follower
在三台主机上分别启动 ZooKeeper。以下假设环境变量 ZOOKEEPER_HOME 已指向 ZooKeeper 安装目录。
"$ZOOKEEPER_HOME/bin/zkServer.sh" start
"$ZOOKEEPER_HOME/bin/zkServer.sh" status预期结果是三台节点都成功加入同一个集群,其中一台显示 Mode: leader,另外两台显示 Mode: follower。Leader 具体落在哪台机器上并不固定,例如一次正常结果可能是:
zk1: Mode: follower
zk2: Mode: leader
zk3: Mode: follower如果某台节点仍显示 standalone、无法读取模式,或启动后立即退出,优先检查三项:三个节点的 server.X 列表是否一致、myid 是否与编号匹配、2888 与 3888 是否被防火墙或错误的主机名解析阻断。
用跨节点读写完成验收
在 zk1 创建一个测试 znode,再从 zk2 读取它,可以验证客户端入口不同但数据视图一致。
printf 'create /cluster-check ok\nquit\n' | "$ZOOKEEPER_HOME/bin/zkCli.sh" -server zk1.example.internal:2181
printf 'get /cluster-check\nquit\n' | "$ZOOKEEPER_HOME/bin/zkCli.sh" -server zk2.example.internal:2181预期输出中的关键结果如下;连接日志、会话 ID 和时间戳会随环境变化:
Created /cluster-check
ok完成验证后可删除测试节点。真正的三节点部署验收应同时满足:成员身份唯一、三台节点形成一个 Leader 加两个 Follower、任意存活节点看到相同数据,并且停掉任意一个节点后剩余两个节点仍能形成多数派继续工作。