requestnetwork/request-node

Request Node Docker镜像

1. 镜像概述和主要用途

Request Node Docker镜像是Request Network项目官方提供的容器化解决方案，用于简化Request Node的部署、运行和管理流程。该镜像封装了Request Node运行所需的所有依赖环境（如Node.js、相关库及配置模板），旨在为开发者和运维人员提供一致、高效的节点部署体验。

主要用途：
作为Request Network去中心化网络的全节点，负责网络数据同步、交易处理、***状态维护，并对外提供API接口以支持基于Request Network的应用开发与交互。

2. 核心功能和特性

• 简化部署流程：通过Docker容器化技术，消除环境依赖差异，一键启动节点，降低部署复杂度。
• 跨平台兼容：支持在任何安装Docker的操作系统（Linux、macOS、Windows）上运行，确保环境一致性。
• 灵活配置：支持通过环境变量、配置文件挂载等方式自定义节点参数（如网络类型、端口、数据存储路径等）。
• 轻量级设计：基于精简基础镜像构建，减少资源占用，提升运行效率。
• 官方维护：与Request Network项目同步更新，确保功能兼容性和安全性。

注：具体功能细节（如支持的网络协议、数据同步机制等）请参考https://github.com/RequestNetwork/docker-images%E3%80%82

3. 使用场景和适用范围

适用场景

• 开发测试：开发者在本地快速部署Request Node，用于调试基于Request Network的DApp或集成节点API。
• 生产环境部署：企业或节点运营商在服务器集群中部署生产级节点，参与Request Network网络共识或提供服务。
• 自动化运维：集成到CI/CD流程中，实现节点的自动化部署、版本更新和监控。

适用范围

• ***开发者（构建基于Request Network的应用）。
• 网络节点运营商（参与Request Network网络维护）。
• 研究人员（分析网络数据或测试新功能）。

4. 详细的使用方法和配置说明

4.1 前提条件

• 已安装Docker（20.10+版本）和Docker Compose（2.0+版本）。
• 网络环境需开放节点所需端口（具体端口见配置说明）。

4.2 获取镜像

从Docker Hub或GitHub Container Registry拉取官方镜像（以Docker Hub为例）：

bash
docker pull requestnetwork/request-node:latest  # 拉取最新版本
# 或指定版本（如v0.1.0）：
# docker pull requestnetwork/request-node:v0.1.0

4.3 基本使用方法

4.3.1 使用docker run快速启动

以下为基础运行示例（具体参数需根据实际需求调整，详细配置见4.4节）：

bash
docker run -d \
  --name request-node \
  -p 3000:3000  # API端口映射（示例） \
  -p 8545:8545  # RPC端口映射（示例） \
  -v /path/to/local/data:/app/data  # 数据持久化挂载 \
  -e NODE_ENV=production  # 运行环境（production/development） \
  -e NETWORK=mainnet  # 网络类型（mainnet/testnet） \
  -e RPC_URL=https://your-rpc-provider.com  # 外部RPC服务地址（如以太坊节点） \
  requestnetwork/request-node:latest

4.3.2 使用docker-compose部署

创建docker-compose.yml文件，定义节点服务（示例配置）：

yaml
version: '3.8'
services:
  request-node:
    image: requestnetwork/request-node:latest
    container_name: request-node
    restart: always  # 自动重启
    ports:
      - "3000:3000"  # API端口
      - "8545:8545"  # RPC端口
    volumes:
      - ./node-data:/app/data  # 本地数据目录挂载
    environment:
      - NODE_ENV=production
      - NETWORK=mainnet
      - RPC_URL=https://your-rpc-provider.com
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error）
    networks:
      - request-network

networks:
  request-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

4.4 配置说明

4.4.1 核心环境变量

注：完整环境变量列表及说明请参考https://github.com/RequestNetwork/docker-images%E3%80%82

4.4.2 端口映射

节点默认暴露以下端口（需根据配置中的API_PORT和RPC_PORT调整）：

• 3000/tcp：API服务端口（提供节点状态、交易查询等接口）。
• 8545/tcp：RPC服务端口（与外部***节点通信）。

4.4.3 数据持久化

通过-v参数挂载本地目录到容器内DATA_PATH（默认/app/data），确保节点数据（如***状态、配置文件）在容器重启后不丢失。

5. 参考链接

• 官方GitHub仓库（详细使用文档）：https://github.com/RequestNetwork/docker-images
• Request Network官网：[***]