节点升级 【2025.12】

1. 升级说明

本次升级为大版本升级，新版本使用的数据存储格式与旧版本不兼容，需要重新同步全链数据。 为了保障升级过程业务运行稳定，建议部署全新节点进行同步升级，待新节点同步完成后再停止旧节点，并使用新节点对外提供服务。

2. 硬件及系统配置建议

组件	配置建议
CPU	8 核及以上
内存	16G 及以上
硬盘存储	1.5T SSD 及以上
网络带宽	100Mbps 以上
公网 IP	需独立固定公网 IP
操作系统	Ubuntu 24.04 及以上

3. 升级前准备

• 准备服务器并完成系统安装；

• 配置好独立固定公网 IP；

• 联系对接人员，将节点 IP 添加至白名单；

4. 升级步骤

1. 解压升级包；

2. 进入 juchain 目录，执行创世区块初始化：

   ./bin/geth --datadir data init config/genesis.json

3. 运行启动脚本：

   bash start.sh

4. 观察 logs/ 目录下日志是否正常输出；

5. 等待节点完成全量数据同步；

6. 同步完成后对外提供服务；

⚠️ 重要提示

1. ⚠ 请务必在 2025-12-05 12:00:00 之后再使用新节点对外提供服务，否则可能出现服务不稳定。

2. ⚠ 在主网分叉正式确认成功前（2025-12-10 12:00:00），请不要删除或拆除旧节点环境，以便在必要时进行回滚，避免影响核心业务。

5. 回滚步骤

如果 JuChain 主网分叉升级失败，请立即：

1. 停止新部署的同步节点；

2. 继续使用旧节点对外提供服务；

3. 如需协助，请及时联系技术对接人员；

6. 升级包

28MB

juchain-sync-node-v1.13.15.tgz

Open

✅ 建议部署前使用 SHA256 或其他校验工具验证文件完整性。

7. 技术支持

• 需要添加 IP 白名单、确认同步状态或技术协助时，请联系您的对接人员。