testinprod/op-erigon

Erigon Docker 镜像文档

镜像概述

Erigon 是一个高性能、资源优化的客户端实现，专注于提升同步速度和降低硬件资源占用。本 Docker 镜像封装了 Erigon 客户端，提供了便捷的部署和运行方式，适用于网络节点部署、开发测试环境搭建等场景。

核心功能与特性

• 高性能同步：采用优化的数据处理管道，显著提升区块同步速度
• 低资源占用：相比传统客户端大幅减少磁盘空间和内存使用
• 完整节点支持：支持***主网及测试网的完整节点功能
• 模块化架构：可选择性启用历史数据索引、JSON-RPC 服务等模块
• 数据压缩：内置高效的数据压缩算法，降低存储需求
• 实时监控：提供 Prometheus 指标接口，便于性能监控和问题诊断

使用场景

• 部署***全节点，参与网络验证与数据存储
• 开发环境中的本地***测试节点
• ***数据分析平台的后端数据来源
• 构建基于***的私有链或联盟链基础设施
• 搭建***浏览器的后端支撑服务

使用方法

基础使用

快速启动（主网全节点）

bash
docker run -d \
  --name erigon-mainnet \
  -p 30303:30303/tcp \
  -p 30303:30303/udp \
  -v erigon-data:/home/erigon/.local/share/erigon \
  erigon:latest \
  erigon --http --http.addr 0.0.0.0

使用 Docker Compose

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  erigon:
    image: erigon:latest
    container_name: erigon
    restart: unless-stopped
    ports:
      - "30303:30303/tcp"
      - "30303:30303/udp"
      - "8545:8545"  # HTTP-RPC
      - "8551:8551"  # Engine API
      - "6060:6060"  # Metrics
    volumes:
      - erigon-data:/home/erigon/.local/share/erigon
    command: >
      erigon
      --http
      --http.addr 0.0.0.0
      --http.port 8545
      --http.vhosts=*
      --metrics
      --metrics.addr 0.0.0.0
      --metrics.port 6060
    environment:
      - TZ=UTC
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  erigon-data:

启动服务：

bash
docker-compose up -d

配置说明

环境变量

核心命令参数

网络选择

***主网

bash
docker run -d \
  --name erigon-mainnet \
  -p 30303:30303/tcp \
  -p 30303:30303/udp \
  -p 8545:8545 \
  -v erigon-mainnet-data:/home/erigon/.local/share/erigon \
  erigon:latest \
  erigon --chain mainnet --http --http.addr 0.0.0.0

Goerli 测试网

bash
docker run -d \
  --name erigon-goerli \
  -p 30303:30303/tcp \
  -p 30303:30303/udp \
  -p 8545:8545 \
  -v erigon-goerli-data:/home/erigon/.local/share/erigon \
  erigon:latest \
  erigon --chain goerli --http --http.addr 0.0.0.0

数据持久化

Erigon ***数据默认存储在容器内的 /home/erigon/.local/share/erigon 目录。为确保数据持久化，推荐使用 Docker 卷或绑定挂载：

bash
# 使用 Docker 卷（推荐）
docker volume create erigon-data
docker run -d --name erigon -v erigon-data:/home/erigon/.local/share/erigon erigon:latest

# 或使用绑定挂载
mkdir -p /path/on/host/erigon-data
docker run -d --name erigon -v /path/on/host/erigon-data:/home/erigon/.local/share/erigon erigon:latest

性能优化配置

对于生产环境部署，建议使用以下优化参数：

bash
docker run -d \
  --name erigon-optimized \
  --ulimit nofile=1048576:1048576 \
  --memory=16g \
  -p 30303:30303/tcp \
  -p 30303:30303/udp \
  -p 8545:8545 \
  -v erigon-data:/home/erigon/.local/share/erigon \
  erigon:latest \
  erigon \
  --chain mainnet \
  --http --http.addr 0.0.0.0 \
  --http.api eth,net,web3,debug,trace \
  --metrics --metrics.addr 0.0.0.0 \
  --batchSize 1024m \
  --db.pagesize 16k \
  --cache 8192 \
  --private.api.addr 0.0.0.0:9090

维护与监控

查看日志

bash
# 实时查看日志
docker logs -f erigon

# 查看最近100行日志
docker logs --tail=100 erigon

性能监控

启用 metrics 后，可通过 http://<容器IP>:6060/debug/metrics/prometheus 访问 Prometheus 指标。

推荐使用 Prometheus + Grafana 监控栈，Erigon 官方提供了 Grafana 仪表板模板。

数据备份

bash
# 创建数据备份
docker exec erigon tar -czf /tmp/erigon-backup.tar.gz -C /home/erigon/.local/share/erigon .

# 复制备份到主机
docker cp erigon:/tmp/erigon-backup.tar.gz /path/on/host/erigon-backup.tar.gz

升级镜像

bash
# 拉取最新镜像
docker pull erigon:latest

# 停止并删除旧容器
docker stop erigon && docker rm erigon

# 使用新镜像启动
docker run -d --name erigon [原有参数] erigon:latest

常见问题解决

同步速度慢

• 确保网络连接稳定，P2P 端口（30303）已正确映射
• 增加内存分配（--cache 参数）
• 启用快照同步（--snapshots=true）
• 检查磁盘 I/O 性能，使用 SSD 可显著提升同步速度

磁盘空间不足

• 清理过时数据：docker exec erigon erigon prune
• 考虑使用 --prune 参数启用自动修剪
• 迁移到更大容量的存储设备

RPC 连接问题

• 检查 --http.addr 是否设置为 0.0.0.0（允许外部访问）
• 确认 --http.vhosts 包含访问域名
• 验证防火墙规则是否允许访问 RPC 端口

参考链接

• 官方文档: https://github.com/ledgerwatch/erigon/wiki
• GitHub 仓库: https://github.com/ledgerwatch/erigon
• 社区论坛: [***]
• 网络状态: []