数据库快照

📘

前置阅读

• 节点概述
• 部署节点

数据库快照是 TRON 网络节点数据库在近期某个区块高度上的压缩备份。从快照启动新节点只需数小时，而从创世区块（高度 0）冷同步则要数天甚至数月。TRON 社区定期生成这些快照，托管在公开下载镜像站上。

本文列出当前的镜像站点、不同快照的选型对比，以及节点启动时应用快照的步骤。

📘

Toolkit 伴随版本发布。 每一个发布的 java-tron 版本中，都包含一个与 FullNode.jar 配套的 Toolkit 维护工具集（Toolkit.jar）。该工具集支持诸多数据库运维操作：从全节点生成轻节点快照、跨磁盘卷高速复制数据、在 LevelDB 与 RocksDB 存储引擎之间转换、拆分数据库分区，以及应用 LevelDB 启动优化。无需单独下载，它已内置在发布的压缩归档中。详情请参阅节点维护工具套件。

选择快照

快照在三个维度上有差异，请按节点用途选择。

全节点快照

注：上表大小为近期测定值，数据量随出块持续增长。规划磁盘空间时，请到对应镜像站的目录列表查看当前快照的准确大小。

⚠️

LevelDB 和 RocksDB 数据库引擎不可互换。 下载的快照引擎必须与 config.conf 中 db.engine（LEVELDB 或 ROCKSDB）设置一致。混用存储引擎，或在现有数据目录上直接切换引擎，都会损坏数据库。

轻节点快照

轻节点快照只含当前全局状态和最近 65,536 个区块（由 DbLite.java 的 RECENT_BLKS 参数指定），大小通常只占全节点数据集的极小比例。轻节点与全节点在性能和历史数据上的差异，参阅轻节点概述。

📘

目前轻节点的快照镜像站覆盖较窄。如果本地网络到镜像站的延迟较高，也可以用轻节点裁剪工具，直接在运行正常的本地全节点上裁剪生成轻节点快照。

下载与解压

⚠️

单线程下载限制

主网快照为单一大文件，为保障镜像服务器可用性，下载链接限制了并发连接数。请只用单线程工具下载；若检测到多线程并发下载，服务器可能直接返回 404 Not Found 错误。

主网全节点快照解压后超过 2.9 TB，提供以下两种下载与解压方式：

流式下载并解压（推荐）

用管道同时下载和解压，无需在磁盘上额外保留一份压缩归档，明显节省存储成本：

#!/bin/bash
wget -q -O - SNAPSHOT_URL/FullNode_output-directory.tgz | tar -zxvf -

把 SNAPSHOT_URL 替换为所选镜像站中快照的实际下载链接，把上面的脚本保存为 download_snapshot.sh 后运行：

bash download_snapshot.sh

这个方案只需要解压后数据集所需的存储空间（约 3 TB 以上），比先下载后解压节省约一半磁盘。

完整下载后再解压（需要双倍磁盘空间）

# 1. 下载压缩归档包
wget SNAPSHOT_URL/FullNode_output-directory.tgz

# 2. 进行解压
tar -zxvf FullNode_output-directory.tgz

这种方式在解压期间，磁盘要同时容纳压缩归档和解压后的数据集，因此至少需要 6 TB 以上的磁盘卷（解压完成后可手动删除 .tgz 归档释放空间）。

使用快照

1. 把解压出的数据库文件夹（通常是 output-directory）放在节点 FullNode.jar 同目录下（或自定义的挂载路径下）。

2. 启动节点。客户端默认读取 ./output-directory 目录。如果把数据目录放在其他路径，在启动参数里加 -d <path> 指定：

   Bash

   java -Xmx24g -XX:+UseConcMarkSweepGC -jar FullNode.jar -c config.conf -d /custom/path

3. 节点启动后自动检测到本地快照，开始同步快照高度到当前主网最新高度之间的区块差额，通常数小时即可追平，无需等待数月的冷同步。

完整的部署与升级步骤，请参阅部署节点。

相关资源

• 部署节点——端到端部署流程，包括如何使用快照启动节点
• 节点概述——全节点与轻节点的概念对比与选型
• 节点维护工具套件——使用 Toolkit 自行进行数据库裁剪、拆分与转换