在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

base/node

菜单

快速入门

相关源文件

本指南提供了设置和运行 Base 节点 的全面概述。Base 是一个安全、低成本、对开发者友好的以太坊 L2，构建在 Optimism 的开源 OP Stack 之上。运行 Base 节点可让您与 Base 网络进行交互、处理交易并访问区块链数据。

有关详细的硬件要求，请参阅 先决条件。有关分步安装说明，请参阅 安装。有关高级配置选项，请参阅 配置。

系统概览

在开始之前，了解 Base 节点 的组成部分会有所帮助。

来源：README.md5-7 docker-compose.yml1-31

快速入门

以下是启动 Base 节点 的基本工作流程

  1. 准备以太坊 L1 节点访问权限

    • 您需要访问以太坊 L1 完整节点（非 Base）
    • 此 L1 节点必须完全同步

  2. 设置网络环境

  3. 启动节点

  4. 选择执行客户端（可选）

  5. 验证节点运行情况

来源：README.md55-85

组件架构

Base 节点 由两个主要容器组成，它们协同工作。

来源：README.md55-85 docker-compose.yml1-31

网络配置

运行 Base 节点时，会暴露以下网络端口

服务端口协议目的
执行客户端8545HTTPJSON-RPC API
执行客户端8546WebSocketWebSocket API
执行客户端30303TCP/UDPP2P 通信
执行客户端7301HTTP指标（容器内 6060）
op-node7545HTTPJSON-RPC API（容器内 8545）
op-node9222TCP/UDPP2P 通信
op-node7300HTTP评估指标
op-node6060HTTPpprof 剖析

来源：docker-compose.yml6-28

数据持久化

默认情况下，Base 节点 将链数据存储在项目文件夹的 geth-data 目录中。可以通过修改 .env 文件中的 GETH_HOST_DATA_DIR 变量来自定义此位置。

为了加快初始同步速度，您可以使用快照

  1. 从 Base 文档 中提供的 URL 下载快照。
  2. 将快照提取到您配置的数据目录中。
  3. 照常启动您的节点。

来源：README.md89-94 README.md108-110

监控同步状态

您可以使用 optimism_syncStatus RPC 方法来监控节点同步进度。

检查您的节点比当前时间落后多少。

来源：README.md114-122

替代部署：单容器

虽然标准部署使用 Docker Compose 运行多个容器，但您也可以使用 supervisord 在单个容器中运行 Base 节点。

此方法对于 Kubernetes 部署或其他容器编排系统特别有用。

来源：README.md96-106

故障排除

如果您在设置或运行 Base 节点时遇到问题

  1. 检查您的 L1 节点是否已完全同步并可访问。
  2. 验证端口 8545（执行客户端 RPC）和 7545（op-node RPC）是否可访问。
  3. 确保有足够的磁盘空间用于链数据。
  4. 检查两个容器的日志：docker compose logs execution 和 docker compose logs node。

对于持续存在的问题，您可以

  • 在 GitHub issue
  • 在 Base Discord 的 #🛟|developer-support 或 🛠｜node-operators 频道联系我们。

来源：README.md41-47

下一步

您的 Base 节点启动并运行后，您可能需要

  1. 为特定网络配置您的节点 - 请参阅 主网配置 或 Sepolia 测试网配置。
  2. 了解构成您节点的组件 - 请参阅 组件。
  3. 设置监控并优化性能 - 请参阅 运维。

来源：README.md