当前位置：首页 > news >正文

ZooKeeper 安装部署完全指南

news 2026/5/29 5:35:22

ZooKeeper 安装部署完全指南（单机+伪集群+生产集群）
本文从零搭建 ZooKeeper，覆盖单机模式、伪集群模式、生产高可用集群，附带命令、配置、常见问题与运维速查，新手/面试/生产都能用。
前言

ZooKeeper 是分布式系统必备协调服务，本文基于 ZooKeeper 3.8+，支持 CentOS7、Ubuntu、macOS、WSL。
一、单机模式（Standalone）

适用：开发、学习、测试
特点：单节点，无高可用

1. 前置条件

• JDK 1.8+

• 关闭防火墙/放行 2181 端口

2. 下载解压
wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.3/apache-zookeeper-3.8.3-bin.tar.gz
tar -xzvf apache-zookeeper-3.8.3-bin.tar.gz -C /opt/
mv /opt/apache-zookeeper-3.8.3-bin /opt/zookeeper
cd /opt/zookeeper
3. 配置文件
cp conf/zoo_sample.cfg conf/zoo.cfg
vim conf/zoo.cfg
核心配置
tickTime=2000
dataDir=/var/lib/zookeeper
clientPort=2181
initLimit=10
syncLimit=5
admin.enableServer=false
4. 创建数据目录与 myid
mkdir -p /var/lib/zookeeper
echo "1" > /var/lib/zookeeper/myid
5. 启动与验证
bin/zkServer.sh start
bin/zkServer.sh status
bin/zkCli.sh -server localhost:2181
二、伪集群模式（Pseudo-cluster）

适用：单机模拟集群、学习选举
原理：一台机器启 3 个实例，不同端口区分

1. 复制 3 份程序
cd /opt
cp -r zookeeper zookeeper-1
cp -r zookeeper zookeeper-2
cp -r zookeeper zookeeper-3
2. 配置 zoo.cfg（3 个节点分别配置）

zookeeper-1
tickTime=2000
initLimit=10
syncLimit=5
dataDir=/opt/zookeeper-1/data
clientPort=2181
server.1=127.0.0.1:2888:3888
server.2=127.0.0.1:2889:3889
server.3=127.0.0.1:2890:3890
• zookeeper-2：clientPort=2182，dataDir=/opt/zookeeper-2/data

• zookeeper-3：clientPort=2183，dataDir=/opt/zookeeper-3/data

3. 配置 myid
echo 1 > /opt/zookeeper-1/data/myid
echo 2 > /opt/zookeeper-2/data/myid
echo 3 > /opt/zookeeper-3/data/myid
4. 启动并查看状态
/opt/zookeeper-1/bin/zkServer.sh start
/opt/zookeeper-2/bin/zkServer.sh start
/opt/zookeeper-3/bin/zkServer.sh start

# 查看状态
/opt/zookeeper-1/bin/zkServer.sh status
预期：1 个 Leader，2 个 Follower
三、生产集群模式（Production Cluster）

要求：3 台独立机器（奇数台）
示例节点

• 192.168.1.101（myid=1）

• 192.168.1.102（myid=2）

• 192.168.1.103（myid=3）

1. 每台机器安装 ZooKeeper
wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.3/apache-zookeeper-3.8.3-bin.tar.gz
tar -xzvf apache-zookeeper-3.8.3-bin.tar.gz -C /opt/
mv /opt/apache-zookeeper-3.8.3-bin /opt/zookeeper
2. 配置 zoo.cfg（3 台完全一致）
cp conf/zoo_sample.cfg conf/zoo.cfg
vim conf/zoo.cfg
tickTime=2000
initLimit=10
syncLimit=5
dataDir=/data/zookeeper
clientPort=2181

server.1=192.168.1.101:2888:3888
server.2=192.168.1.102:2888:3888
server.3=192.168.1.103:2888:3888
3. 配置 myid（每台不同）
# 101
mkdir -p /data/zookeeper
echo "1" > /data/zookeeper/myid

# 102
echo "2" > /data/zookeeper/myid

# 103
echo "3" > /data/zookeeper/myid
4. 启动集群
bin/zkServer.sh start
bin/zkServer.sh status
5. 验证集群
zkCli.sh -server 192.168.1.101:2181
create /test "hello cluster"
在其他节点连接可读到相同数据。
四、Docker 快速部署（可选）

单节点
docker run -d --name zk -p 2181:2181 zookeeper:3.8.3
Compose 三节点集群
version: '3'
services:
zoo1:
image: zookeeper:3.8.3
environment:
ZOO_MY_ID: 1
ZOO_SERVERS: server.1=0.0.0.0:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
zoo2:
image: zookeeper:3.8.3
environment:
ZOO_MY_ID: 2
ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=0.0.0.0:2888:3888;2181 server.3=zoo3:2888:3888;2181
zoo3:
image: zookeeper:3.8.3
environment:
ZOO_MY_ID: 3
ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=0.0.0.0:2888:3888;2181
五、ZooKeeper 常用运维命令
zkServer.sh start # 启动
zkServer.sh stop # 停止
zkServer.sh restart # 重启
zkServer.sh status # 状态
zkServer.sh start-foreground # 前台调试
zkCli.sh -server ip:2181 # 客户端连接
六、常见问题