一、引言

ZooKeeper作为分布式系统协调服务的核心组件，广泛应用于配置管理、分布式锁、服务发现等场景。无论是开发环境验证还是生产环境高可用部署，掌握其单机和集群（包括单机伪集群）的部署方法都是基础技能。本文将通过详细的步骤说明和配置示例，帮助读者快速完成ZooKeeper的部署实践。

二、ZooKeeper单机部署

1. 环境准备

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

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

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

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

wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.1/apache-zookeeper-3.8.1-bin.tar.gz
tar -xzvf apache-zookeeper-3.8.1-bin.tar.gz -C /opt/
cd /opt/apache-zookeeper-3.8.1-bin

2. 配置文件编写

修改conf/zoo.cfg文件（若不存在则从conf/zoo_sample.cfg复制）：

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

关键参数说明：
- tickTime：ZooKeeper使用的时间单位，影响会话超时计算。
- dataDir：存储快照（snapshot）和事务日志的目录，需确保磁盘空间充足。
- clientPort：客户端访问端口，默认2181。

3. 启动与验证

启动服务：
```
bin/zkServer.sh start
```
验证状态：
```
echo stat | nc localhost 2181
# 或使用四字命令
bin/zkServer.sh status
```
输出应包含Mode: standalone，表示单机模式运行成功。

4. 客户端连接测试

bin/zkCli.sh -server localhost:2181
# 在客户端中执行
create /test_node "hello"  # 创建节点
get /test_node            # 读取节点数据

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

1. 伪集群概念

伪集群通过在一台物理机上模拟多个ZooKeeper实例，实现集群行为验证，适用于开发测试环境。

2. 配置多实例

创建数据目录：

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

myid文件内容需与server.x配置中的ID对应。

配置zoo.cfg：
```
tickTime=2000
dataDir=/var/lib/zookeeper/data1
clientPort=2181
initLimit=10
syncLimit=5
# 集群节点配置
server.1=127.0.0.13888
server.2=127.0.0.13889
server.3=127.0.0.13890
```
- 端口说明：
  - 2888：Follower与Leader的数据同步端口。
  - 3888：Leader选举端口。
- 复制配置：将zoo.cfg复制为zoo1.cfg、zoo2.cfg、zoo3.cfg，分别修改dataDir和clientPort。

3. 启动多实例

# 实例1
bin/zkServer.sh start-foreground zoo1.cfg &
# 实例2
bin/zkServer.sh start-foreground zoo2.cfg &
# 实例3
bin/zkServer.sh start-foreground zoo3.cfg &

使用start-foreground可在前台查看日志，生产环境建议使用systemd或supervisord管理。

4. 验证集群状态

检查Leader选举：

echo stat | nc localhost 2181
# 输出中应包含Mode: leader或follower

使用四字命令：

echo mntr | nc localhost 2181  # 监控指标
echo srvr | nc localhost 2181  # 服务器状态

四、常见问题与优化

1. 端口冲突

问题：伪集群中若端口配置错误，会导致实例无法启动。
解决：确保每个实例的clientPort、2888和3888端口唯一。

2. 数据目录权限

问题：dataDir目录权限不足会导致启动失败。

解决：

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

3. 性能优化建议

JVM参数调整：在bin/zkEnv.sh中设置合理的堆内存（如-Xmx2G）。
日志分割：配置log4j.properties实现日志按日期或大小分割。
磁盘选择：使用SSD存储数据目录，提升I/O性能。

五、总结

本文详细介绍了ZooKeeper单机部署和伪集群部署的全流程，从环境准备、配置编写到启动验证，覆盖了关键步骤和常见问题。对于开发者而言，掌握伪集群部署可高效验证分布式逻辑；对于运维人员，单机部署是生产环境高可用架构的基础单元。建议读者结合实际场景，进一步探索ZooKeeper的监控、备份和扩展方案。

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