Hyperledger Besu Docker镜像文档

镜像概述和主要用途

概述

Hyperledger Besu是开源企业级以太坊客户端，符合以太坊企业联盟（EEA）规范，支持公共以太坊网络、私有网络及联盟网络。本Docker镜像封装了Besu客户端，提供便捷部署方式，确保环境一致性，简化节点配置与维护，适用于开发、测试及生产环境。

主要用途

• 运行以太坊主网/测试网节点，参与区块链共识与数据同步
• 构建私有以太坊网络，满足企业内部或联盟链业务需求
• 开发、测试基于以太坊的去中心化应用（DApps）
• 部署企业级区块链解决方案，支持隐私交易与权限管理

核心功能和特性

• 多网络兼容：支持以太坊主网、测试网（Goerli、Sepolia等）及自定义私有网络
• 灵活共识机制：兼容工作量证明（PoW）、权威证明（PoA）、IBFT 2.0、QBFT等多种共识算法
• 隐私交易支持：集成Tessera/Constellation隐私管理器，实现交易数据加密与隐私保护
• 权限控制：通过智能合约或节点配置实现网络访问控制与身份管理
• 丰富API接口：提供JSON-RPC（HTTP/WebSocket）、GraphQL接口，支持标准以太坊API及扩展功能
• 监控与可观测性：内置Prometheus指标导出，支持与Grafana等监控工具集成
• 企业级合规：符合EEA规范，满足金融、政务等领域安全合规要求
• 高性能优化：针对存储与网络处理优化，支持高吞吐量业务场景

使用场景和适用范围

适用场景

• 企业区块链应用：金融交易、供应链溯源、数字资产管理等需隐私与权限控制的场景
• 联盟链部署：多机构协作的联盟网络，如跨企业数据共享、行业标准统一
• DApp开发测试：快速搭建本地节点，用于智能合约测试与DApp功能验证
• 基础设施运维：运营公共网络节点，支持区块链生态建设

适用用户

• 企业区块链开发团队
• 区块链基础设施运维人员
• 以太坊DApp开发者
• 科研/教育机构（区块链技术研究与教学）

使用方法和配置说明

获取镜像

通过Docker Hub获取官方镜像：

# 最新版本
docker pull hyperledger/besu:latest

# 指定版本（示例：23.10.0）
docker pull hyperledger/besu:23.10.0

基础使用命令

1. 运行主网节点

docker run -d \
  --name besu-mainnet \
  -p 30303:30303 \  # P2P端口（节点通信）
  -p 8545:8545 \    # HTTP RPC端口（外部调用）
  -v /host/path/to/data:/data \  # 数据持久化目录
  hyperledger/besu:latest \
  --network=mainnet \  # 连接以太坊主网
  --data-path=/data \  # 区块链数据存储路径
  --rpc-http-enabled=true \  # 启用HTTP RPC
  --rpc-http-host=0.0.0.0 \  # RPC绑定所有网络接口
  --rpc-http-cors-origins=*  # 允许跨域请求（开发环境）

2. 运行测试网节点（Goerli）

docker run -d \
  --name besu-goerli \
  -p 30303:30303 \
  -p 8545:8545 \
  -v /host/path/to/goerli/data:/data \
  hyperledger/besu:latest \
  --network=goerli \  # 连接Goerli测试网
  --data-path=/data \
  --rpc-http-enabled=true \
  --rpc-http-host=0.0.0.0 \
  --rpc-http-api=ETH,NET,WEB3  # 启用常用RPC API模块

3. 运行私有网络节点

需提前准备创世文件（定义网络初始状态），示例genesis.json（PoA共识）：

{
  "config": {
    "chainId": 1337,
    "muirGlacierBlock": 0,
    "constantinopleFixBlock": 0,
    "petersburgBlock": 0,
    "ethash": {}
  },
  "nonce": "0x0",
  "timestamp": "0x5f8d78b0",
  "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "gasLimit": "0x1fffffffffffff",
  "difficulty": "0x1",
  "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "coinbase": "***",
  "alloc": {},
  "number": "0x0",
  "gasUsed": "0x0",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

启动私有网络节点命令：

docker run -d \
  --name besu-private \
  -p 30303:30303 \
  -p 8545:8545 \
  -v /host/path/to/genesis.json:/config/genesis.json \  # 挂载创世文件
  -v /host/path/to/private/data:/data \  # 数据持久化
  hyperledger/besu:latest \
  --genesis-file=/config/genesis.json \  # 指定创世文件
  --network-id=1337 \  # 自定义网络ID
  --data-path=/data \
  --rpc-http-enabled=true \
  --rpc-http-host=0.0.0.0 \
  --p2p-host=192.168.1.100  # 节点对外IP（供其他节点连接）

Docker Compose示例（私有PoA网络）

创建docker-compose.yml部署2节点私有网络：

version: '3'
services:
  node1:
    image: hyperledger/besu:latest
    container_name: besu-node1
    ports:
      - "8545:8545"  # RPC端口
      - "30303:30303"  # P2P端口
    volumes:
      - ./genesis.json:/config/genesis.json
      - ./node1/data:/data
    command: >
      --genesis-file=/config/genesis.json
      --network-id=1337
      --data-path=/data
      --rpc-http-enabled=true
      --rpc-http-host=0.0.0.0
      --rpc-http-api=ETH,NET,IBFT
      --p2p-host=node1
      --p2p-port=30303
      -***-enabled=true
      -***-coinbase=***  # 矿工地址

  node2:
    image: hyperledger/besu:latest
    container_name: besu-node2
    ports:
      - "8546:8545"  # 节点2 RPC端口
      - "30304:30303"  # 节点2 P2P端口
    volumes:
      - ./genesis.json:/config/genesis.json
      - ./node2/data:/data
    command: >
      --genesis-file=/config/genesis.json
      --network-id=1337
      --data-path=/data
      --rpc-http-enabled=true
      --rpc-http-host=0.0.0.0
      --rpc-http-api=ETH,NET,IBFT
      --p2p-host=node2
      --p2p-port=30303
      --p2p-bootnodes=enode://<node1-enode-url>  # 替换为node1的enode地址
    depends_on:
      - node1

获取enode地址：启动node1后，执行docker exec -it besu-node1 besu --data-path=/data public-key export --to=/data/enode.txt，从node1/data/enode.txt获取enode地址并更新node2配置。

关键配置参数说明

数据持久化与日志管理

• 数据持久化：通过-v /host/path:/data挂载本地目录，避免容器重启数据丢失
• 日志查看：docker logs -f <容器名>实时查看日志；添加--logging=DEBUG调整日志详细度

验证节点状态

节点启动后，通过RPC接口验证状态：

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

返回当前区块高度，确认节点正常同步。