ZooKeeper单机部署及集群(单机伪集群)部署指南

一、引言

ZooKeeper作为分布式系统的核心协调组件，广泛应用于服务发现、配置管理、分布式锁等场景。本文将详细介绍ZooKeeper的两种部署模式：单机部署与单机伪集群部署。单机部署适用于开发测试环境，而单机伪集群部署则模拟真实集群环境，便于本地验证高可用性方案。

二、单机部署

1. 环境准备

操作系统：推荐Linux（CentOS/Ubuntu）
Java环境：JDK 1.8+（需配置JAVA_HOME）
ZooKeeper版本：3.6.3+（稳定版）

2. 安装步骤

下载安装包

wget https://archive.apache.org/dist/zookeeper/zookeeper-3.6.3/apache-zookeeper-3.6.3-bin.tar.gz
tar -xzvf apache-zookeeper-3.6.3-bin.tar.gz -C /opt/
cd /opt/zookeeper-3.6.3

配置环境变量
在/etc/profile中添加：

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

执行source /etc/profile生效。

修改配置文件
复制模板配置文件：

cp conf/zoo_sample.cfg conf/zoo.cfg

编辑conf/zoo.cfg，核心参数如下：

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

启动服务

bin/zkServer.sh start

验证状态：

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

3. 客户端连接测试

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

三、单机伪集群部署

1. 原理说明

单机伪集群通过配置多个ZooKeeper实例在同一台机器上运行，模拟真实集群的Leader-Follower架构，适用于本地开发验证。

2. 部署步骤

创建多实例目录

mkdir -p /opt/zk-cluster/{zk1,zk2,zk3}
cp -r /opt/zookeeper-3.6.3/* /opt/zk-cluster/zk1/
cp -r /opt/zookeeper-3.6.3/* /opt/zk-cluster/zk2/
cp -r /opt/zookeeper-3.6.3/* /opt/zk-cluster/zk3/

配置多实例
编辑各实例的zoo.cfg：

zk1配置：

dataDir=/var/lib/zookeeper/zk1
clientPort=2181
server.1=127.0.0.13888  # server.id=hostelectionPort
server.2=127.0.0.13889
server.3=127.0.0.13890

zk2/zk3配置：仅修改dataDir和clientPort。

创建myid文件
在每个实例的dataDir目录下创建myid文件，内容为实例ID（如zk1的myid内容为1）。

启动所有实例

bin/zkServer.sh start-foreground /opt/zk-cluster/zk1/conf/zoo.cfg &
bin/zkServer.sh start-foreground /opt/zk-cluster/zk2/conf/zoo.cfg &
bin/zkServer.sh start-foreground /opt/zk-cluster/zk3/conf/zoo.cfg &

（生产环境建议使用systemd或supervisord管理）

验证集群状态
连接任意实例：

bin/zkCli.sh -server 127.0.0.1:2181
# 执行命令查看Leader：
echo stat | nc 127.0.0.1 2181
# 输出中"Mode: leader"或"Mode: follower"

四、常见问题解决

1. 端口冲突

现象：启动失败，日志提示Address already in use
解决：检查clientPort、leaderPort（2888）和electionPort（3888）是否被占用。

2. 数据目录权限不足

现象：dataDir无法写入

解决：

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

3. 伪集群选举失败

现象：实例无法选举出Leader
检查点：
- 确认myid文件内容与server.id匹配
- 检查防火墙是否放行2888/3888端口
- 查看日志logs/zookeeper.out中的错误信息

五、最佳实践建议

生产环境部署：

至少3个物理节点（避免脑裂）

使用systemd管理进程：

[Unit]
Description=ZooKeeper
After=network.target
[Service]
Type=forking
User=zookeeper
ExecStart=/opt/zookeeper/bin/zkServer.sh start
ExecStop=/opt/zookeeper/bin/zkServer.sh stop
Restart=on-failure
[Install]
WantedBy=multi-user.target

监控配置：
- 使用JMX暴露指标（conf/java.env中添加JMX_PORT=9999）
- 集成Prometheus+Grafana监控
性能调优：
- 调整tickTime（默认2000ms，网络延迟高时可降低至1000ms）
- 增加initLimit和syncLimit（集群规模大时）

六、总结

通过本文的指导，读者可以完成：

5分钟内完成ZooKeeper单机部署
15分钟内搭建单机伪集群环境
掌握关键故障排查方法

对于开发人员，建议优先使用单机伪集群验证分布式逻辑；对于运维人员，需重点关注集群部署中的网络配置与持久化存储方案。

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