如何快速搭建Ink Node节点：从安装到运行的完整指南

如何快速搭建Ink Node节点：从安装到运行的完整指南

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

Ink Node是一个基于Docker Compose的简易脚本，用于快速部署Ink链的全节点或归档节点。本文将为你提供从环境准备到节点运行的详细步骤，帮助你轻松搭建自己的Ink Node节点。

📋 推荐硬件配置

主网（Mainnet）

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

测试网（Testnet）

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

🔧 安装与配置步骤

1. 安装Docker和Docker Compose

注意：如果你不是以root用户登录，安装完成后需要注销并重新登录以完成Docker配置。

以下命令适用于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

（非root用户）重新登录后，运行以下命令测试Docker是否正常工作：

docker ps

如果返回空容器列表且无错误，则安装成功。如有错误，请尝试重启机器。

2. 克隆仓库

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

3. 配置环境变量

复制环境变量示例文件并编辑：

cp .env.example .env

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

• NETWORK_NAME：选择网络层
  • ink-sepolia（测试网）
  • ink-mainnet（主网）
• NODE_TYPE：选择节点类型
  • full（全节点）：仅包含最近区块，无历史状态
  • archive（归档节点）：存储完整区块链历史，包括历史状态
• OP_NODE__RPC_ENDPOINT：Layer 1 RPC端点（如以太坊主网，可使用Quicknode等服务）
• OP_NODE__L1_BEACON：Layer 1信标链端点（如Quicknode的信标链端点）
• OP_NODE__RPC_TYPE：RPC服务提供商类型
  • alchemy、quicknode、erigon或basic

可选配置：

• OP_GETH__SYNCMODE：同步模式（默认snap，归档节点推荐full）
• IMAGE_TAG__[...]：自定义Docker镜像标签
• PORT__[...]：自定义服务端口

🚀 节点操作指南

启动节点

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

需要安装Foundry工具集（安装指南），输出示例：

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

Grafana监控面板

Grafana默认暴露在http://localhost:3000，内置"Simple Node Dashboard"监控面板，包含节点基本信息和同步状态检测。

登录信息：

• 用户名：admin
• 密码：ink

访问路径：Dashboards > Manage > Simple Node Dashboard

🛠️ 常见问题解决

"Walking back L1Block"错误

如果在Ecotone升级后长时间出现此错误，尝试：

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

📄 相关文件路径

• 初始化脚本：scripts/init-bedrock.sh
• 启动脚本：scripts/start-op-geth.sh、scripts/start-op-node.sh
• Docker配置：docker-compose.yml
• 环境变量模板：.env.example
• 监控配置：docker/grafana/dashboards/simple_node_dashboard.json

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