安装

安装概览

Base Node 使用 Docker 容器来简化部署过程。该系统包含两个主要容器：一个执行客户端（Geth、Reth 或 Nethermind）和一个连接到以太坊 L1 的 op-node 服务。

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

先决条件

在安装 Base 节点之前，请确保您拥有

已安装 Docker 和 Docker Compose
访问以太坊 L1 全节点 RPC
充足的硬件资源
- 多核 CPU，具有良好的单核性能
- 最少 16 GB RAM（推荐 32 GB）
- NVMe SSD 存储
- 足够的链数据存储空间

有关详细的硬件和软件要求，请参阅先决条件页面。

来源： README.md30-39

安装步骤

1. 配置网络环境

首先，您需要设置 NETWORK_ENV 环境变量，以指定您是要在 Base 主网还是 Sepolia 测试网上运行节点。

此环境变量指向您所选网络的相应配置文件。

来源： README.md58-64

2. 配置 L1 端点

确保您已在环境文件（.env.mainnet 或 .env.sepolia）中设置了 OP_NODE_L1_ETH_RPC 变量。这应指向一个以太坊 L1 全节点 RPC 端点，该端点必须在您的 Base 节点完全同步之前同步。

来源： README.md57

3. 启动节点

运行以下命令来构建并启动 Base 节点容器。

默认情况下，这将使用 Geth 作为执行客户端。如果您想使用其他支持的客户端，可以使用 CLIENT 环境变量来指定。

来源： README.md66-78

来源： docker-compose.yml1-31 README.md66-79

验证安装

1. 检查 RPC 端点

为了验证您的节点是否正常运行，您可以进行一个测试 RPC 请求。

您应该会收到一个包含最新区块信息的 JSON 响应。

来源： README.md80-85

2. 检查同步状态

您可以使用 optimism_syncStatus RPC 方法来检查节点的同步状态。

查看您落后最新区块多远。

来源： README.md114-122

高级安装选项

持久化数据

默认情况下，节点数据存储在项目根目录的 geth-data 目录中。您可以修改 .env 文件中的 GETH_HOST_DATA_DIR 变量来更改此位置。

来源： README.md90-94 docker-compose.yml13-14

使用快照加速同步

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

从Base文档中提供的 URL 下载快照。
将快照解压到您的数据目录（$GETH_HOST_DATA_DIR）。
像往常一样使用 docker compose up --build 启动您的节点。

来源： README.md108-110 README.md94

在单个容器中运行

如果您更愿意在单个容器中运行节点，而不是使用 Docker Compose（例如，在 Kubernetes 环境中），您可以使用 supervisord 入口点。

请注意，您需要覆盖一些假设多容器环境的默认配置参数。

来源： README.md96-106

端口配置

容器暴露了以下端口：

服务	端口	目的
执行客户端	8545	JSON-RPC API
执行客户端	8546	WebSocket API
执行客户端	7301	评估指标
执行客户端	30303 (TCP/UDP)	P2P 通信
op-node	7545	JSON-RPC API
op-node	9222 (TCP/UDP)	P2P 通信
op-node	7300	评估指标
op-node	6060	pprof 调试

来源： docker-compose.yml5-28

故障排除

如果在安装过程中或运行节点时遇到问题

检查您的 L1 节点是否已完全同步并可访问。
确保必需的端口没有被防火墙阻止。
确认您有足够的磁盘空间和内存。
检查容器日志以获取错误消息。

如需进一步帮助，您可以

打开一个 GitHub issue
加入 Base Discord 服务器，在专用频道中寻求支持。

来源： README.md41-47

安装