fiews/cl-eth-failover

Chainlink ETH故障转移代理

概述

Chainlink ETH故障转移代理旨在解决Chainlink节点与ETH节点连接的单点依赖问题。通过该代理，Chainlink节点可在多个ETH节点（自有节点或EaaS服务）之间自动故障转移，无需节点处于本地网络，所有端点均通过URL指定。

核心功能

• 自动故障转移：支持任意数量的ETH节点，实现自动切换
• 连接超时控制：具备连接超时机制，确保及时响应
• 区块头通知检查：自动验证是否接收到区块头通知，保障数据同步

使用场景

适用于需要提高Chainlink节点与ETH节点连接稳定性的场景，特别是当依赖多个ETH节点（自有节点或第三方EaaS服务）时，可避免因单一节点故障导致的服务中断。

使用方法

Docker安装

拉取镜像

bash
docker pull fiews/cl-eth-failover

启动容器

基础启动命令（详细使用方法见下文“使用说明”以配置多个端点）：

bash
docker run fiews/cl-eth-failover wss://cl-ropsten.fiews.io/v1/yourApiKey

手动安装

需预先安装Yarn/Node.js及git。

克隆仓库并进入目录

bash
git clone https://github.com/OracleFinder/ChainlinkEthFailover.git && cd ChainlinkEthFailover/

安装依赖

bash
yarn install

设置权限

bash
chmod +x ./index.js

使用说明

代理通过脚本参数接收ETH节点端点，支持传入多个节点。

Docker启动格式

bash
docker run fiews/cl-eth-failover [node-1] [node-2] [...] [node-n]

非Docker启动格式

将docker run fiews/cl-eth-failover替换为node ./index.js：

bash
node ./index.js [node-1] [node-2] [...] [node-n]

示例启动命令

bash
docker run fiews/cl-eth-failover wss://cl-ropsten.fiews.io/v1/myApiKey ws://localhost:8546/

预期输出

Adding endpoint wss://cl-ropsten.fiews.io/v1/myApiKey to list
Adding endpoint ws://localhost:8546/ to list
Server is listening on port :4000

Chainlink配置

要将代理与Chainlink节点配合使用，需将Chainlink节点的ETH_URL环境变量设置为代理实例的4000端口。例如：

ws://localhost:4000/