tobilg/zookeeper

Zookeeper 3.4.6

镜像概述

本Docker镜像运行Zookeeper 3.4.6服务器，支持单机模式和集群模式部署。通过环境变量可动态配置集群节点，适用于开发测试和生产环境的分布式协调服务需求。

核心功能与特性

• 单机模式支持：无需额外配置即可快速启动独立Zookeeper实例
• 集群模式支持：通过ZOOKEEPER_HOSTS环境变量配置集群节点列表，实现分布式部署
• 自动配置：根据LOCAL_ZK_IP和ZOOKEEPER_HOSTS自动生成myid文件，无需手动配置节点标识
• 端口映射：需暴露2181（客户端连接）、2888（follower与leader通信）、3888（选举通信）端口

使用场景

• 开发测试环境：快速部署单机Zookeeper实例，用于应用开发调试
• 生产环境：配置多节点集群，提供高可用的分布式协调服务，支持分布式锁、服务注册发现等场景

使用方法与配置说明

单机模式部署

直接启动容器，无需集群配置：

bash
docker run -d \
    --name zookeeper \
    --net=host \
    -p 2181:2181 \
    -p 2888:2888 \
    -p 3888:3888 \
    docker.xuanyuan.run/tobilg/zookeeper

集群模式部署

通过ZOOKEEPER_HOSTS环境变量指定集群节点（格式：host:2888:3888，多节点用逗号分隔），并通过LOCAL_ZK_IP指定当前节点IP。

Debian/Ubuntu系统

bash
docker run -d \
    --name zookeeper \
    --net=host \
    -e ZOOKEEPER_HOSTS=192.168.0.1:2888:3888,192.168.0.2:2888:3888,192.168.0.3:2888:3888 \
    -e LOCAL_ZK_IP=$(/usr/bin/ip -o -4 docker.xuanyuan.run/addr list eth0 | grep global | awk '{print $4}' | cut -d: -f1) \
    -p 2181:2181 \
    -p 2888:2888 \
    -p 3888:3888 \
    tobilg/zookeeper

RedHat/CentOS/Fedora系统

替换LOCAL_ZK_IP获取命令：

bash
docker run -d \
    --name zookeeper \
    --net=host \
    -e ZOOKEEPER_HOSTS=192.168.0.1:2888:3888,192.168.0.2:2888:3888,192.168.0.3:2888:3888 \
    -e LOCAL_ZK_IP=$(/sbin/ifconfig docker.xuanyuan.run/eth0 | grep 'inet ' | awk '{print $2}') \
    -p 2181:2181 \
    -p 2888:2888 \
    -p 3888:3888 \
    tobilg/zookeeper

配置参数说明

• ZOOKEEPER_HOSTS：集群节点列表，格式为host:2888:3888，多节点用逗号分隔。示例：192.168.0.1:2888:3888,192.168.0.2:2888:3888
• LOCAL_ZK_IP：当前节点IP地址，用于匹配ZOOKEEPER_HOSTS中的节点，自动生成myid文件（Zookeeper集群节点标识）
• 端口说明：
  • 2181：客户端连接端口
  • 2888：follower与leader通信端口
  • 3888：集群选举通信端口

注意：eth0需替换为实际使用的公网网络接口名称。集群配置详细说明参见http://zookeeper.apache.org/doc/trunk/zookeeperStarted.html#sc_RunningReplicatedZooKeeper