从零开始：Zookeeper安装配置完全指南

一、准备工作

在开始安装前，我们需要做好以下准备：

• 系统要求：Linux/Unix系统(推荐CentOS/Ubuntu)，JDK 1.8+
• 硬件要求：至少1GB内存，建议2GB以上
• 网络要求：稳定的网络连接，集群环境需要相互通信
• 下载地址：官网Apache Zookeeper下载最新稳定版

二、详细安装步骤

1. 安装JDK环境

# 检查Java版本
java -version

# 如果没有安装，Ubuntu下可使用
sudo apt-get update
sudo apt-get install openjdk-8-jdk

# CentOS下可使用
sudo yum install java-1.8.0-openjdk

2. 下载并解压Zookeeper

wget https://downloads.apache.org/zookeeper/zookeeper-3.7.0/apache-zookeeper-3.7.0-bin.tar.gz
tar -xzvf apache-zookeeper-3.7.0-bin.tar.gz
mv apache-zookeeper-3.7.0-bin /usr/local/zookeeper
cd /usr/local/zookeeper

3. 配置环境变量

# 编辑.bashrc或.zshrc文件
export ZOOKEEPER_HOME=/usr/local/zookeeper
export PATH=$PATH:$ZOOKEEPER_HOME/bin

# 使配置生效
source ~/.bashrc

三、核心配置详解

1. 配置文件(zoo.cfg)设置

# 复制示例配置文件
cp conf/zoo_sample.cfg conf/zoo.cfg

# 主要配置参数说明
tickTime=2000
dataDir=/var/lib/zookeeper
clientPort=2181
initLimit=5
syncLimit=2

# 集群配置示例(多台服务器时)
server.1=192.168.1.101:2888:3888
server.2=192.168.1.102:2888:3888
server.3=192.168.1.103:2888:3888

2. 数据目录与myid文件

# 创建数据目录
mkdir -p /var/lib/zookeeper

# 对于集群环境，每台服务器需要创建myid文件
# 内容对应server.x中的x数字
echo "1" > /var/lib/zookeeper/myid

四、启动与验证

1. 启动Zookeeper服务

# 前台启动(测试用)
bin/zkServer.sh start-foreground

# 后台启动(生产环境)
bin/zkServer.sh start

# 查看状态
bin/zkServer.sh status

2. 客户端连接测试

bin/zkCli.sh -server 127.0.0.1:2181

# 连接成功后尝试基本命令
[zk: 127.0.0.1:2181(CONNECTED) 0] ls /
[zk: 127.0.0.1:2181(CONNECTED) 1] create /test "hello"
[zk: 127.0.0.1:2181(CONNECTED) 2] get /test

五、常见问题解决

• 端口冲突：检查2181,2888,3888端口是否被占用
• 无法选举Leader：确保集群节点数≥3且网络连通
• 数据不一致：检查syncLimit和tickTime配置
• 内存不足：调整JVM参数，修改conf/java.env文件

六、生产环境最佳实践

1. 使用奇数节点数的集群(3,5,7台)
2. 为Zookeeper分配独立磁盘，避免IO竞争
3. 监控Zookeeper状态和性能指标
4. 定期备份数据和事务日志
5. 做好网络隔离和安全配置