如何快速搭建Ink Node节点：完整的Docker部署与监控指南

【免费下载链接】node How to run an Ink Node 项目地址: https://gitcode.com/GitHub_Trending/node76/node

Ink Node是一个基于Docker Compose的简易部署脚本，用于快速启动Ink链的全节点或归档节点。本文将详细介绍从环境准备到节点运维的完整流程，帮助新手用户轻松部署和管理自己的Ink Node节点。

📋 推荐硬件配置

主网节点

• 内存：16GB+ RAM
• 存储：2TB SSD（推荐NVMe）
• 网络：100mb/s+ 下载速度

测试网节点

• 内存：16GB+ RAM
• 存储：500GB SSD（推荐NVMe）
• 网络：100mb/s+ 下载速度

🔧 安装与配置步骤

安装Docker和Docker Compose

注意：以下命令适用于Ubuntu系统。Windows和Mac用户请使用Docker Desktop，其他操作系统请参考官方文档。

# 更新系统包
sudo apt-get update
sudo apt-get upgrade -y

# 安装Docker依赖
sudo apt-get install -y curl gnupg ca-certificates lsb-release

# 添加Docker GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 添加Docker软件源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker和Docker Compose
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 将当前用户添加到docker组
sudo usermod -aG docker $(whoami)

# 验证安装
sudo docker run hello-world

克隆仓库

git clone https://gitcode.com/GitHub_Trending/node76/node
cd node

配置环境变量

复制环境变量示例文件并进行必要配置：

cp .env.example .env

使用文本编辑器打开.env文件，配置以下必填项：

• NETWORK_NAME：选择网络类型
  • ink-sepolia（测试网）
  • ink-mainnet（主网）
• NODE_TYPE：选择节点类型
  • full（全节点）- 存储最近区块，无历史状态
  • archive（归档节点）- 存储完整区块链历史
• OP_NODE__RPC_ENDPOINT：L1 RPC端点（如Ethereum主网）
• OP_NODE__L1_BEACON：L1信标链端点
• OP_NODE__RPC_TYPE：RPC服务提供商类型（alchemy/quicknode/erigon/basic）

🚀 节点操作指南

启动节点

docker compose up -d --build

参数说明：

• -d：后台运行
• --build：确保应用最新更改

查看日志

# 查看所有容器日志
docker compose logs -f --tail 10

# 查看特定容器日志（如op-geth）
docker compose logs op-geth -f --tail 10

常用容器名称：

• op-geth：执行客户端
• op-node：节点服务
• bedrock-init：初始化服务

停止节点

docker compose down

此命令不会删除数据卷，可安全重启节点。

重启节点

docker compose restart

升级节点

git pull
docker compose pull
docker compose up -d --build

清除数据（危险操作）

docker compose down -v

⚠️ 此命令会删除所有节点数据，请谨慎操作！

📊 节点监控

同步进度估算

使用项目提供的progress.sh脚本估算同步剩余时间：

./progress.sh

输出示例：

Chain ID: 57073
Please wait
Blocks per minute: ...
Hours until sync is completed: ...

Grafana监控面板

Grafana服务默认暴露在http://localhost:3000，预置了"Simple Node Dashboard"监控面板。

登录信息：

• 用户名：admin
• 密码：ink

监控面板包含节点基本信息、同步状态和状态根故障检测等关键指标。

🛠️ 故障排除

"Walking back L1Block"错误

若遇到持续的"L1Block"错误，尝试以下解决方法：

1. 等待几分钟，通常该问题会自行解决
2. 重启节点：docker compose down 后 docker compose up -d --build

⚙️ 项目文件结构

• 部署脚本：docker-compose.yml
• 环境配置：envs/
  • 主网配置：envs/ink-mainnet/
  • 测试网配置：envs/ink-sepolia/
• 启动脚本：scripts/
  • 初始化脚本：scripts/init-bedrock.sh
  • 启动脚本：scripts/start-op-geth.sh
• 监控配置：docker/grafana/
  • 仪表盘配置：docker/grafana/dashboards/simple_node_dashboard.json

【免费下载链接】node How to run an Ink Node 项目地址: https://gitcode.com/GitHub_Trending/node76/node