一、环境准备与Docker基础

1.1 Docker安装与验证

在部署ZooKeeper前，需确保系统已安装Docker。以Ubuntu 22.04为例，执行以下命令安装：

# 更新软件包索引
sudo apt update
# 安装依赖
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 添加Docker APT仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安装Docker
sudo apt update
sudo apt install -y docker-ce
# 验证安装
sudo docker run hello-world

输出Hello from Docker!表示安装成功。

1.2 端口与资源分配

ZooKeeper默认使用2181端口（客户端连接）、2888端口（节点间通信）、3888端口（选举），需确保这些端口未被占用。可通过netstat -tuln或ss -tuln检查端口状态。

二、ZooKeeper Docker镜像选择

2.1 官方镜像与版本

推荐使用ZooKeeper官方维护的Docker镜像zookeeper:latest（当前最新稳定版）。镜像包含预配置的ZooKeeper服务，无需手动编译。拉取命令：

docker pull zookeeper:latest

可通过docker images查看已下载的镜像。

2.2 第三方镜像对比

社区存在如bitnami/zookeeper等第三方镜像，提供额外功能（如自动配置、备份工具），但可能引入兼容性风险。对于单机部署，官方镜像足够且维护更及时。

三、单机Docker部署步骤

3.1 基础启动命令

最简单的启动方式：

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

• --name zookeeper：指定容器名称
• -d：后台运行
• -p 2181:2181：端口映射（主机:容器）

3.2 持久化数据配置

默认情况下，容器删除后数据会丢失。需挂载主机目录到容器内：

mkdir -p /data/zookeeper
docker run --name zookeeper \
  -d \
  -p 2181:2181 \
  -v /data/zookeeper:/data \
  zookeeper

ZooKeeper将数据存储在/data目录下，通过-v参数实现持久化。

3.3 自定义配置文件

若需修改zoo.cfg（如调整tickTime、maxClientCnxns），可创建自定义配置文件并挂载：

# 创建配置目录并写入zoo.cfg
mkdir -p /config/zookeeper
cat > /config/zookeeper/zoo.cfg <<EOF
tickTime=2000
dataDir=/data
clientPort=2181
maxClientCnxns=60
EOF
# 启动容器并挂载配置
docker run --name zookeeper \
  -d \
  -p 2181:2181 \
  -v /data/zookeeper:/data \
  -v /config/zookeeper/zoo.cfg:/conf/zoo.cfg \
  zookeeper

四、ZooKeeper单机启动验证

4.1 客户端连接测试

使用telnet或nc测试端口连通性：

telnet localhost 2181
# 或
nc -zv localhost 2181

连接成功后，使用ZooKeeper命令行工具（zkCli.sh）交互：

docker exec -it zookeeper zkCli.sh -server 127.0.0.1:2181
# 在客户端中执行
ls /
create /test_node "hello"
get /test_node

4.2 日志与状态检查

查看容器日志：

docker logs zookeeper

正常启动日志应包含：

2023-10-01 12:00:00,000 [myid:] - INFO  [main:QuorumPeerConfig@174] - Reading configuration from: /conf/zoo.cfg
2023-10-01 12:00:00,000 [myid:] - INFO  [main:ZooKeeperServerMain@122] - Starting server

五、常见问题与优化

5.1 端口冲突解决

若2181端口被占用，修改映射端口：

docker run --name zookeeper \
  -d \
  -p 22181:2181 \
  zookeeper

客户端连接时需指定新端口：

zkCli.sh -server 127.0.0.1:22181

5.2 性能调优参数

• tickTime：心跳间隔（默认2000ms），网络延迟高时可适当增大
• initLimit：初始同步超时（默认10倍tickTime）
• syncLimit：请求响应超时（默认5倍tickTime）

示例配置：

cat > /config/zookeeper/zoo.cfg <<EOF
tickTime=3000
initLimit=10
syncLimit=5
dataDir=/data
clientPort=2181
EOF

5.3 安全加固建议

• 限制客户端IP访问：通过防火墙规则（如iptables）或网络策略
• 启用ACL认证：修改zoo.cfg添加authProvider.1=org.apache.zookeeper.server.auth.DigestAuthenticationProvider，并配置用户密码

六、总结与扩展

通过Docker部署ZooKeeper单机服务，可快速实现环境隔离与资源控制。本文覆盖了从环境准备到高级配置的全流程，适用于开发测试环境。对于生产环境，建议进一步考虑：

1. 集群部署（至少3节点）
2. 监控集成（如Prometheus+Grafana）
3. 备份策略（定期快照）

附：完整部署脚本

#!/bin/bash
# 创建数据目录
mkdir -p /data/zookeeper
# 创建配置文件
cat > /config/zookeeper/zoo.cfg <<EOF
tickTime=2000
dataDir=/data
clientPort=2181
maxClientCnxns=60
EOF
# 启动容器
docker run --name zookeeper \
  -d \
  --restart unless-stopped \
  -p 2181:2181 \
  -v /data/zookeeper:/data \
  -v /config/zookeeper/zoo.cfg:/conf/zoo.cfg \
  zookeeper
# 验证状态
sleep 5
docker logs zookeeper | grep "Starting server"
if [ $? -eq 0 ]; then
  echo "ZooKeeper启动成功"
else
  echo "ZooKeeper启动失败"
  exit 1
fi