alethio/ethstats-cli

ethstats-cli 概述

ethstats-cli是EthStats的命令行客户端，通过RPC连接节点提取数据，并发送至EthStats服务器进行数据分析与监控，支持主网及测试网节点。

核心功能

• 连接***节点（Geth、Parity、Besu等）提取性能与状态数据
• 向EthStats服务器发送数据用于网络监控与分析
• 节点注册与恢复功能，支持非交互式注册
• 可作为守护进程持续运行
• 支持Docker部署，方便容器化环境使用

使用场景

• ***节点运维人员监控节点CPU、内存负载及网络状态
• 开发者分析***主网或测试网（Rinkeby、Görli）节点数据
• 个人节点持有者参与EthStats网络监控平台

配置说明

安装（非Docker方式）

通过npm或yarn全局安装：

sh
npm install -g ethstats-cli
# 或
yarn global add ethstats-cli

运行与注册

首次运行需注册节点，非交互式注册示例：

sh
ethstats-cli --register --account-email your@email.com --node-name your_node_name

默认连接本地节点（http://localhost:8545），可通过`--client-url`指定远程节点地址。

Docker部署

1. 创建配置持久化目录：

sh
mkdir /opt/ethstats-cli

2. 运行Docker容器：

sh
docker run -d \
--restart always \
--net host \
-v /opt/ethstats-cli/:/root/.config/configstore/ \
alethio/ethstats-cli --register --account-email your@email.com --node-name your_node_name

守护进程运行

使用ethstats-daemon命令管理守护进程：

sh
ethstats-daemon start # 启动守护进程
ethstats-daemon stop  # 停止守护进程

配置文件

注册成功后生成配置文件~/.config/configstore/ethstats-cli.json，保存节点名称、密钥及CLI选项配置。

节点恢复

若丢失配置文件，可通过交互式模式选择"Existing node"，输入注册***获取恢复哈希完成节点恢复。

CLI选项

关键选项包括：

• --net：指定***网络（mainnet/rinkeby/goerli）
• --client-url：设置节点RPC地址
• --register：非交互式注册节点
• --verbose：输出详细日志

MIT 许可 | Alethio