从快照同步节点

本节将演示使用节点快照，快速同步节点。

快照提供者

节点快照由社区提供和管理。

你可以在这里Berachain bArtio V2 Snapshots找到最新快照。以下将示例同步Berachain基金会提供的节点快照。

什么是节点快照？

快照是一种快速同步节点的方法，无需同步整条链的数据。如果没有快照，节点必须从创世区块开始，下载每个区块的数据，快照可以节省数天甚至数周的同步时间。

快照仍需要一定的时间同步，它们只是特定时间点的链上副本。请务必检查快照的时间戳，确保是最新快照，以便有效使用。

快照有哪些类型？

不同的客户端类型

在Berachain中，共识客户端和执行客户端均有快照。运行节点只需要共识客户端的快照，因为执行客户端可以从其对应的共识客户端重构链历史消息。但如果已有执行客户端快照，建议跳过重构步骤，以减少同步时间。

共识客户端快照

• 共识数据库

Beacon-Kit允许使用不同的数据库运行节点。默认数据库是pebbledb，但也支持使用其他数据库 (可以通过初始化客户端实现，config.toml文件中可以找到完整的数据库列表)。

执行客户端快照

• 选择执行客户端

每个执行客户端保存数据的方式不同，请务必确保使用的快照资源与节点执行客户端相匹配。如果没有可用的执行客户端快照，可以随时从已配对的共识客户端同步执行客户端快照。

快照大小和类型

快照一般包括以下两种类型：

快照类型	历史数据	快照大小	优点
存档 (Archive)	全链历史数据	数据容量大	支持历史查询
修剪 (Pruned)	最新区块数据	数据容量小	快速同步和验证

导入节点快照

不同快照提供商可能有不同的快照使用说明，以下将示例同步Berachain基金会提供的节点快照。

第 1 步：下载快照

根据所在地区和快照类型，从Berachain基金会快照列表中选择信标客户端快照。以下选项可供选择：

所在地区	快照类型	快照链接
北美	Archive / Pruned	Link
欧洲	Archive / Pruned	Link
亚洲	Archive / Pruned	Link

1. 下载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后所示链接，便是你选择的快照。

curl、aria2c等下载工具也可以用于下载快照。

1. 下载执行客户端快照

在快照文件夹中，执行客户端快照在以下文件路径：

• 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

1. 共识客户端快照配置

首先，运行以下代码，提取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后所示内容，应指向信标快照文件配置目录。

1. 执行客户端快照配置 (可选操作)

操作步骤取决于使用的执行客户端类型，但总体流程相同。

例如，如果你正在使用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服务或其他自定义配置，重启信标节点和执行客户端。