hyperledger/fabric-zookeeper

Hyperledger Fabric Zookeeper Docker镜像文档

镜像概述

本镜像为Hyperledger Fabric项目提供容器化的Zookeeper服务实现，基于Apache Zookeeper构建，专为Fabric分布式网络环境优化。Zookeeper作为分布式协调服务，在Fabric网络中承担关键角色，确保各节点间的状态同步与协调。

核心功能与特性

• 分布式协调机制：提供可靠的分布式系统协调能力，支持Fabric网络节点间的状态一致性维护
• 服务发现：支持Fabric网络中各组件（如Orderer节点）的动态服务注册与发现
• 配置管理：集中管理Fabric网络的关键配置信息，实现配置的统一分发与更新
• 分布式锁：提供分布式锁机制，确保Fabric网络中关键操作的原子性执行
• Fabric适配优化：针对Fabric网络特性进行参数调优，确保在***环境下的稳定运行

使用场景

• Hyperledger Fabric多节点部署：适用于包含多个Orderer节点或Peer节点的Fabric网络
• Fabric生产环境：为生产级Fabric网络提供稳定的分布式协调服务
• Fabric开发测试：在开发与测试环境中快速搭建具备完整协调能力的Fabric网络
• 高可用Fabric集群：支持构建具备故障转移能力的Fabric集群环境

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name fabric-zookeeper \
  -p 2181:2181 \
  -p 2888:2888 \
  -p 3888:3888 \
  docker.xuanyuan.run/hyperledger/fabric-zookeeper

环境变量配置

Docker Compose配置示例

yaml
version: '2'
services:
  zookeeper:
    image: docker.xuanyuan.run/hyperledger/fabric-zookeeper
    container_name: fabric-zookeeper
    ports:
      - "2181:2181"
      - "2888:2888"
      - "3888:3888"
    environment:
      - ZOOKEEPER_CLIENT_PORT=2181
      - ZOOKEEPER_TICK_TIME=2000
      - ZOOKEEPER_INIT_LIMIT=10
      - ZOOKEEPER_SYNC_LIMIT=5
    volumes:
      - ./zookeeper-data:/data
      - ./zookeeper-datalog:/datalog
    restart: always

数据持久化

通过挂载卷实现数据持久化，避免容器重启导致数据丢失：

• /data: Zookeeper数据存储目录
• /datalog: Zookeeper事务日志目录

集群部署说明

在集群模式下，需配置ZOOKEEPER_SERVERS环境变量指定集群节点，并为每个节点设置唯一的MY_ID（1-255）：

bash
docker run -d \
  --name fabric-zookeeper-1 \
  -p 2181:2181 \
  -p 2888:2888 \
  -p 3888:3888 \
  -e MY_ID=1 \
  -e ZOOKEEPER_SERVERS="server.1=zookeeper-1:2888:3888;2181 server.2=zookeeper-2:2888:3888;2181 server.3=zookeeper-3:2888:3888;2181" \
  hyperledger/fabric-zookeeper