Zookeeper安装配置的核心路径就三条：Linux下解压改zoo.cfg启动，Docker里一条命令拉镜像跑容器，本地调试用单机版，生产环境必须上集群，先搞定JDK和dataDir，再依次验证2181端口与leader状态，安装配置不会轻易翻车。
Linux安装Zookeeper详细步骤
检查JDK与下载二进制包
Linux服务器先确认Java版本,Zookeeper 3.8.x主要兼容JDK 8与JDK 11，不确定就执行java -version看一眼。
没有JDK的情况下,Debian或Ubuntu执行：
sudo apt update && sudo apt install -y openjdk-11-jdk
CentOS或Rocky执行：
sudo yum install -y java-11-openjdk
下载包使用Apache归档地址,以3.8.4为例：
wget https://archive.apache.org/dist/zookeeper/zookeeper-3.8.4/apache-zookeeper-3.8.4-bin.tar.gz
一定要选择带-bin的包，源码包编译耗时长，不适合安装部署场景。
解压与创建数据目录
tar -zxvf apache-zookeeper-3.8.4-bin.tar.gz -C /usr/local/ cd /usr/local/apache-zookeeper-3.8.4-bin mkdir -p data
data目录用来存放Zookeeper快照和事务日志，目录不存在时，启动会直接报错。
修改zoo.cfg关键参数
官方只给了样本配置,需要复制一份再改：
cp conf/zoo_sample.cfg conf/zoo.cfg vim conf/zoo.cfg
单机版至少改两个参数：
dataDir=/usr/local/apache-zookeeper-3.8.4-bin/data clientPort=2181
集群版在文件末尾追加三行：
server.1=192.168.1.11:2888:3888 server.2=192.168.1.12:2888:3888 server.3=192.168.1.13:2888:3888
2888端口用于节点间数据同步,3888用于选举通信，每台机器还要在data目录写入唯一的myid：
echo 1 > data/myid
三台机器分别写入1、2、3，必须和server列表对应，否则集群起不来。
启动与连接验证
bin/zkServer.sh start bin/zkServer.sh status
单机模式status显示standalone，集群模式显示leader或follower，接着用客户端连一次：
bin/zkCli.sh -server 127.0.0.1:2181
进入客户端后执行：
ls /
正常返回[zookeeper]，说明安装配置已经生效。
Docker安装Zookeeper命令
单节点一键运行
Docker环境比手动解压更省事,本地调试执行一条命令即可：
docker run -d --name zookeeper -p 2181:2181 zookeeper:3.8.4
如果希望数据持久化,挂载两个目录：
docker run -d --name zookeeper \ -p 2181:2181 \ -v /opt/zookeeper/data:/data \ -v /opt/zookeeper/datalog:/datalog \ zookeeper:3.8.4
查看启动日志用docker logs -f zookeeper，日志里出现binding to port 0.0.0.0/0.0.0.0:2181，就代表容器内服务正常。
Docker Compose跑三节点集群
本地模拟集群常用Compose,创建一个docker-compose.yml：
services:
zoo1:
image: zookeeper:3.8.4
hostname: zoo1
ports:
- "2181:2181"
environment:
ZOO_MY_ID: 1
ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
zoo2:
image: zookeeper:3.8.4
hostname: zoo2
ports:
- "2182:2181"
environment:
ZOO_MY_ID: 2
ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
zoo3:
image: zookeeper:3.8.4
hostname: zoo3
ports:
- "2183:2181"
environment:
ZOO_MY_ID: 3
ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181
随后执行docker compose up -d，三节点分属不同hostname，宿主机用2181、2182、2183三个端口访问，避免冲突。
Zookeeper单机版和集群版区别
| 对比项 | 单机版 | 集群版（三节点） |
|---|---|---|
| 节点数量 | 1 | 3或5奇数 |
| 可用性 | 宕机即不可用 | 少数节点故障仍可服务 |
| 选举机制 | 无 | 有leader与follower |
| 数据一致性 | 本地单副本 | 多数派仲裁 |
| 适用场景 | 本地调试、开发测试 | 生产环境、分布式协调 |
| 配置复杂度 | 低 | 中高，需myid和server列表 |
业内专家指出,Zookeeper集群至少三节点才能形成多数派仲裁，双节点不具备容错意义，多数生产事故都源于误把双节点当集群用，一个节点挂掉后整个服务直接不可用。
什么时候选单机
本地跑demo、开发联调、CI流水线里临时依赖，选单机版足够，资源占用少，一条命令启动，不需要额外维护myid和选举端口。
什么时候必须上集群
只要服务被其他系统依赖,比如Kafka、HBase、Dubbo，就要上集群，三个节点分布在不同的物理机或虚拟机，避免单机故障，生产环境不建议用Docker跑三节点放同一台宿主机，那只是形式上的集群，宿主机重启后三个节点一起挂。
Windows本地安装Zookeeper教程
原生环境为什么折腾
Windows官方二进制包仍然带有zkServer.cmd，但新版本对cmd脚本支持一般，很多开发者卡在三处：JAVA_HOME含空格、路径反斜杠转义、cmd窗口一闪而过看不到报错，这些多数不是Zookeeper本身难，是Windows环境变量习惯和Linux不同。
推荐WSL2路径
在Windows 11或Win10使用WSL2安装Linux发行版，之后完全按Linux安装Zookeeper详细步骤执行，不需要单独维护Windows版脚本，也能避免CRLF换行和路径分隔符带来的奇怪问题，WSL2和Docker Desktop共享内核，适合同时跑容器。
或者直接Docker Desktop
本地调试用Docker Desktop最省心，PowerShell执行：
docker run -d --name zookeeper-local -p 2181:2181 zookeeper:3.8.4
启动后用Spring Boot或Dubbo连localhost:2181，数据目录可以在Docker Desktop的Volumes里查看，不熟悉Linux路径也不用担心。
把单机命令跑通只算完成一半,真正的Zookeeper安装配置难点在集群参数和选举状态判断，守住JAVA_HOME与myid两个细节，放行2181和3888端口，后面扩展多少节点都是同一套思路。
Zookeeper安装配置常见问题Q&A
Linux安装Zookeeper时JAVA_HOME反复报错怎么办？
先执行echo $JAVA_HOME确认变量存在，再确认该路径下有bin/java，如果没有，把JDK安装路径写入/etc/profile或~/.bashrc，Zookeeper启动脚本会直接读取JAVA_HOME，不会去PATH里找Java，改完变量后重新登录终端再启动。
Docker安装Zookeeper命令跑完容器却没起来怎么排查？
用docker logs <容器名>看启动输出，常见原因有两个：2181端口被宿主机其他进程占用，或者挂载目录权限不足，先停掉占用进程或换映射端口，再给挂载目录写权限，重新docker rm后启动即可。
Zookeeper单机版和集群版在生产环境怎么选？
生产环境只要ZK承担协调职责,必须选集群版，节点数通常为3或5，单机版只适合开发、测试和本地联调，集群中所有节点配置项相同，差异仅在myid文件内容。