手把手教你用Docker部署Zookeeper

一、准备工作：确认Docker环境并拉取Zookeeper镜像

确认你的服务器已安装Docker，运行 docker --version 查看版本。
如果未安装，可参考官方文档或使用以下命令快速安装：curl -fsSL https://get.docker.com | bash。
接着拉取Zookeeper官方镜像：docker pull zookeeper:3.8。
可以指定版本，建议使用3.7或3.8稳定版。
拉取完成后用 docker images 确认镜像存在。

二、单节点快速部署：一条命令启动Zookeeper

启动一个单机版Zookeeper容器非常简单，执行：

docker run -d --name my-zookeeper -p 2181:2181 zookeeper:3.8

• -d 后台运行
• --name 指定容器名
• -p 2181:2181 将宿主机的2181端口映射到容器内的2181端口

启动后运行 docker logs my-zookeeper 查看启动日志，出现 Started AdminServer on port 8080 表示成功。
如果你需要持久化数据，可以挂载数据卷：

docker run -d --name my-zookeeper -p 2181:2181 -v /data/zookeeper/data:/data -v /data/zookeeper/datalog:/datalog zookeeper:3.8

这样即使容器删除，数据仍保留在宿主机 /data/zookeeper 目录下。

三、伪集群部署：本地搭建3节点Zookeeper集群

伪集群就是在一台机器上启动多个Zookeeper实例，通过不同端口区分。
首先创建一个自定义网络：docker network create zk-net。
然后分别启动三个容器，注意每个容器需要分配不同的端口和myid。
以下是启动脚本示例（假设宿主机IP为192.168.1.100）：

# 节点1
docker run -d --name zk1 --network zk-net -e ZOO_MY_ID=1 -e ZOO_SERVERS="server.1=0.0.0.0:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=zk3:2888:3888;2181" -p 2181:2181 zookeeper:3.8
# 节点2
docker run -d --name zk2 --network zk-net -e ZOO_MY_ID=2 -e ZOO_SERVERS="server.1=zk1:2888:3888;2181 server.2=0.0.0.0:2888:3888;2181 server.3=zk3:2888:3888;2181" -p 2182:2181 zookeeper:3.8
# 节点3
docker run -d --name zk3 --network zk-net -e ZOO_MY_ID=3 -e ZOO_SERVERS="server.1=zk1:2888:3888;2181 server.2=zk2:2888:3888;2181 server.3=0.0.0.0:2888:3888;2181" -p 2183:2181 zookeeper:3.8

注意：ZOO_SERVERS 内用 ;2181 格式指定客户端端口，Docker镜像的默认客户端端口是2181。0.0.0.0 代表本机监听。
启动后等待几秒，查看每个容器的日志确认集群选举完成。

四、避坑指南：常见问题与解决方法

• 端口冲突：如果你宿主机上已经有其他服务占用2181、2888、3888端口，可以修改 -p 映射的宿主机端口，但容器内端口不要改。
• 数据卷权限：挂载宿主机的目录时，Zookeeper运行用户是uid=1000，需要确保目录可写。可以 chown 1000:1000 /data/zookeeper/data。
• 集群无法形成：检查各容器是否在同一网络，docker network inspect zk-net 查看容器IP。确保 ZOO_SERVERS 中的主机名解析正确（使用容器名即可）。
• 日志报错 Cannot open channel to X at election address：通常是网络不通或端口未开放，确认防火墙放行2888和3888端口（如果是云服务器需在安全组添加规则）。

五、验证方法：确认Zookeeper集群健康

执行以下命令验证单节点或集群状态：

1. 进入任意容器：docker exec -it zk1 bash
2. 运行四字命令：echo stat | nc localhost 2181 查看角色（Mode: leader/follower）和连接数。
3. 使用Zookeeper客户端：zkCli.sh -server 127.0.0.1:2181，连接后输入 ls / 列出根节点，正常返回 []。
4. 检查集群存活：echo srvr | nc 127.0.0.1 2181 或通过 docker logs zk2 看到 LEADING 或 FOLLOWING 状态。

如果所有节点角色正确且无异常日志，说明Docker部署Zookeeper成功。

总结

本文从零开始演示了Docker部署Zookeeper的全流程，包括单节点和伪集群搭建，并给出了常见问题的解决方案。
亲自操作一遍后，你就能掌握Docker化Zookeeper的核心要点。
遇到问题时优先检查网络、端口和日志，大部分问题都能快速定位。
如果你需要在生产环境使用，建议将数据持久卷和内存限制等参数做进一步优化。