smartcontract/chainlink

Chainlink 节点镜像文档

镜像概述和主要用途

Chainlink 节点镜像是用于部署 Chainlink 节点的 Docker 镜像。Chainlink 作为中间件，简化***与外部系统的通信，支持智能合约与链下数据及计算资源的安全交互。该镜像封装了 Chainlink Golang 节点（当前为 alpha 版本），旨在为开发者提供部署去中心化预言机网络节点的基础，支持链上智能合约连接至任何链下 API 或计算资源，是构建 Chainlink 去中心化预言机网络的核心组件。

核心功能和特性

• 链上链下通信：实现智能合约与外部 API、链下计算资源的便捷连接。
• 任务调度机制：支持多种链上及链下任务调度方式，满足智能合约的自动化执行需求。
• 自动 Gas 价格调整：动态提升交易 Gas 价格，避免交易阻塞，确保数据及时上链。
• 状态变更通知：通过跟踪***日志，将智能合约状态变化推送至链下系统。
• 数据类型转换：将链下数据类型（如 JSON、XML）转换为 EVM 兼容格式，生成可执行交易。
• 智能合约库支持：提供易于集成的智能合约库，简化与预言机的对接流程。
• 轻量高效：原生跨平台运行，性能优异，内存占用低。

使用场景和适用范围

• 去中心化预言机节点部署：开发者部署 Chainlink 节点，参与去中心化预言机网络，为智能合约提供外部数据。
• 智能合约外部数据集成：需获取链下数据（如市场价格、天气数据、API 结果）的 DeFi、NFT、保险等领域智能合约。
• 自动化任务执行：需定时或触发式执行链上/链下任务的场景（如定期数据更新、条件性交易执行）。
• 跨链通信中间件：作为与外部系统的桥梁，支持多链网络（配置对应链 ID 后兼容及其他 EVM 兼容链）。

安装与配置

依赖要求

• 节点：需接入运行中的节点（支持 websocket 连接），兼容版本：
  • Parity 1.11+（需支持 pubsub 功能）
  • Geth 1.8+
• 网络环境：节点需联网访问***节点及外部 API（根据任务配置）。

环境变量配置

Chainlink 节点通过环境变量配置，关键参数如下（完整列表见 官方文档）：

使用方法

拉取镜像

bash
docker pull smartcontractkit/chainlink:latest

基本运行命令（Docker Run）

bash
docker run -d \
  --name chainlink-node \
  -p 6688:6688 \  # 映射 API 端口
  -v chainlink-data:/chainlink/data \  # 挂载数据卷（持久化节点数据）
  -e ETH_URL=ws://ethereum-node:8546 \  # 以太坊节点 WS 地址
  -e CHAIN_ID=1 \  # 以太坊主网
  -e CHAINLINK_DEV=false \  # 生产环境启用 TLS
  smartcontractkit/chainlink:latest \
  local node  # 启动节点命令

Docker Compose 部署示例

yaml
version: '3'

services:
  chainlink:
    image: smartcontractkit/chainlink:latest
    container_name: chainlink-node
    ports:
      - "6688:6688"
    volumes:
      - chainlink-data:/chainlink/data
    environment:
      - ETH_URL=ws://geth:8546  # 连接同网络中的 Geth 节点
      - CHAIN_ID=5  # Goerli 测试网
      - CHAINLINK_DEV=true  # 测试环境禁用 TLS
      - LOG_LEVEL=debug
    depends_on:
      - geth  # 依赖 Geth 节点

  geth:  # 以太坊节点（测试用，生产环境建议使用独立节点）
    image: ethereum/client-go:v1.10.0
    container_name: geth-node
    command: --goerli --ws --ws.addr 0.0.0.0 --ws.port 8546 --ws.api eth,net,web3
    ports:
      - "8546:8546"
    volumes:
      - geth-data:/root/.ethereum

volumes:
  chainlink-data:
  geth-data:

节点管理命令

容器启动后，可通过 docker exec 执行节点 CLI 命令：

• 查看节点帮助：

  bash
  docker exec -it chainlink-node chainlink help
  

• 查看当前任务：

  bash
  docker exec -it chainlink-node chainlink jobspecs
  

• 查看任务详情（替换 <JOB_ID>）：

  bash
  docker exec -it chainlink-node chainlink show <JOB_ID>
  

外部适配器（External Adapters）

外部适配器是 Chainlink 节点的扩展组件，通过 REST API 与节点通信，支持自定义计算逻辑或特定 API 集成。开发者可通过外部适配器扩展节点能力，例如对接私有数据库、实现复杂数据处理等。

集成方式：

1. 部署外部适配器服务（独立 HTTP 服务）。
2. 在 Chainlink 任务规范（Job Spec）中配置适配器 URL 及参数。

详见 https://github.com/smartcontractkit/chainlink/wiki/External-Adapters%E3%80%82

数据持久化与备份

Chainlink 节点数据（包括任务配置、数据库、密钥等）存储在 /chainlink/data 目录，通过 Docker 卷挂载实现持久化。建议定期备份该目录数据，避免节点迁移或故障导致数据丢失。

注意事项

• 安全配置：生产环境中需启用 TLS（默认启用，CHAINLINK_DEV=false），并妥善保管节点密钥（位于数据卷中）。
• 节点可靠性：确保节点同步至最新区块，网络连接稳定，避免因节点延迟影响 Chainlink 任务执行。
• 资源需求：根据任务数量和频率调整容器资源（CPU/内存），建议至少 2GB 内存，确保任务处理效率。