GreatVoyage-v4.8.2 配置迁移
升级至 GreatVoyage-v4.8.2 时需要检查的新增、行为变化和移除配置，以及从旧版 config.conf 迁移自定义设置的方法。
本页面面向从旧版 java-tron 升级至 GreatVoyage-v4.8.2 的节点运营者。新部署节点应使用与运行版本对应的配置文件，并参阅部署节点。
迁移方法
不要直接沿用旧版 config.conf。建议按以下步骤迁移：
- 备份旧配置文件，并记录其中的自定义设置。
- 以 GreatVoyage-v4.8.2 标签下的
config.conf为基础，逐项合并仍然有效的自定义设置。 - 根据下表按需显式添加或覆盖新增配置，并删除已移除配置。
- 对照 GreatVoyage-v4.8.2 的
reference.conf检查默认值和字段类型。 - 在测试环境验证节点启动、API、P2P、事件订阅和监控后，再升级生产节点。
配置变更
| 类型 | 配置项 | GreatVoyage-v4.8.2 行为与迁移说明 |
|---|---|---|
| 新增 | vm.constantCallTimeoutMs | 设置 TVM 常量调用的独立超时时间，单位为毫秒，适用于 triggerconstantcontract、estimateenergy、eth_call 和 eth_estimateGas 等常量调用路径。默认值为 0，表示不覆盖原有执行截止时间；设置时必须为非负整数。不要使用会同时放宽区块交易执行时间的 --debug 来延长常量调用。 |
| 新增 | rate.limiter.apiNonBlocking | 控制 HTTP 和 gRPC API 超过限流阈值时的处理方式。默认 false，请求等待可用配额；设为 true 时立即拒绝超限请求。 |
| 新增 | event.subscribe.enable | 控制事件订阅模块，默认 false。启用事件插件或内置 ZeroMQ 时设为 true；这是旧命令行参数 --es 的推荐替代方式。具体配置参阅事件订阅。 |
| 新增 | node.http.maxMessageSize | FullNode HTTP API 请求体上限，默认 4194304 字节（约 4 MiB）；设为 0 时拒绝所有非空请求体。该限制独立于 gRPC 和 JSON-RPC 的同名配置。 |
| 新增 | node.jsonrpc.maxBatchSize、maxResponseSize、maxLogFilterNum、maxMessageSize | JSON-RPC 的默认值依次为 100、26214400 字节（25 MiB）、20000 和 4194304 字节（约 4 MiB）。前三项设为 0 或负数表示不限制；maxMessageSize = 0 会拒绝所有非空请求体。 |
| 行为变化 | seed.node.ip.list、node.active、node.passive、node.fastForward、node.backup.members | 对等节点地址除 IP 外也可使用 hostname:port。node.backup.members 用于同一 SR 的多个出块节点实例之间进行主备协调，与下方已移除的 RocksDB 数据备份无关。 |
| 行为变化 | node.shutdown | 原有的 BlockTime、BlockHeight 和 BlockCount 条件退出配置现在也适用于 SolidityNode。配置方法参阅节点进程按条件自动退出。 |
| 移除 | storage.backup.* | RocksDB 内置数据备份功能及 enable、propPath、bak1path、bak2path、frequency 配置已移除。升级前应迁移到数据库快照或外部备份方案；不要误删仍有效的 node.backup。参阅数据库快照。 |
| 移除 | net.type | 不再支持通过该配置切换旧的测试网地址前缀；从自定义配置中删除此项。 |
| 移除 | actuator.whitelist | 自定义 Actuator 不再通过白名单配置注册；扩展类必须放在 org.tron.core.actuator 包下。 |
| 移除 | node.metrics.storageEnable、node.metrics.influxdb.* | 旧 Metrics 模块的 InfluxDB 上报已移除。继续使用 node.metrics.prometheus，并通过 Prometheus/Grafana 采集与展示指标。 |
相关资源
Updated about 5 hours ago