引言

ZooKeeper作为Apache旗下的分布式协调服务框架，广泛应用于分布式系统的配置管理、命名服务、分布式锁等场景。其核心功能在于通过ZAB协议（ZooKeeper Atomic Broadcast）实现高可用与数据一致性。对于开发测试环境或资源受限的场景，单机部署和单机伪集群部署是高效验证功能的首选方案。本文将系统讲解这两种部署模式的操作步骤、配置要点及注意事项。

一、ZooKeeper单机部署

1. 环境准备

操作系统：推荐CentOS 7/8或Ubuntu 20.04+（需关闭SELinux/防火墙或开放2181端口）
Java环境：JDK 1.8+（通过java -version验证）
依赖包：wget、tar、vim等基础工具

2. 安装步骤

步骤1：下载并解压ZooKeeper

wget https://archive.apache.org/dist/zookeeper/zookeeper-3.8.1/apache-zookeeper-3.8.1-bin.tar.gz
tar -zxvf apache-zookeeper-3.8.1-bin.tar.gz -C /opt/
ln -s /opt/apache-zookeeper-3.8.1-bin /opt/zookeeper

步骤2：配置环境变量

编辑/etc/profile，添加：

export ZOOKEEPER_HOME=/opt/zookeeper
export PATH=$PATH:$ZOOKEEPER_HOME/bin

执行source /etc/profile使配置生效。

步骤3：配置zoo.cfg

复制默认配置模板并修改：

cp $ZOOKEEPER_HOME/conf/zoo_sample.cfg $ZOOKEEPER_HOME/conf/zoo.cfg

编辑zoo.cfg，关键参数如下：

# 基础配置
tickTime=2000           # 心跳间隔（毫秒）
dataDir=/var/lib/zookeeper  # 数据存储目录
clientPort=2181          # 客户端连接端口
# 可选优化
maxClientCnxns=60        # 单个客户端最大连接数
autopurge.snapRetainCount=3  # 保留的快照文件数
autopurge.purgeInterval=24    # 自动清理间隔（小时）

步骤4：启动服务

zkServer.sh start

验证状态：

zkServer.sh status
# 输出"Mode: standalone"表示成功

3. 客户端连接测试

zkCli.sh -server 127.0.0.1:2181
# 在客户端中执行：
create /test_node "hello"
get /test_node

二、ZooKeeper单机伪集群部署

伪集群通过单台机器模拟多节点集群，适用于开发环境验证分布式特性（如Leader选举、数据同步）。

1. 环境要求

至少3个可用端口（如2181、2182、2183）
3个独立的数据目录（如/var/lib/zookeeper/data1、data2、data3）

2. 配置步骤

步骤1：创建多实例配置文件

复制zoo.cfg为三个文件：

cp $ZOOKEEPER_HOME/conf/zoo.cfg $ZOOKEEPER_HOME/conf/zoo1.cfg
cp $ZOOKEEPER_HOME/conf/zoo.cfg $ZOOKEEPER_HOME/conf/zoo2.cfg
cp $ZOOKEEPER_HOME/conf/zoo.cfg $ZOOKEEPER_HOME/conf/zoo3.cfg

步骤2：修改各实例配置

以zoo1.cfg为例：

clientPort=2181
dataDir=/var/lib/zookeeper/data1
server.1=127.0.0.1:2888:3888   # 节点ID:Leader通信端口:选举端口
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890

同理修改zoo2.cfg（端口2182/2889/3889）和zoo3.cfg（端口2183/2890/3890）。

步骤3：创建myid文件

在每个数据目录下创建标识节点ID的文件：

echo "1" > /var/lib/zookeeper/data1/myid
echo "2" > /var/lib/zookeeper/data2/myid
echo "3" > /var/lib/zookeeper/data3/myid

步骤4：启动多实例

zkServer.sh start-foreground $ZOOKEEPER_HOME/conf/zoo1.cfg &
zkServer.sh start-foreground $ZOOKEEPER_HOME/conf/zoo2.cfg &
zkServer.sh start-foreground $ZOOKEEPER_HOME/conf/zoo3.cfg &

或使用后台启动：

zkServer.sh start $ZOOKEEPER_HOME/conf/zoo1.cfg
zkServer.sh start $ZOOKEEPER_HOME/conf/zoo2.cfg
zkServer.sh start $ZOOKEEPER_HOME/conf/zoo3.cfg

步骤5：验证集群状态

通过任意节点的客户端连接：

zkCli.sh -server 127.0.0.1:2181
# 执行命令查看Leader
stat /

输出中Mode: leader或Mode: follower表明集群正常。

三、常见问题与解决方案

1. 端口冲突

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

2. 数据目录权限不足

现象：日志报错Permission denied

解决：

chown -R zookeeper:zookeeper /var/lib/zookeeper
chmod -R 755 /var/lib/zookeeper

3. 伪集群节点无法通信

现象：stat /命令卡住或报错
检查项：
- 确认server.X配置中的IP和端口正确
- 检查防火墙规则（iptables -L）
- 验证myid文件内容与配置一致

4. 内存不足

现象：服务频繁崩溃
优化：修改zkEnv.sh，调整JVM参数：
```
export JVMFLAGS="-Xms512m -Xmx1024m"
```

四、最佳实践建议

生产环境部署：伪集群仅适用于开发，生产环境需至少3台物理机部署真集群。
监控配置：通过JMX监控（添加-Dcom.sun.management.jmxremote参数）或集成Prometheus+Grafana。
数据备份：定期备份dataDir目录，避免磁盘故障导致数据丢失。
版本选择：优先使用稳定版（如3.7.x或3.8.x），避免测试版的不稳定风险。

五、总结

ZooKeeper的单机部署适合快速验证功能，而单机伪集群部署则能模拟分布式环境下的核心行为。通过本文的步骤，开发者可以高效完成部署，并掌握关键配置参数的作用。实际生产中，需结合监控、备份等运维手段保障服务稳定性。对于进一步探索，可研究ZooKeeper的Watcher机制、ACL权限控制等高级特性。

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

引言