从快照同步节点
本节将演示使用节点快照,快速同步节点。
快照提供者
节点快照由社区提供和管理。
你可以在这里Berachain bArtio V2 Snapshots找到最新快照。以下将示例同步Berachain基金会提供的节点快照。
什么是节点快照?
快照是一种快速同步节点的方法,无需同步整条链的数据。如果没有快照,节点必须从创世区块开始,下载每个区块的数据,快照可以节省数天甚至数周的同步时间。
快照仍需要一定的时间同步,它们只是特定时间点的链上副本。请务必检查快照的时间戳,确保是最新快照,以便有效使用。
快照有哪些类型?
不同的客户端类型
在Berachain中,共识客户端和执行客户端均有快照。运行节点只需要共识客户端的快照,因为执行客户端可以从其对应的共识客户端重构链历史消息。但如果已有执行客户端快照,建议跳过重构步骤,以减少同步时间。
共识客户端快照
共识数据库
Beacon-Kit允许使用不同的数据库运行节点。默认数据库是pebbledb
,但也支持使用其他数据库 (可以通过初始化客户端实现,config.toml文件中可以找到完整的数据库列表)。
执行客户端快照
选择执行客户端
每个执行客户端保存数据的方式不同,请务必确保使用的快照资源与节点执行客户端相匹配。如果没有可用的执行客户端快照,可以随时从已配对的共识客户端同步执行客户端快照。
快照大小和类型
快照一般包括以下两种类型:
存档 (Archive)
全链历史数据
数据容量大
支持历史查询
修剪 (Pruned)
最新区块数据
数据容量小
快速同步和验证
导入节点快照
不同快照提供商可能有不同的快照使用说明,以下将示例同步Berachain基金会提供的节点快照。
第 1 步:下载快照
根据所在地区和快照类型,从Berachain基金会快照列表中选择信标客户端快照。以下选项可供选择:
下载Beacon客户端快照
在快照文件夹中,信标快照在以下文件路径:
beacon/pruned/
beacon/full/
运行以下代码,下载快照:
# $SNAPSHOT_URL example: https://storage.googleapis.com/bartio-snapshot/beacon/full/snapshot_beacond_full_20240913200045.tar.lz4
wget $SNAPSHOT_URL;
其中,$SNAPSHOT_URL
后所示链接,便是你选择的快照。
下载执行客户端快照
在快照文件夹中,执行客户端快照在以下文件路径:
exec/geth/pruned/
exec/geth/archive/
其他类型,适配不同执行客户端
第 2 步:验证快照 (可选操作)
根据checksum验证快照,确保下载的快照有效。Checksum是快照文件的哈希,用于验证快照的完整性。
Checksum文件由Berachain基金会提供,文件类型为.sha256
,将其添加至快照文件名末尾。例如,如果想获得上述快照文件的sha256sum,则文件名为https://storage.googleapis.com/bartio-snapshot/beacon/full/snapshot_beacond_full_20240913200045.tar.lz4.sha256
。
以下是下载并验证信标快照checksum的示例:
# Download the checksum file
# $SNAPSHOT_URL example: https://storage.googleapis.com/bartio-snapshot/beacon/pruned/beacond-pruned-snapshot-202408292106.tar.lz4
wget $SNAPSHOT_URL.sha256;
# Verify the checksum
# The following command will check the hash against the snapshot file as long as the filename matches
# $SNAPSHOT_CHECKSUM_FILE example: beacond-pruned-snapshot-202408292106.tar.lz4.sha256
sha256sum -c $SNAPSHOT_CHECKSUM_FILE;
# [Expected Equivalent Output]:
# beacond-pruned-snapshot-202408292106.tar.lz4: OK
其中$SNAPSHOT_CHECKSUM_FILE
后所示内容,便是你下载的checksum文件名称。
警告:快照文件文件名与checksum文件文件名务必相同,否则sha256sum
将无法验证快照。此外,快照文件及其checksum文件必须位于同一文件目录中。
第 3 步:导出快照
警告:如果节点正在运行,在导出快照操作前,务必停止运行。否则,有可能导致数据损坏。
导出的快照文件和文件夹格式如下:
# $EXTRACTED_SNAPSHOT_DIR example: /root/beacon-snapshot
tree $EXTRACTED_SNAPSHOT_DIR;
# [Expected Equivalent Output]:
# /root/beacon-snapshot
# ├── data
# ├── application.db
# │ ├── 000056.sst
# │ ├── ...
# │ ├── CURRENT
# │ ├── LOCK
# │ ├── MANIFEST-014039
# │ ├── MANIFEST-014065
# │ └── OPTIONS-014066
# ├── blockstore.db
# │ ├── 002506.sst
# │ ├── ...
# │ ├── CURRENT
# │ ├── LOCK
# │ ├── MANIFEST-047787
# │ ├── MANIFEST-047831
# │ └── OPTIONS-047832
# ├── deposits.db
# │ ├── 001142.log
# │ ├── ...
# │ ├── CURRENT
# │ ├── LOCK
# │ ├── MANIFEST-001125
# │ ├── MANIFEST-001131
# │ └── OPTIONS-001132
# ├── evidence.db
# │ ├── 000075.sst
# │ ├── 000076.sst
# │ ├── 000077.log
# │ ├── CURRENT
# │ ├── LOCK
# │ ├── MANIFEST-000073
# │ ├── MANIFEST-000078
# │ └── OPTIONS-000079
# ├── priv_validator_state.json
# ├── state.db
# ├── 001750.sst
# ├── ...
# ├── CURRENT
# ├── LOCK
# ├── MANIFEST-008554
# ├── MANIFEST-008576
# └── OPTIONS-008577
#
# 13 directories, 4804 files
共识客户端快照配置
首先,运行以下代码,提取Beacon-Kit快照。
# Ensure that you have `lz4` installed on your system
# $BEACOND_SNAPSHOT_FILE example: beacond-pruned-snapshot-202408292106.tar.lz4
# $BEACOND_HOME example: /root/.beacond/
lz4 -d $BEACOND_SNAPSHOT_FILE | tar -xvf - --strip-components=2 -C $BEACOND_HOME;
检查上述代码,$BEACOND_SNAPSHOT_FILE
后所示内容,应指向已下载的信标快照文件名;$BEACOND_HOME
后所示内容,应指向信标快照文件配置目录。
执行客户端快照配置 (可选操作)
操作步骤取决于使用的执行客户端类型,但总体流程相同。
例如,如果你正在使用geth
客户端,则会出现以下类似代码:
# $GETH_SNAPSHOT_FILE example: geth-pruned-snapshot-202408292106.tar.lz4
# $GETH_DATA_DIR example: /root/.ethereum/data/geth
lz4 -c -d $GETH_SNAPSHOT_FILE | tar -x -C $GETH_DATA_DIR;
检查上述代码,$GETH_SNAPSHOT_FILE
后所示内容,应指向已下载的geth快照文件名;$GETH_DATA_DIR
后所示内容,应指向geth快照文件配置目录。
第 4 步:启动节点
现在,你可以重启节点了!运行相应的代码、systemd服务或其他自定义配置,重启信标节点和执行客户端。
最后更新于