availj/avail-light

镜像概述

Avail轻客户端镜像（Avail light client）是用于接入Avail网络的轻量级节点解决方案，旨在提供低资源消耗的数据同步与网络参与能力。该镜像封装了Avail轻客户端核心组件，支持开发者、节点运营商在资源受限环境中快速部署轻节点，实现数据可用性验证、链上数据查询及网络共识交互等功能。

核心功能与特性

• 数据可用性验证：支持Avail***数据可用性证明（DA Proof）验证，确保链上数据完整性。
• 轻量级同步：采用优化的同步机制，仅同步关键***数据，减少带宽和存储资源占用。
• 低资源消耗：相比全节点大幅降低CPU、内存及磁盘需求，适用于边缘设备或资源受限环境。
• 网络兼容性：支持连接Avail主网、测试网及本地开发网络，兼容标准***RPC接口。
• 配置灵活：通过环境变量和配置文件支持自定义网络参数、日志级别及同步策略。

使用场景

• 开发者测试：本地开发环境中快速部署轻节点，用于DApp测试、智能合约交互验证。
• 个人节点：个人用户在低配置设备（如树莓派、个人PC）上运行，参与网络数据验证。
• 资源受限环境：边缘计算设备、嵌入式系统或云服务器低配实例中部署轻量级节点。
• 网络监控：作为轻量级监控节点，实时同步***状态并输出关键网络指标。

使用方法### 基础部署（Docker Run）

通过以下命令快速启动Avail轻客户端容器：

bash
docker run -d \
  --name avail-light-client \
  -p 30333:30333 \  # P2P网络端口
  -p 9944:9944 \    # WebSocket RPC端口
  -e RPC_URL="wss://avail-mainnet-rpc.example.com" \  # Avail网络RPC端点
  -e LOG_LEVEL="info" \  # 日志级别（debug/info/warn/error）
  -e NETWORK="mainnet" \  # 网络类型（mainnet/testnet/local）
  avail/light-client:latest

Docker Compose配置

创建docker-compose.yml文件实现持久化部署：

yaml
version: '3'
services:
  avail-light-client:
    image: avail/light-client:latest
    container_name: avail-light-client
    ports:
      - "30333:30333"
      - "9944:9944"
    environment:
      - RPC_URL="wss://avail-testnet-rpc.example.com"
      - LOG_LEVEL="info"
      - NETWORK="testnet"
      - SYNC_MODE="light"  # 同步模式（light/fast）
    volumes:
      - ./data:/app/data  # 数据持久化目录
    restart: unless-stopped

启动容器：docker-compose up -d

配置参数### 环境变量

命令行参数

启动容器时可通过命令行参数覆盖默认配置（优先级高于环境变量）：

bash
docker run avail/light-client:latest --rpc-url wss://custom-rpc.example.com --log-level debug

注意事项

• 首次启动需同步初始***数据，同步时间取决于网络状况及节点连接数。
• 生产环境建议挂载持久化卷（如示例中./data），避免容器重启后数据丢失。
• 低配置设备建议设置LOG_LEVEL=warn以减少日志IO开销。
• 确保网络环境开放P2P端口（默认30333），否则可能影响节点连接数及同步效率。