星火节点计划 Mac 接入文档

本文档主要用于开发和测试目的,通常是由开发者通过 Mac 笔记本接入,我们不建议使用开发用笔记本加入星火节点计划作为长期节点。

1. 系统要求

# Homebrew 安装命令
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. 节点服务器安装步骤

安装 geth(以太坊客户端)

brew tap ethereum/ethereum
brew update
brew install ethereum

更多关于如何在 Mac 下安装 geth 请参考官方文档

安装 NodeJS

brew update
brew install node

安装 ethstats-client 项目

ethstats-client 项目用于实时抓取本地 geth 节点数据,然后通过 WebSocket 提交给节点状态信息统计网站。

克隆项目到 ~/ethstats-client 目录下,然后安装项目的 NPM 依赖包。

cd ~
git clone https://github.com/cubedro/eth-net-intelligence-api ethstats-client
cd ethstats-client
npm install

安装后台进程管理工具

以太坊全数据节点服务器需要确保 geth 和 ethstats-client 一直在后台运行,所以需要一个后台进程管理工具 这里使用官方推荐的 PM2 作为后台进程管理工具

npm install -g pm2

下载 pm2 配置文件 processes.json

cd ~
curl -O https://gist.githubusercontent.com/lgn21st/530faf0f9f31febc6ec5c4e3f0301dca/raw/6f92f74b3f8744e88bc030b86af5f58f3eca73cb/processes.json

编辑 processes.json 文件包括:

  • 修改项目和日志文件路径,需要修改的包括 cmdlog_fileout_fileerror_file 共四个字段,根据实际项目路径修改如 /Users/your_name/ethstats-client/
  • 填写 INSTANCE_NAMECONTACT_DETAILS 信息

3. 后台服务进程管理

pm2 进程管理工具的常用命令

# 载入配置文件并启动后台进程
pm2 start processes.json

# 停止后台进程
pm2 kill

# 查看应用的进程状态以
pm2 status

# 实时日志输出
pm2 logs geth
pm2 logs ethstats-client