进阶 docs.nethermind.io 2026-11-13 08:27:03 · 5 阅读
第9章 从 Geth 迁移到 Nethermind
版本:2.2.0 从 Geth 迁移到 Nethermind
本指南将带你完成从 Geth 平滑迁移到 Nethermind 所需的全部步骤。
首先,确保磁盘有足够的剩余空间。最稳妥的做法是:在同一台机器上、不停机的情况下,让 Nethermind 与 Geth 同时运行并完成同步。这样可以验证 Nethermind 是否正常同步、各项功能是否符合预期,并将节点的停机时间降到最低。对于公共 JSON-RPC 服务商或验证者节点,推荐采用这种方式。
如果磁盘空间充足,推荐选择方案 1 或方案 2。
如果磁盘空间不足,又不能接受停机,建议先扩容磁盘;若无法扩容,则可以将 Nethermind 部署到另一台机器上完成同步,同步完成后把所有与验证者相关的内容迁移过去,然后弃用原机器。
如果能接受约 12 小时以上的停机,请参见方案 3。
方案 1:在 Geth 旁边同步 Nethermind
首先安装 Nethermind 和你选择的共识客户端。
warning
如果你为 Nethermind 选择的共识客户端与 Geth 正在使用的相同,请确保两者的配置(如数据目录)不会冲突。
确保与 Nethermind 配对的共识客户端和与 Geth 配对的共识客户端网络端口互不冲突。
确保 Nethermind 的 JSON-RPC 端口、Engine API 端口和 P2P 网络端口与 Geth 所用的不同。这些端口通过以下命令行参数设置:
--jsonrpc-port
--jsonrpc-engineport
--network-discoveryport
--network-p2pport
满足以上要求后,即可开始同步 Nethermind。可以通过 eth_syncing JSON-RPC 方法查看同步状态:当它返回 false 时,说明 Nethermind 已完全同步,具备了作为验证者正常工作所需的全部区块体和收据。也可以通过健康检查来监控同步进度。
Nethermind 同步完成后,关闭 Geth、Nethermind 及其配套的共识客户端。然后用 Geth 原先使用的端口和 JWT secret 重启 Nethermind。确认 Nethermind 和共识客户端的日志中没有任何警告或错误,并检查 Nethermind 是否正常跟随链上状态。一切正常后,就可以删除 Geth 以及之前与 Geth 配对的共识客户端及其数据。
方案 2:使用 Sedge 在 Geth 旁边同步 Nethermind
Sedge 是一款运行在 Linux 和 macOS 上的 PoS 验证者和节点配置工具。
该方案与方案 1 类似,但 Sedge 会自动处理端口冲突等配置问题,让整个流程简单得多。
tip可以通过附加参数来配置 Sedge,例如:
执行客户端:--el-extra-flag jsonrpc-port=8546
共识客户端:--cl-extra-flag rpc-port=4001
Nethermind 同步完成后,可以从 docker-compose.yml 中删除附加参数(如果有的话),然后按如下方式重启节点:
docker compose stop execution
docker compose up -d execution
方案三:移除 Geth 并同步 Nethermind 这是最简单的方案,不需要调整任何配置。但缺点是,在 Nethermind 完成同步之前,节点会处于停机状态。 具体步骤如下: 停止并移除 Geth 及其数据。 安装 Nethermind。 确保 Nethermind 使用与之前 Geth 相同的网络端口和相同的 JWT secret,否则就需要根据 Nethermind 的设置重新配置共识客户端。 满足以上要求后,就可以启动 Nethermind 开始同步了。同步过程中,注意检查 Nethermind 和共识客户端的日志,确保没有报错。同步所需时间取决于链的情况,可能需要一段时间。你也可以定期通过 eth_syncing 这个 JSON-RPC 方法或健康检查来查看同步进度。
docker compose up -d execution
方案三:移除 Geth 并同步 Nethermind 这是最简单的方案,不需要调整任何配置。但缺点是,在 Nethermind 完成同步之前,节点会处于停机状态。 具体步骤如下: 停止并移除 Geth 及其数据。 安装 Nethermind。 确保 Nethermind 使用与之前 Geth 相同的网络端口和相同的 JWT secret,否则就需要根据 Nethermind 的设置重新配置共识客户端。 满足以上要求后,就可以启动 Nethermind 开始同步了。同步过程中,注意检查 Nethermind 和共识客户端的日志,确保没有报错。同步所需时间取决于链的情况,可能需要一段时间。你也可以定期通过 eth_syncing 这个 JSON-RPC 方法或健康检查来查看同步进度。