一、引言

ZooKeeper作为Apache的顶级项目，是分布式系统中不可或缺的协调服务组件，广泛应用于配置管理、命名服务、分布式锁、集群管理等领域。其核心优势在于提供高可用的分布式协调能力，确保系统在复杂网络环境下稳定运行。本文将深入探讨ZooKeeper的单机部署与集群部署（含单机伪集群）方法，帮助开发者根据业务需求选择合适的部署方案。

二、环境准备

1. 硬件与软件要求

硬件：建议至少2核CPU、4GB内存（单机部署可适当降低，集群部署需根据节点数增加资源）。
操作系统：Linux（推荐CentOS 7+或Ubuntu 18.04+），Windows仅用于测试环境。
依赖：Java 8+（需配置JAVA_HOME环境变量）。
网络：集群部署需确保节点间网络互通，关闭防火墙或开放2181（客户端端口）、2888（节点通信端口）、3888（选举端口）。

2. 下载与安装

从Apache官网下载稳定版ZooKeeper（如3.7.0），解压至指定目录：

tar -zxvf apache-zookeeper-3.7.0-bin.tar.gz -C /opt/
cd /opt/apache-zookeeper-3.7.0-bin/

三、单机部署

1. 配置文件编写

进入conf目录，复制默认配置文件并修改：

cp zoo_sample.cfg zoo.cfg
vi zoo.cfg

关键配置项：

tickTime=2000          # 心跳间隔（毫秒）
dataDir=/var/lib/zookeeper  # 数据存储目录
clientPort=2181        # 客户端连接端口

2. 启动与验证

启动ZooKeeper服务：

bin/zkServer.sh start

检查状态：

bin/zkServer.sh status
# 输出"Mode: standalone"表示单机模式运行成功

3. 客户端连接测试

bin/zkCli.sh -server 127.0.0.1:2181
# 在客户端中执行`ls /`查看根节点

四、集群部署（含单机伪集群）

1. 伪集群原理

伪集群通过在一台物理机上模拟多个ZooKeeper节点，使用不同端口实现集群通信，适用于开发测试环境。

2. 配置多实例

步骤1：创建多个数据目录

mkdir -p /var/lib/zookeeper/{data1,data2,data3}
echo "1" > /var/lib/zookeeper/data1/myid
echo "2" > /var/lib/zookeeper/data2/myid
echo "3" > /var/lib/zookeeper/data3/myid

步骤2：编写配置文件

复制zoo.cfg为zoo1.cfg、zoo2.cfg、zoo3.cfg，修改以下内容：

# zoo1.cfg示例
clientPort=2181
dataDir=/var/lib/zookeeper/data1
server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
# zoo2.cfg需修改clientPort=2182, dataDir=/var/lib/zookeeper/data2
# zoo3.cfg需修改clientPort=2183, dataDir=/var/lib/zookeeper/data3

步骤3：启动多实例

bin/zkServer.sh start-foreground zoo1.cfg &  # 后台运行需去掉&
bin/zkServer.sh start-foreground zoo2.cfg &
bin/zkServer.sh start-foreground zoo3.cfg &

3. 真集群部署要点

节点规划：建议3/5/7个节点，奇数个确保选举可靠性。
配置同步：所有节点zoo.cfg中server.X需包含全部节点信息。
持久化：使用SSD存储dataDir，避免IO瓶颈。

五、常见问题与解决

1. 端口冲突

现象：启动失败，日志提示Address already in use。
解决：检查netstat -tulnp | grep 2181，终止冲突进程或修改端口。

2. 节点无法加入集群

现象：stat命令显示Follower或Leader状态异常。
检查项：
- myid文件内容与server.X中的X是否一致。
- 网络连通性（telnet <ip> 2888）。
- 日志中是否有QuorumPeerMain初始化错误。

3. 性能优化建议

JVM调优：修改bin/zkEnv.sh中的JVMFLAGS，增加堆内存（如-Xmx2g -Xms2g）。
快照与日志：调整snapCount（默认100000次操作触发快照）和autopurge（自动清理旧日志）。

六、总结与展望

ZooKeeper的单机部署适用于开发测试，而集群部署（含伪集群）则是生产环境的核心方案。通过合理配置节点数、优化网络与存储，可显著提升系统可用性。未来，随着ZooKeeper 4.x版本的演进，其动态重配置、观察者节点等特性将进一步简化集群管理。建议开发者定期关注官方文档，保持环境与版本的更新。

七、扩展资源

官方文档：https://zookeeper.apache.org/doc/
监控工具：Prometheus + Grafana（通过JMX暴露指标）
客户端库：Curator（Java）、Kazoo（Python）

ZooKeeper单机与集群部署全攻略：从入门到伪集群实践