hyperledger/fabric-couchdb

Hyperledger Fabric CouchDB Docker镜像文档

镜像概述

该Docker镜像是Hyperledger Fabric项目官方提供的CouchDB数据库镜像，专门用于作为Fabric***网络的状态数据库。CouchDB作为一种文档型数据库，提供了比Fabric默认LevelDB更丰富的数据查询能力，支持JSON格式数据存储和复杂条件查询，适用于需要对链上数据进行灵活检索的场景。

核心功能和特性

• 富查询支持：提供基于CouchDB查询语言的复杂查询能力，支持条件过滤、排序、分页等操作
• JSON数据模型：原生支持JSON格式数据存储，与Fabric链码数据结构天然兼容
• Fabric集成优化：针对Fabric网络特性进行适配，确保与***状态数据的同步和一致性
• 持久化存储：支持数据持久化，可通过挂载卷实现数据持久化保存
• 可配置性：提供多种配置参数，支持用户根据需求调整数据库性能和安全策略
• 高兼容性：兼容Hyperledger Fabric各主要版本，确保跨版本部署稳定性

使用场景和适用范围

• 需要复杂数据查询的Fabric网络：当链码需要执行多条件查询、范围查询或聚合查询时
• 企业级*应用**：适用于需要对链上业务数据进行灵活分析和检索的企业场景
• 开发与测试环境：可作为Fabric网络开发、测试阶段的状态数据库，简化环境配置
• 生产环境部署：支持通过适当配置满足生产级别的性能和安全要求

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name fabric-couchdb \
  -p 5984:5984 \
  -e COUCHDB_USER=admin \
  -e COUCHDB_PASSWORD=password \
  -v /path/to/local/data:/opt/couchdb/data \
  docker.xuanyuan.run/hyperledger/fabric-couchdb

Docker Compose配置示例

yaml
version: '2'
services:
  couchdb:
    image: docker.xuanyuan.run/hyperledger/fabric-couchdb
    container_name: fabric-couchdb
    ports:
      - "5984:5984"
    environment:
      - COUCHDB_USER=admin
      - COUCHDB_PASSWORD=password
    volumes:
      - couchdb_data:/opt/couchdb/data
    networks:
      - fabric_network

networks:
  fabric_network:

volumes:
  couchdb_data:

核心环境变量配置

与Fabric网络集成

在Fabric网络配置中，需在peer节点配置中指定CouchDB作为状态数据库：

yaml
peer:
  couchdb:
    address: couchdb:5984
    username: admin
    password: password
  stateDb:
    type: CouchDB

数据持久化

通过挂载本地目录到容器内/opt/couchdb/data目录实现数据持久化，确保容器重启后数据不丢失：

bash
-v /your/local/data/path:/opt/couchdb/data

访问数据库

启动后可通过以下URL访问CouchDB管理界面：

http://localhost:5984/_utils/

使用配置的用户名和密码登录后，可查看和管理Fabric网络的状态数据。