如何通过Docker运行带自定义配置的Hyperledger Besu节点

1. 提前准备本地目录结构 #

• 先在本地创建专用的工作目录，用于挂载容器内的配置、数据、日志文件，避免容器销毁后数据丢失：
  mkdir -p besu-node/{config,data,logs}
• 把你写好的config.toml放到刚创建的besu-node/config目录下

2. 最小可用config.toml参考（避免配置错误导致启动失败） #

# 基础网络配置
network="mainnet"
data-path="/opt/besu/data"
# RPC配置
rpc-http-enabled=true
rpc-http-host="0.0.0.0"
rpc-http-cors-origins=["*"]
rpc-http-api=["ETH","NET","WEB3"]
# P2P配置
p2p-host="0.0.0.0"
p2p-port=30303
# 日志配置
logging="INFO"

如果是搭测试网，把network参数对应修改为goerli、sepolia即可；如果部署私链，需要额外把创世文件放到config目录，同时在config.toml中添加genesis-file="/opt/besu/config/genesis.json"参数。

3. 启动容器的两种方式 #

方式一：直接使用docker run命令 #

docker run -d \
  --name besu-node \
  -p 30303:30303 \
  -p 8545:8545 \
  -v $(pwd)/besu-node/config:/opt/besu/config \
  -v $(pwd)/besu-node/data:/opt/besu/data \
  -v $(pwd)/besu-node/logs:/opt/besu/logs \
  hyperledger/besu:latest \
  --config-file=/opt/besu/config/config.toml

如果你当前不在besu-node的上级目录，把$(pwd)替换为你本地的绝对路径即可。

方式二：使用docker-compose部署（更便于管理） #

在besu-node的上级目录创建docker-compose.yml，内容如下：

version: "3.8"
services:
  besu:
    image: hyperledger/besu:latest
    container_name: besu-node
    ports:
      - "30303:30303"
      - "8545:8545"
    volumes:
      - ./besu-node/config:/opt/besu/config
      - ./besu-node/data:/opt/besu/data
      - ./besu-node/logs:/opt/besu/logs
    command: --config-file=/opt/besu/config/config.toml
    restart: unless-stopped

编写完成后执行docker compose up -d即可启动节点。

4. 启动验证与故障排查 #

• 查看容器运行状态：docker ps -a | grep besu-node，如果状态是Exited，说明启动失败，可查看日志排查原因
• 查看节点运行日志：docker logs -f besu-node，常见错误原因包括：
  • 配置文件路径写错，容器内找不到config.toml
  • config.toml语法错误，参数值不符合要求
  • 本地挂载的data目录权限不足，besu进程没有写入权限，遇到该问题执行sudo chmod -R 777 besu-node/data即可
  • 端口被本地其他进程占用，修改端口映射即可
• 验证RPC接口可用：执行curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:8545，正常会返回当前区块高度的十六进制结果

内容的提问来源于stack exchange，提问作者Bhawik chawda