mcpField
R
running-a-base-node

running-a-base-node

github.com/base云与 DevOps120316 次安装1 天前更新
代码仓库

关于 running-a-base-node

面向需要稳定 RPC 访问的生产应用，指导使用 Reth 部署和运行 Base 节点。内容涵盖硬件、网络、安全、同步及同步完成检查。

主要功能

  1. 01选择 Reth 客户端
  2. 02RPC 访问安全建议
  3. 03硬件与端口要求
  4. 04同步与快照指导
  5. 05验证同步状态

适用场景

  1. 01规划 Base 节点硬件
  2. 02限制 RPC 端点访问
  3. 03使用快照加快初始同步
  4. 04部署前检查节点就绪状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/base/skills --skill running-a-base-node

安装后在 Claude Code 中输入/running-a-base-node确认已加载。

详细介绍

运行 Base 节点

适用于需要可靠、无限制 RPC 访问的生产应用。

安全

  • 限制 RPC 访问 — 绑定到 127.0.0.1 或私有网络接口，切勿在未经身份验证的情况下将 RPC 端口（8545/8546）暴露到公共互联网
  • 防火墙规则 — 仅向公众开放端口 9222（Discovery v5）和 30303（P2P）；阻止所有其他入站流量
  • 使用非 root 用户运行，并将文件系统权限设为最低限度
  • 如果要向远程客户端开放 RPC 端点，请使用 TLS 终止（通过 nginx/caddy 反向代理）
  • 监控未授权访问 — 记录并针对异常 RPC 调用或连接激增发出警报

硬件要求

  • CPU：至少 8 核
  • RAM：至少 16 GB
  • 存储：NVMe SSD，计算公式：(2 × chain_size) + snapshot_size + 20% buffer

网络

所需端口：

  • 端口 9222：对 Reth Discovery v5 至关重要
  • 端口 30303：P2P Discovery 和 RLPx

如果这些端口被阻止，节点将难以发现节点并完成同步。

客户端选择

Base 节点请使用 Reth。Geth Archive Node 已不再受支持。

Reth 提供：

  • 更适合高吞吐量 L2 的性能
  • 内置 Archive Node 支持

同步

  • 初始同步需要 数天
  • 如果使用外部提供商，会消耗大量 RPC 配额
  • 使用快照加速（快照 URL 请查看 Base 文档）

同步状态

同步未完成的迹象：部署时出现 Error: nonce has already been used

验证同步状态：

  • 将最新区块与区块浏览器进行比较
  • 检查节点连接
  • 监控日志中的进度

评论

支持 Markdown