尧图网站建设 
kona-node 使用指南用 Rust 运行 OP Stack 共识节点的完整实战手册【免费下载链接】optimismOptimism is Ethereum, scaled.项目地址: https://gitcode.com/GitHub_Trending/op/optimismkona-node是 OP Stack 官方代码库中基于 Rust 实现的模块化共识节点负责 OP Stack rollup 的验证与共识相关工作。本文围绕kona-node的命令行工具展开覆盖安装方式、五类子命令、全局与局部参数解析、环境变量配置、RPC 信任策略、P2P 网络参数以及基于 Docker Compose 的生产级部署配方帮助你快速搭建并运行一个连接 OP Sepolia 或任意超级链Superchain的 rollup 节点。kona-node 的定位与源码结构kona-node位于仓库 rust/kona/bin/node/ 目录其包描述为 Kona Consensus Node版本为1.0.0-rc.1见 Cargo.toml。从依赖构成看它聚合了kona-derive数据推导、kona-engine引擎 API 客户端、kona-gossip与kona-discP2P 网络、kona-registry超级链注册表、kona-node-service节点服务编排等 Kona 核心库并基于 clap 构建命令行接口支持从命令行参数、环境变量与配置文件三处来源读取配置。二进制入口位于 src/main.rsCLI 定义在 src/cli.rs五个子命令分别实现在 src/commands/ 下的node.rs、net.rs、registry.rs、bootstore.rs、info.rs全局参数与分组参数位于 src/flags/。安装 kona-node通过 crates.io 安装最直接的安装方式是通过 Cargo 从 crates.io 安装cargo install kona-node从源码构建如果需要使用当前仓库的开发版本或进行二次开发可以在仓库的 Rust 工作区中构建cd rust/kona/bin/node cargo build --release构建产物位于target/release/kona-node。默认启用asm-keccak特性使用汇编优化的 Keccak 实现可通过--no-default-features关闭见 Cargo.toml。命令行总体结构kona-node的命令结构为kona-node [GLOBAL_OPTIONS] SUBCOMMAND [SUBCOMMAND_OPTIONS]全局选项全局选项作用于所有子命令其中最关键的是--chain即--l2-chain-id短写-c用于指定 L2 链 ID默认值为10Optimism 主网可通过环境变量KONA_NODE_L2_CHAIN_ID覆盖。它既接受数字如11155420也接受链名如optimism、base、mainnet由 globals.rs 中的 clap 参数定义cli.rs 的测试用例验证了数字与字符串两种写法。全局参数还包括日志参数LogArgs、覆盖参数OverrideArgs与 Prometheus 指标参数MetricsArgs如--metrics.enabled、--metrics.port。五个子命令一览依据 cli.rs 中的 Commands 枚举kona-node提供如下子命令子命令别名功能noden运行 OP Stack rollup 共识节点netp2p、network仅运行节点的网络栈P2Pregistryr、scr列出 superchain-registry 中可用的 OP Stack 链bootstoreb、boot、store与本地 bootstore 交互的工具info无查询 OP Stack 链的信息这些别名均有对应的单元测试覆盖见 cli.rs 测试例如kona-node p2p --help与kona-node net --help等价。运行共识节点node 子命令node是核心子命令其参数定义在 commands/node.rs。基本运行命令如下kona-node \ --chain 11155420 \ --metrics.enabled \ --metrics.port 9002 \ node \ --l1 L1_PROVIDER_RPC \ --l1-beacon L1_BEACON_API \ --l2 L2_ENGINE_RPC \ --l2-engine-jwt-secret /path/to/jwt.hex \ --port 5060 \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.scoring off \ --p2p.bootstore /path/to/bootstore节点运行模式--mode指定节点运行模式默认值为validator校验者模式可切换为sequencer排序器模式对应环境变量KONA_NODE_MODE。在 node.rs 的run流程中模式被写入EngineConfig并传递给节点服务决定节点是校验 L2 区块还是参与出块。关键参数说明参数环境变量说明--l1/--l1-eth-rpcKONA_NODE_L1_ETH_RPCL1 执行客户端 RPC 地址--l1-beaconKONA_NODE_L1_BEACONL1 Beacon API 地址--l2/--l2-engine-rpcKONA_NODE_L2_ENGINE_RPCL2 引擎 APIEngine API地址--l2-engine-jwt-secretKONA_NODE_L2_ENGINE_AUTH与 L2 执行客户端通信的 JWT secret 文件路径--l2-trust-rpcKONA_NODE_L2_TRUST_RPC是否信任 L2 RPC默认 true--l1-trust-rpcKONA_NODE_L1_TRUST_RPC是否信任 L1 RPC默认 true--port别名--rpc.portKONA_NODE_RPC_PORTRPC 服务监听端口源码默认 9545示例中显式指定 5060--l2-config-file别名--rollup-cfgKONA_NODE_ROLLUP_CONFIG自定义 L2 rollup 配置 JSON覆盖注册表默认配置--l1-config-file别名--rollup-l1-cfgKONA_NODE_L1_CHAIN_CONFIG自定义 L1 链配置或创世文件--interop.dependency-setKONA_NODE_INTEROP_DEPENDENCY_SET链间互操作依赖集 JSON调度 Lagoon 硬分叉时必填配置来源与优先级get_l2_config 展示了配置的加载逻辑若指定--l2-config-file则从文件读取 rollup 配置否则从 superchain-registry 中按--chain查找。同理get_l1_config 优先读取--l1-config-file否则从已知链配置中加载 L1 创世信息并且该函数同时兼容直接 L1 配置与完整创世文档带config字段两种 JSON 结构见parse_l1_config与对应测试 test_get_l1_config_from_direct_and_genesis_files。JWT 认证与启动校验节点启动前会执行 validate_jwt使用指定的 JWT secret 构造 Engine 客户端并通过exchange_capabilities与 L2 引擎握手。若 JWT 签名不匹配会给出明确报错并提示检查 secret 文件握手失败则会指数退避重试。若未指定 secret 路径l2_jwt_secret 会尝试读取当前目录下的l2_jwt.hex文件不存在时自动生成随机 secret 并写入该文件见default_jwt_secret。--l2-engine-jwt-secret也可改用--l2-engine-jwt-encoded直接以编码形式传入。Lagoon 硬分叉的依赖集校验值得注意的一个启动期防护若 rollup 配置中调度了 Lagoon 硬分叉lagoon_time已设置但未提供--interop.dependency-setload_dependency_set 会直接报错退出而不是在运行期发生静默状态分叉将潜在的状态发散问题提前暴露为启动错误。实战示例连接 OP Sepolia以下完整示例演示如何运行一个连接到 OP Sepoliachain ID11155420的 kona-node# 设置必要的环境变量 export L1_PROVIDER_RPChttps://your-l1-rpc-endpoint export L1_BEACON_APIhttps://your-l1-beacon-api-endpoint # 运行节点 kona-node \ --chain 11155420 \ --metrics.enabled \ --metrics.port 9002 \ node \ --l1 $L1_PROVIDER_RPC \ --l1-beacon $L1_BEACON_API \ --l2 http://localhost:8551 \ --l2-engine-jwt-secret ./jwt.hex \ --port 5060 \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.scoring off \ --p2p.bootstore ./bootstore其中--l2 http://localhost:8551指向本地运行的 L2 执行客户端如 op-reth的 Engine API 端口./jwt.hex需与 L2 执行客户端配置的 JWT secret 一致。使用环境变量进行配置除命令行参数外kona-node全面支持通过KONA_NODE_前缀的环境变量配置。README 中列出的核心变量如下环境变量说明默认值KONA_NODE_L1_ETH_RPCL1 执行客户端 RPC URL—KONA_NODE_L1_TRUST_RPC是否信任 L1 RPC 而不做额外验证trueKONA_NODE_L1_BEACONL1 Beacon API URL—KONA_NODE_L2_ENGINE_RPCL2 Engine API URL—KONA_NODE_L2_TRUST_RPC是否信任 L2 RPC 而不做额外验证trueKONA_NODE_L2_ENGINE_AUTHL2 Engine JWT secret 文件路径—KONA_NODE_MODE节点运行模式validator / sequencervalidatorRUST_LOG日志过滤配置标准 tracing 语法—此外从 flags 源码 可以看到更多环境变量例如链 IDKONA_NODE_L2_CHAIN_ID、rollup 配置KONA_NODE_ROLLUP_CONFIG、L1 配置KONA_NODE_L1_CHAIN_CONFIG、依赖集KONA_NODE_INTEROP_DEPENDENCY_SET、全部KONA_NODE_P2P_*网络变量与KONA_NODE_RPC_*RPC 变量。clap 通过env属性自动完成映射见 globals.rs 与 rpc.rs。纯环境变量方式运行示例export KONA_NODE_L1_ETH_RPChttps://your-l1-rpc export KONA_NODE_L1_BEACONhttps://your-l1-beacon-api export KONA_NODE_L2_ENGINE_RPChttp://localhost:8551 export RUST_LOGkona_nodeinfo,kona_derivedebug kona-node node --port 5060帮助与文档所有参数均可用--help查看# 全局帮助含子命令列表与全局选项 kona-node --help # 各子命令专属帮助 kona-node node --help kona-node net --help kona-node registry --help还可以用kona-node --version与kona-node --long-version查看版本信息见 version.rs。网络与 P2Pnet 子命令net别名p2p、network只运行节点网络栈可用于调试或单独部署网络层kona-node net \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.bootstore ./bootstoreP2P 参数详解P2P 参数基于 op-node 的 P2P 标志设计见 p2p.rs完整参数超过 60 项以下是最常用的核心项参数默认值说明--p2p.listen.ip0.0.0.0LibP2P/Discv5 绑定 IP也接受 DNS 主机名并启动时解析--p2p.listen.tcp9222LibP2P TCP 监听端口设为 0 使用系统随机端口--p2p.listen.udp9223Discv5 UDP 监听端口设为 0 时与 TCP 端口一致--p2p.advertise.ip未设置对外广播的 IP/DNSNAT 后网络建议设置设置后禁用动态 ENR 更新--p2p.advertise.tcp/--p2p.advertise.udp0对外广播的 TCP/UDP 端口与监听端口一致时设为 0--p2p.priv.path/--p2p.priv.raw未设置Peer ID 私钥文件/原始值持久化以保持重启后网络身份不变--p2p.no-discoveryfalse禁用 Discv5 节点发现--p2p.peers.lo20低潮位连接数低于此值主动寻找新对等节点--p2p.peers.hi30高潮位连接数高于此值逐步修剪连接--p2p.peers.grace30新连接对等节点的宽限期秒--p2p.gossip.mesh.d8GossipSub 主题网格目标出度向多少对等节点转发--p2p.scoring—对等节点评分等级示例中设为off关闭--p2p.bootstore—bootstore 路径用于持久化节点发现引导数据bootstore 子命令bootstore别名b、boot、store是操作本地 bootstore 的独立工具可查看或管理 P2P 引导记录实现在 commands/bootstore.rs。注册表与链信息查询列出可用链kona-node registryregistry别名r、scr列出 superchain-registry 中所有可用的 OP Stack 链依赖kona-registry的tabled特性输出表格实现在 commands/registry.rs。查询单链信息kona-node info --helpinfo子命令用于获取指定 OP Stack 链的信息如创世、rollup 配置摘要等结合全局--chain指定目标链实现在 commands/info.rs。运行前置要求运行kona-node node前需要准备四类基础设施L1 执行客户端可访问的以太坊 L1 执行客户端 RPC 端点--l1L1 Beacon API可访问的以太坊 L1 信标链 API 端点--l1-beacon用于获取 L1 区块头与数据可用性信息L2 执行客户端OP Stack L2 执行客户端如 op-rethkona-node 通过 Engine API 与其交互--l2JWT Secret用于与 L2 执行客户端认证通信的 JWT secret 文件--l2-engine-jwt-secretcli.rs 的测试验证了这三个必需 RPC 参数缺失时的报错行为node子命令缺少--l1-eth-rpc、--l1-beacon、--l2-engine-rpc任一参数都会解析失败并给出明确提示。高级配置RPC 信任策略默认情况下kona-node信任 RPC 提供方不对区块哈希做额外验证以换取最佳性能。可通过信任标志调整# 面向不受信任/公共 RPC 提供方开启验证 kona-node node \ --l1 https://public-rpc-endpoint.com \ --l1-trust-rpc false \ --l2 https://another-public-rpc.com \ --l2-trust-rpc false # ... 其余参数安全考量默认true不做额外验证假定 RPC 可信性能最优验证模式false所有区块哈希均与请求的哈希比对校验公共或第三方 RPC 端点务必使用false本地节点与可信基础设施适合保留默认truel1_trust_rpc与l2_trust_rpc在 node.rs 的run流程中被分别注入 L1 配置构建器与RollupNodeBuilder。RPC 服务参数补充除文档明确说明的--port外rpc.rs 还定义了完整的 RPC 服务参数族参数默认值说明--rpc.addr0.0.0.0RPC 监听地址Docker 镜像中绑定127.0.0.1将导致容器外不可达--port/--rpc.port9545RPC 监听端口--rpc.disabledfalse完全禁用 RPC 服务--rpc.no-restartfalse禁止 RPC 服务崩溃后自动重启--rpc.enable-adminfalse启用 admin API默认关闭有对应测试--rpc.admin-state未设置admin API 状态变更的持久化文件路径--rpc.ws-enabledfalse启用 WebSocket RPC 以跟踪区块生产--rpc.dev-enabledfalse启用面向引擎状态内省的开发用 RPC 端点生产部署Docker 配方README 推荐的生产部署方式是仓库中的 Docker 配方目录 rust/kona/docker/recipes/kona-node/它提供了一套开箱即用的docker-compose编排包含kona-node、op-reth、Prometheus 与 Grafana默认同步 OP Sepolia。快速启动在 rust/kona/docker/recipes/kona-node/ 目录下先在 cfg.env 中配置L1_PROVIDER_RPC与L1_BEACON_API然后# 启动 kona-node、op-reth、grafana、prometheus just up # 关闭环境 just down # 重启环境 just restart默认端口映射端口服务9223kona-node 节点发现9002kona-node 指标5060kona-node RPC30303op-reth 节点发现9001op-reth 指标8545op-reth RPC8551op-reth Engine API9090Prometheus 指标服务3000Grafana 仪表盘 UI监控面板Grafana 默认地址为http://localhost:3000用户名与密码均为admin。kona-node 仪表盘已随 Grafana 实例预置配置存储在 grafana/dashboards/overview.jsonPrometheus 抓取配置见 prometheus/prometheus.yml。同步其他 OP Stack 链修改 docker-compose.yaml 以适配目标链确保L1_PROVIDER_RPC与L1_BEACON_API指向目标 L2 的结算层 L1 客户端op-reth服务--chain指定目标链--rollup.sequencer-http指定目标链的排序器端点例如 OP Sepolia 为https://sepolia-sequencer.optimism.io/kona-node服务--chain指定目标链 ID日志过滤通过RUST_LOG环境变量调整日志级别该变量会被透传至 kona-node 容器的入口命令export RUST_LOGengine_buildertrace,runtimedebug小结从本文可以看出kona-node是一套高度模块化、配置来源多样CLI/环境变量/配置文件的 Rust 共识节点实现node子命令负责完整的共识验证与排序流程net子命令独立提供 P2P 网络栈registry与info帮助查询超级链注册信息bootstore提供本地引导数据管理配合信任标志、JWT 启动校验、Lagoon 依赖集防护等工程细节以及 Docker 配方中的完整监控编排足以支撑从开发调试到生产部署的全场景使用。若需深入理解其内部实现可继续阅读 rust/kona/crates/node/service/ 下的节点服务实现与 rust/kona/tests/ 中的集成测试。【免费下载链接】optimismOptimism is Ethereum, scaled.项目地址: https://gitcode.com/GitHub_Trending/op/optimism创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 kona-node 使用指南：用 Rust 运行 OP Stack 共识节点的完整实战手册
kona-node 使用指南用 Rust 运行 OP Stack 共识节点的完整实战手册【免费下载链接】optimismOptimism is Ethereum, scaled.项目地址: https://gitcode.com/GitHub_Trending/op/optimismkona-node是 OP Stack 官方代码库中基于 Rust 实现的模块化共识节点负责 OP Stack rollup 的验证与共识相关工作。本文围绕kona-node的命令行工具展开覆盖安装方式、五类子命令、全局与局部参数解析、环境变量配置、RPC 信任策略、P2P 网络参数以及基于 Docker Compose 的生产级部署配方帮助你快速搭建并运行一个连接 OP Sepolia 或任意超级链Superchain的 rollup 节点。kona-node 的定位与源码结构kona-node位于仓库 rust/kona/bin/node/ 目录其包描述为 Kona Consensus Node版本为1.0.0-rc.1见 Cargo.toml。从依赖构成看它聚合了kona-derive数据推导、kona-engine引擎 API 客户端、kona-gossip与kona-discP2P 网络、kona-registry超级链注册表、kona-node-service节点服务编排等 Kona 核心库并基于 clap 构建命令行接口支持从命令行参数、环境变量与配置文件三处来源读取配置。二进制入口位于 src/main.rsCLI 定义在 src/cli.rs五个子命令分别实现在 src/commands/ 下的node.rs、net.rs、registry.rs、bootstore.rs、info.rs全局参数与分组参数位于 src/flags/。安装 kona-node通过 crates.io 安装最直接的安装方式是通过 Cargo 从 crates.io 安装cargo install kona-node从源码构建如果需要使用当前仓库的开发版本或进行二次开发可以在仓库的 Rust 工作区中构建cd rust/kona/bin/node cargo build --release构建产物位于target/release/kona-node。默认启用asm-keccak特性使用汇编优化的 Keccak 实现可通过--no-default-features关闭见 Cargo.toml。命令行总体结构kona-node的命令结构为kona-node [GLOBAL_OPTIONS] SUBCOMMAND [SUBCOMMAND_OPTIONS]全局选项全局选项作用于所有子命令其中最关键的是--chain即--l2-chain-id短写-c用于指定 L2 链 ID默认值为10Optimism 主网可通过环境变量KONA_NODE_L2_CHAIN_ID覆盖。它既接受数字如11155420也接受链名如optimism、base、mainnet由 globals.rs 中的 clap 参数定义cli.rs 的测试用例验证了数字与字符串两种写法。全局参数还包括日志参数LogArgs、覆盖参数OverrideArgs与 Prometheus 指标参数MetricsArgs如--metrics.enabled、--metrics.port。五个子命令一览依据 cli.rs 中的 Commands 枚举kona-node提供如下子命令子命令别名功能noden运行 OP Stack rollup 共识节点netp2p、network仅运行节点的网络栈P2Pregistryr、scr列出 superchain-registry 中可用的 OP Stack 链bootstoreb、boot、store与本地 bootstore 交互的工具info无查询 OP Stack 链的信息这些别名均有对应的单元测试覆盖见 cli.rs 测试例如kona-node p2p --help与kona-node net --help等价。运行共识节点node 子命令node是核心子命令其参数定义在 commands/node.rs。基本运行命令如下kona-node \ --chain 11155420 \ --metrics.enabled \ --metrics.port 9002 \ node \ --l1 L1_PROVIDER_RPC \ --l1-beacon L1_BEACON_API \ --l2 L2_ENGINE_RPC \ --l2-engine-jwt-secret /path/to/jwt.hex \ --port 5060 \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.scoring off \ --p2p.bootstore /path/to/bootstore节点运行模式--mode指定节点运行模式默认值为validator校验者模式可切换为sequencer排序器模式对应环境变量KONA_NODE_MODE。在 node.rs 的run流程中模式被写入EngineConfig并传递给节点服务决定节点是校验 L2 区块还是参与出块。关键参数说明参数环境变量说明--l1/--l1-eth-rpcKONA_NODE_L1_ETH_RPCL1 执行客户端 RPC 地址--l1-beaconKONA_NODE_L1_BEACONL1 Beacon API 地址--l2/--l2-engine-rpcKONA_NODE_L2_ENGINE_RPCL2 引擎 APIEngine API地址--l2-engine-jwt-secretKONA_NODE_L2_ENGINE_AUTH与 L2 执行客户端通信的 JWT secret 文件路径--l2-trust-rpcKONA_NODE_L2_TRUST_RPC是否信任 L2 RPC默认 true--l1-trust-rpcKONA_NODE_L1_TRUST_RPC是否信任 L1 RPC默认 true--port别名--rpc.portKONA_NODE_RPC_PORTRPC 服务监听端口源码默认 9545示例中显式指定 5060--l2-config-file别名--rollup-cfgKONA_NODE_ROLLUP_CONFIG自定义 L2 rollup 配置 JSON覆盖注册表默认配置--l1-config-file别名--rollup-l1-cfgKONA_NODE_L1_CHAIN_CONFIG自定义 L1 链配置或创世文件--interop.dependency-setKONA_NODE_INTEROP_DEPENDENCY_SET链间互操作依赖集 JSON调度 Lagoon 硬分叉时必填配置来源与优先级get_l2_config 展示了配置的加载逻辑若指定--l2-config-file则从文件读取 rollup 配置否则从 superchain-registry 中按--chain查找。同理get_l1_config 优先读取--l1-config-file否则从已知链配置中加载 L1 创世信息并且该函数同时兼容直接 L1 配置与完整创世文档带config字段两种 JSON 结构见parse_l1_config与对应测试 test_get_l1_config_from_direct_and_genesis_files。JWT 认证与启动校验节点启动前会执行 validate_jwt使用指定的 JWT secret 构造 Engine 客户端并通过exchange_capabilities与 L2 引擎握手。若 JWT 签名不匹配会给出明确报错并提示检查 secret 文件握手失败则会指数退避重试。若未指定 secret 路径l2_jwt_secret 会尝试读取当前目录下的l2_jwt.hex文件不存在时自动生成随机 secret 并写入该文件见default_jwt_secret。--l2-engine-jwt-secret也可改用--l2-engine-jwt-encoded直接以编码形式传入。Lagoon 硬分叉的依赖集校验值得注意的一个启动期防护若 rollup 配置中调度了 Lagoon 硬分叉lagoon_time已设置但未提供--interop.dependency-setload_dependency_set 会直接报错退出而不是在运行期发生静默状态分叉将潜在的状态发散问题提前暴露为启动错误。实战示例连接 OP Sepolia以下完整示例演示如何运行一个连接到 OP Sepoliachain ID11155420的 kona-node# 设置必要的环境变量 export L1_PROVIDER_RPChttps://your-l1-rpc-endpoint export L1_BEACON_APIhttps://your-l1-beacon-api-endpoint # 运行节点 kona-node \ --chain 11155420 \ --metrics.enabled \ --metrics.port 9002 \ node \ --l1 $L1_PROVIDER_RPC \ --l1-beacon $L1_BEACON_API \ --l2 http://localhost:8551 \ --l2-engine-jwt-secret ./jwt.hex \ --port 5060 \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.scoring off \ --p2p.bootstore ./bootstore其中--l2 http://localhost:8551指向本地运行的 L2 执行客户端如 op-reth的 Engine API 端口./jwt.hex需与 L2 执行客户端配置的 JWT secret 一致。使用环境变量进行配置除命令行参数外kona-node全面支持通过KONA_NODE_前缀的环境变量配置。README 中列出的核心变量如下环境变量说明默认值KONA_NODE_L1_ETH_RPCL1 执行客户端 RPC URL—KONA_NODE_L1_TRUST_RPC是否信任 L1 RPC 而不做额外验证trueKONA_NODE_L1_BEACONL1 Beacon API URL—KONA_NODE_L2_ENGINE_RPCL2 Engine API URL—KONA_NODE_L2_TRUST_RPC是否信任 L2 RPC 而不做额外验证trueKONA_NODE_L2_ENGINE_AUTHL2 Engine JWT secret 文件路径—KONA_NODE_MODE节点运行模式validator / sequencervalidatorRUST_LOG日志过滤配置标准 tracing 语法—此外从 flags 源码 可以看到更多环境变量例如链 IDKONA_NODE_L2_CHAIN_ID、rollup 配置KONA_NODE_ROLLUP_CONFIG、L1 配置KONA_NODE_L1_CHAIN_CONFIG、依赖集KONA_NODE_INTEROP_DEPENDENCY_SET、全部KONA_NODE_P2P_*网络变量与KONA_NODE_RPC_*RPC 变量。clap 通过env属性自动完成映射见 globals.rs 与 rpc.rs。纯环境变量方式运行示例export KONA_NODE_L1_ETH_RPChttps://your-l1-rpc export KONA_NODE_L1_BEACONhttps://your-l1-beacon-api export KONA_NODE_L2_ENGINE_RPChttp://localhost:8551 export RUST_LOGkona_nodeinfo,kona_derivedebug kona-node node --port 5060帮助与文档所有参数均可用--help查看# 全局帮助含子命令列表与全局选项 kona-node --help # 各子命令专属帮助 kona-node node --help kona-node net --help kona-node registry --help还可以用kona-node --version与kona-node --long-version查看版本信息见 version.rs。网络与 P2Pnet 子命令net别名p2p、network只运行节点网络栈可用于调试或单独部署网络层kona-node net \ --p2p.listen.tcp 9223 \ --p2p.listen.udp 9223 \ --p2p.bootstore ./bootstoreP2P 参数详解P2P 参数基于 op-node 的 P2P 标志设计见 p2p.rs完整参数超过 60 项以下是最常用的核心项参数默认值说明--p2p.listen.ip0.0.0.0LibP2P/Discv5 绑定 IP也接受 DNS 主机名并启动时解析--p2p.listen.tcp9222LibP2P TCP 监听端口设为 0 使用系统随机端口--p2p.listen.udp9223Discv5 UDP 监听端口设为 0 时与 TCP 端口一致--p2p.advertise.ip未设置对外广播的 IP/DNSNAT 后网络建议设置设置后禁用动态 ENR 更新--p2p.advertise.tcp/--p2p.advertise.udp0对外广播的 TCP/UDP 端口与监听端口一致时设为 0--p2p.priv.path/--p2p.priv.raw未设置Peer ID 私钥文件/原始值持久化以保持重启后网络身份不变--p2p.no-discoveryfalse禁用 Discv5 节点发现--p2p.peers.lo20低潮位连接数低于此值主动寻找新对等节点--p2p.peers.hi30高潮位连接数高于此值逐步修剪连接--p2p.peers.grace30新连接对等节点的宽限期秒--p2p.gossip.mesh.d8GossipSub 主题网格目标出度向多少对等节点转发--p2p.scoring—对等节点评分等级示例中设为off关闭--p2p.bootstore—bootstore 路径用于持久化节点发现引导数据bootstore 子命令bootstore别名b、boot、store是操作本地 bootstore 的独立工具可查看或管理 P2P 引导记录实现在 commands/bootstore.rs。注册表与链信息查询列出可用链kona-node registryregistry别名r、scr列出 superchain-registry 中所有可用的 OP Stack 链依赖kona-registry的tabled特性输出表格实现在 commands/registry.rs。查询单链信息kona-node info --helpinfo子命令用于获取指定 OP Stack 链的信息如创世、rollup 配置摘要等结合全局--chain指定目标链实现在 commands/info.rs。运行前置要求运行kona-node node前需要准备四类基础设施L1 执行客户端可访问的以太坊 L1 执行客户端 RPC 端点--l1L1 Beacon API可访问的以太坊 L1 信标链 API 端点--l1-beacon用于获取 L1 区块头与数据可用性信息L2 执行客户端OP Stack L2 执行客户端如 op-rethkona-node 通过 Engine API 与其交互--l2JWT Secret用于与 L2 执行客户端认证通信的 JWT secret 文件--l2-engine-jwt-secretcli.rs 的测试验证了这三个必需 RPC 参数缺失时的报错行为node子命令缺少--l1-eth-rpc、--l1-beacon、--l2-engine-rpc任一参数都会解析失败并给出明确提示。高级配置RPC 信任策略默认情况下kona-node信任 RPC 提供方不对区块哈希做额外验证以换取最佳性能。可通过信任标志调整# 面向不受信任/公共 RPC 提供方开启验证 kona-node node \ --l1 https://public-rpc-endpoint.com \ --l1-trust-rpc false \ --l2 https://another-public-rpc.com \ --l2-trust-rpc false # ... 其余参数安全考量默认true不做额外验证假定 RPC 可信性能最优验证模式false所有区块哈希均与请求的哈希比对校验公共或第三方 RPC 端点务必使用false本地节点与可信基础设施适合保留默认truel1_trust_rpc与l2_trust_rpc在 node.rs 的run流程中被分别注入 L1 配置构建器与RollupNodeBuilder。RPC 服务参数补充除文档明确说明的--port外rpc.rs 还定义了完整的 RPC 服务参数族参数默认值说明--rpc.addr0.0.0.0RPC 监听地址Docker 镜像中绑定127.0.0.1将导致容器外不可达--port/--rpc.port9545RPC 监听端口--rpc.disabledfalse完全禁用 RPC 服务--rpc.no-restartfalse禁止 RPC 服务崩溃后自动重启--rpc.enable-adminfalse启用 admin API默认关闭有对应测试--rpc.admin-state未设置admin API 状态变更的持久化文件路径--rpc.ws-enabledfalse启用 WebSocket RPC 以跟踪区块生产--rpc.dev-enabledfalse启用面向引擎状态内省的开发用 RPC 端点生产部署Docker 配方README 推荐的生产部署方式是仓库中的 Docker 配方目录 rust/kona/docker/recipes/kona-node/它提供了一套开箱即用的docker-compose编排包含kona-node、op-reth、Prometheus 与 Grafana默认同步 OP Sepolia。快速启动在 rust/kona/docker/recipes/kona-node/ 目录下先在 cfg.env 中配置L1_PROVIDER_RPC与L1_BEACON_API然后# 启动 kona-node、op-reth、grafana、prometheus just up # 关闭环境 just down # 重启环境 just restart默认端口映射端口服务9223kona-node 节点发现9002kona-node 指标5060kona-node RPC30303op-reth 节点发现9001op-reth 指标8545op-reth RPC8551op-reth Engine API9090Prometheus 指标服务3000Grafana 仪表盘 UI监控面板Grafana 默认地址为http://localhost:3000用户名与密码均为admin。kona-node 仪表盘已随 Grafana 实例预置配置存储在 grafana/dashboards/overview.jsonPrometheus 抓取配置见 prometheus/prometheus.yml。同步其他 OP Stack 链修改 docker-compose.yaml 以适配目标链确保L1_PROVIDER_RPC与L1_BEACON_API指向目标 L2 的结算层 L1 客户端op-reth服务--chain指定目标链--rollup.sequencer-http指定目标链的排序器端点例如 OP Sepolia 为https://sepolia-sequencer.optimism.io/kona-node服务--chain指定目标链 ID日志过滤通过RUST_LOG环境变量调整日志级别该变量会被透传至 kona-node 容器的入口命令export RUST_LOGengine_buildertrace,runtimedebug小结从本文可以看出kona-node是一套高度模块化、配置来源多样CLI/环境变量/配置文件的 Rust 共识节点实现node子命令负责完整的共识验证与排序流程net子命令独立提供 P2P 网络栈registry与info帮助查询超级链注册信息bootstore提供本地引导数据管理配合信任标志、JWT 启动校验、Lagoon 依赖集防护等工程细节以及 Docker 配方中的完整监控编排足以支撑从开发调试到生产部署的全场景使用。若需深入理解其内部实现可继续阅读 rust/kona/crates/node/service/ 下的节点服务实现与 rust/kona/tests/ 中的集成测试。【免费下载链接】optimismOptimism is Ethereum, scaled.项目地址: https://gitcode.com/GitHub_Trending/op/optimism创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考