一、引言

ZooKeeper作为Apache基金会旗下的分布式协调服务框架，广泛应用于分布式系统中的配置管理、服务发现、分布式锁等场景。其核心特性包括高可用性、强一致性和原子性操作，是构建分布式系统的关键组件。本文将重点介绍ZooKeeper的两种部署模式：单机部署和集群（单机伪集群）部署，帮助开发者快速搭建并验证ZooKeeper服务。

二、ZooKeeper单机部署

1. 环境准备

操作系统：推荐使用Linux（如CentOS 7/8或Ubuntu 20.04+），确保系统时间同步（NTP服务）。

Java环境：ZooKeeper依赖Java运行环境，需安装JDK 8或更高版本。

# 以CentOS为例安装JDK
sudo yum install -y java-1.8.0-openjdk-devel
java -version  # 验证安装

ZooKeeper版本：建议选择稳定版本（如3.7.0），从Apache官网下载二进制包。

2. 单机部署步骤

2.1 下载与解压

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

2.2 配置文件修改

ZooKeeper的核心配置文件为conf/zoo.cfg，单机模式需配置以下参数：

# zoo.cfg 单机模式示例
tickTime=2000  # 心跳间隔（毫秒）
dataDir=/var/lib/zookeeper  # 数据存储目录
clientPort=2181  # 客户端连接端口

关键参数说明：
- tickTime：基础时间单位，影响会话超时（默认sessionTimeout=2*tickTime）。
- dataDir：需确保目录存在且权限正确（sudo mkdir -p /var/lib/zookeeper）。
- clientPort：客户端访问端口，需确保未被占用。

2.3 启动服务

bin/zkServer.sh start  # 启动
bin/zkServer.sh status  # 验证状态（应显示"Mode: standalone"）

2.4 客户端连接测试

bin/zkCli.sh -server 127.0.0.1:2181  # 连接本地ZooKeeper
# 在客户端中执行命令验证
ls /  # 查看根节点
create /test_node "hello"  # 创建测试节点
get /test_node  # 获取节点数据

3. 单机部署常见问题

端口冲突：若2181端口被占用，可通过netstat -tulnp | grep 2181排查，修改clientPort后重启。
数据目录权限：确保dataDir对ZooKeeper进程用户可写（chown -R zookeeper:zookeeper /var/lib/zookeeper）。
日志配置：默认日志输出至bin/../logs/，可通过log4j.properties调整日志级别。

三、ZooKeeper集群（单机伪集群）部署

1. 伪集群概念

伪集群指在一台物理机上模拟多节点集群，通过配置不同的端口和数据目录实现。适用于开发测试环境，可验证集群选举、脑裂等场景。

2. 伪集群部署步骤

2.1 配置多实例目录

# 创建3个实例目录（模拟3节点集群）
for i in {1..3}; do
  mkdir -p /opt/zk_cluster/zk$i/{data,logs}
  cp conf/zoo_sample.cfg conf/zoo$i.cfg
done

2.2 修改配置文件

以conf/zoo1.cfg为例：

# zoo1.cfg 伪集群配置
tickTime=2000
dataDir=/opt/zk_cluster/zk1/data
clientPort=2181
initLimit=5  # 初始连接超时（tickTime倍数）
syncLimit=2  # 同步超时
server.1=127.0.0.1:2888:3888  # 节点1（ID:1）
server.2=127.0.0.1:2889:3889  # 节点2（ID:2）
server.3=127.0.0.1:2890:3890  # 节点3（ID:3）

关键配置：
- server.X：格式为server.id=hostport2，其中id需与dataDir下的myid文件内容一致。
- port1：Leader与Follower通信端口。
- port2：Leader选举端口。

2.3 创建myid文件

# 为每个实例创建myid文件（内容为节点ID）
echo "1" > /opt/zk_cluster/zk1/data/myid
echo "2" > /opt/zk_cluster/zk2/data/myid
echo "3" > /opt/zk_cluster/zk3/data/myid

2.4 启动多实例

# 启动节点1（使用zoo1.cfg）
ZK_CFG=/opt/apache-zookeeper-3.7.0-bin/conf/zoo1.cfg bin/zkServer.sh start-foreground
# 后台启动需指定配置文件路径
ZK_CFG=/opt/apache-zookeeper-3.7.0-bin/conf/zoo1.cfg bin/zkServer.sh start
# 类似启动节点2和节点3

2.5 验证集群状态

# 连接任意节点查看集群状态
bin/zkCli.sh -server 127.0.0.1:2181
# 在客户端中执行
echo stat | nc 127.0.0.1 2181  # 查看节点角色（Leader/Follower）

3. 伪集群常见问题

节点无法通信：检查防火墙是否放行选举端口（如3888），或通过telnet 127.0.0.1 3888测试连通性。
选举失败：确保myid文件内容与server.X中的ID一致，且数据目录无残留文件。
日志混乱：为每个实例配置独立的日志文件（修改log4j.properties中的zookeeper.root.logger）。

四、最佳实践与建议

生产环境部署：
- 至少3个物理节点，避免单点故障。
- 使用奇数节点数（如3、5、7），确保选举可靠性。
- 监控工具推荐：Prometheus + Grafana监控ZooKeeper指标（如zk_outstanding_requests）。
性能优化：
- 调整tickTime（默认2000ms）以平衡延迟与吞吐量。
- 增大maxClientCnxns（默认60）以支持高并发连接。
数据安全：
- 启用ACL权限控制（配置conf/zoo.cfg中的authProvider.1=org.apache.zookeeper.server.auth.DigestAuthenticationProvider）。
- 定期备份dataDir下的快照文件（snapshot.*）和事务日志（log.*）。

五、总结

本文详细阐述了ZooKeeper单机部署和伪集群部署的完整流程，从环境准备、配置修改到启动验证，覆盖了关键步骤和常见问题。伪集群模式为开发测试提供了低成本验证方案，而生产环境需遵循高可用原则部署真实集群。通过合理配置和监控，ZooKeeper可稳定支撑分布式系统的核心协调需求。

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