服务注册与分布式协调 / 系统课时
课程实验环境规划
课程实验环境规划
本课先把后续实验需要的单机、伪集群、三节点集群和 Java 客户端统一规划好,重点解决端口、目录、进程数量与机器边界冲突,完成后即可按同一套约定继续安装、配置和编程实验。
学习目标
- 区分单机、伪集群和真实三节点集群各自适合验证的问题。
- 规划客户端端口、选举端口、通信端口和数据目录,避免实验互相干扰。
- 建立统一实验目录,并确认 Java 与 Maven 工具链可用。
固定实验基线
为了让后续命令和配置可以直接复用,本课程实验统一使用 JDK 17、ZooKeeper 3.9.5 和 Maven 3.9.x。操作系统以 Linux 或 WSL 的 Bash 环境为基线;如果使用 macOS,也应保持相同目录逻辑和端口规划。
建议至少预留 2 个 CPU 核心、4 GB 可用内存和 2 GB 磁盘空间。三节点真实集群更适合准备三台虚拟机或三台独立主机;资源有限时,可以先完成单机与伪集群,再切换到三节点环境。
四种环境分别解决什么问题
单机模式只有一个 ZooKeeper 进程,适合熟悉启动、CLI、znode 和 Watch 等基础操作。伪集群是在同一台机器上启动三个独立进程,用不同端口和数据目录模拟多数派、Leader 选举与节点上下线。
真实三节点集群把三个服务进程放到三台机器上,用来观察网络边界、主机故障和跨节点通信。Java 示例项目不是第四个 ZooKeeper 集群,而是独立客户端,它通过连接串访问前面任意一种环境。

端口与目录不要混用
单机环境固定使用客户端端口 2181。伪集群的三个实例可分别使用 2181、2182、2183 作为客户端端口,同时为每个实例分配互不重复的 quorum 与 election 端口。真实三节点集群因为运行在不同主机上,可以在每台机器复用相同的 2181、2888、3888。
数据目录也必须独立。尤其是伪集群,每个实例都要有自己的 dataDir 和 myid;三个进程共用同一数据目录会直接破坏节点身份与持久化状态。
| 环境 | ZooKeeper 进程 | 主机数量 | 客户端端口建议 | 主要用途 |
|---|---|---|---|---|
| 单机 | 1 | 1 | 2181 | 基础命令与数据模型 |
| 伪集群 | 3 | 1 | 2181、2182、2183 | 选举、多数派与故障实验 |
| 三节点集群 | 3 | 3 | 每台均 2181 | 网络与真实主机故障 |
| Java 示例项目 | 0 | 1 | 不监听 ZooKeeper 端口 | 客户端 API 与业务示例 |
建立统一实验目录
先创建课程根目录,并检查 Java 与 Maven 是否已经在 PATH 中。下面命令只创建目录,不会启动任何 ZooKeeper 进程。
java -version 2>&1 | head -n 1
mvn -version | head -n 1
mkdir -p "$HOME/zk-lab"/{packages,standalone,pseudo,ensemble,java-client}
printf '%s\n' "$HOME/zk-lab"预期输出中版本号和用户目录会因机器不同而变化,重点是两个工具都能正常返回版本,最后一行能打印实验根目录。
openjdk version "<VERSION>" <TIME>
Apache Maven <VERSION>
<PATH>/zk-lab如果 java 或 mvn 提示 command not found,应先补齐工具链再继续;如果端口已经被占用,则先停止旧实验进程或调整当前实验端口,不要让两套环境同时争用同一端口。
后续实验的切换原则
同一台机器上默认一次只启用一种 ZooKeeper 环境:做基础操作时启单机,验证选举时停掉单机再启伪集群,做真实故障演练时改用三台独立节点。Java 示例项目只作为客户端存在,可以通过修改连接串在不同环境之间切换。
只要目录互相隔离、端口不冲突、三节点身份独立,后续每个实验都能在可预测的起点上重复执行;遇到问题时也能快速判断是配置错误、端口冲突还是节点边界不符合预期。