How to launch a node|普通节点与 BP 节点¶
本文的节点、CLI 与 RPC 目标版本为 FullOn Core v0.9.2。合约、CDT 和钱包各有独立版本;其已注明的核验范围不因 Core 升级自动改变。详见版本基线与升级说明。
使用官方 Docker 模板部署请直接阅读Docker Compose 部署教程,覆盖 docker-compose.yaml、网络隔离、角色选择与健康检查。
先选择角色¶
| 角色 | 职责 | 构建包 | 是否需要生产身份/密钥 |
|---|---|---|---|
| 普通同步 / Seed | 校验、同步与 P2P 传播 | flon-node core |
否 |
| RPC | 当前状态查询与交易入口 | flon-node core |
否 |
| History | 历史索引、Trace / State History | flon-node-history |
否 |
| BP | 同步、校验并在排班允许时生产区块 | flon-node core |
是 |
运行相同链的节点不要求成为 BP。普通节点也会验证区块;只有配置身份和签名、完成目标链要求并进入活动排班的 BP 才能实际出块。
安装与网络准备¶
- 从 Core releases选择与目标网络兼容的版本和平台;不要把开发分支直接当生产版本。
- 验证发布包校验和,解压对应 node 包;CLI/钱包工具另取
flon-tools。 - 从网络运营方取得可信 genesis 或兼容快照、预期 chain ID、P2P peers、升级要求。
- 为每个进程使用独立配置和数据目录,规划磁盘、日志和监控。快照格式与版本必须兼容,快照不保证包含历史索引。
当前知识库未核验主网/测试网 genesis、快照下载地址及硬件最低值,因此不提供猜测性参数。
启动普通同步节点¶
发布包包含 config/seed.ini;复制到自己的配置目录后补充网络 peers。
mkdir -p ./node-config ./node-data
cp ./config/seed.ini ./node-config/config.ini
# 启动前编辑 node-config/config.ini,补齐目标网络的 P2P 配置。
./bin/funod --config-dir ./node-config --config config.ini --data-dir ./node-data --genesis-json /path/to/verified-genesis.json
/path/to/verified-genesis.json 是必替换路径;此命令用于新的数据目录。已有链状态的重启按对应版本要求处理,不要混入另一网络 genesis。若用快照恢复,请按照该版本 funod --help 和发布说明选择恢复方式。
RPC 节点¶
v0.9.2 的 config/rpc.ini 虽是起点,但启用 net_api_plugin 且普通 HTTP 绑定 0.0.0.0;该组合会被默认管理 API 校验拒绝。不要照搬后仅关闭保护。应先禁用不需要的管理插件,或使用 http-category-address 将 chain_ro/chain_rw 与 net_rw、监控类别分离,管理绑定回环或 Unix socket。完整示例见RPC 参考。
BP 节点额外步骤¶
- 按当前网络治理要求申请/注册 BP,准备独立的生产签名能力。
- 在 BP 配置中使用
producer-name = yourbpaccount,通过受保护的签名提供者配置对应生产公钥;不要把私钥写入仓库、发布包或截图。 - 如目标链启用 Savanna,按其要求完成 finalizer 身份与密钥配置。生产签名与 finalizer 职责需分别核实。
- 同步到链头,核对活动 producer schedule 和 finalizer 策略。注册成功不等于进入活动排班。
- 观察实际生产、漏块、LIB 推进和签名服务健康。不要让同一生产身份在多个未协调实例上同时签名。
BP 应将 HTTP 绑定本地,公开查询交给独立 RPC/History 节点。不要仅靠配置 producer-name 判断已具备 BP 资格。
验收与排错¶
检查预期 chain ID、head/LIB 持续推进、P2P 连接、资源与磁盘余量、日志错误和角色需要的 API。core 包不能通过配置开启编译时排除的 History 插件。