节点快照（Snapshots）
本文档介绍如何使用快照快速启动 Gate Layer 节点（全节点与归档节点），涵盖适用场景、下载与校验、替换数据目录及常见注意事项。
1. 何时使用快照
- 加速同步：直接使用官方提供的数据目录，可显著缩短初次同步时间。
- 归档需求：需要执行历史追溯或完整链上数据时，可使用归档快照。
- 灾备恢复：节点故障后快速恢复至某个时间点。
说明：执行层客户端为
gatelayer-geth，快照主要用于其数据目录替换。
2. 快照目录与下载链接
主网（Gate Layer Mainnet）
| 节点类型 | 下载链接 |
|---|---|
| 全节点（Full） | wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/$ (curl -s https://gatelayer-snapshot.gatenode.cc/api/v1/snapshots/latest/full) |
| 归档（Archive） | wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/archive/$ (curl -s https://gatelayer-snapshot.gatenode.cc/api/v1/snapshots/latest/archive) |
3. 使用教程
3.1 下载与校验
注意：如需下载archive节点快照，将链接中的
full更换称为archive即可。
3.1.1 获取最新Snapshot名称
curl -s https://gatelayer-snapshot.gatenode.cc/api/v1/snapshots/latest/full
3.1.2 下载Snapshot文件
SNAPSHOT=$(curl -s https://gatelayer-snapshot.gatenode.cc/api/v1/snapshots/latest/full)
wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/${SNAPSHOT}
3.1.3 下载xxHash128校验文件
wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/${SNAPSHOT}.xxh128
3.1.4 查看官方校验值
cat ${SNAPSHOT}.xxh128
3.1.5 执行完整性校验（推荐）
xxh128sum ${SNAPSHOT}
注意： 将计算结果与 .xxh128 文件中的 hash 进行对比，必须完全一致。
3.2 解压
方法1：
tar -I zstd -xf chaindata-2025-11-17.tar.zst
方法2：
zstd -d < chaindata-2025-11-17.tar.zst | tar -xf -
注意：快照只包含
geth/chaindata
3.3 替换数据目录（以 gatelayer-geth 为例）
在执行以下步骤前，请先正常停止正在运行的 gatelayer-geth：
# 1) 停止执行层客户端（确保已完全退出）
# systemctl stop gatelayer-geth 或 pkill -f gatelayer-geth
# 2) 备份原数据
mv ${OPGeth_DataDir}/geth/chaindata ${OPGeth_DataDir}/geth/chaindata_backup
# 3) 放置快照数据到对应目录
mv ./chaindata ${OPGeth_DataDir}/geth/chaindata
路径说明：
$OPGeth_DataDir为gatelayer-geth的数据目录（与您在启动参数中指定的--datadir保持一致）。
4. 常见注意事项
- 校验一致性：务必校验
xxHash128sum，防止因下载损坏导致的数据库错误。 - nodekey 不应包含在快照中：若自行制作快照，请勿打包
geth/nodekey（不同节点需使用不同的 P2P nodekey），避免 P2P 连接异常。 - 状态数据库方案：请使用与链当前配置匹配的状态数据库方案（例如 hash/path-based 等）。Gate Layer 官方发布的快照会与链配置一致。
- 归档体积较大：归档快照体积可能非常大，下载与解压耗时、占用空间显著高于全节点快照。
如需结合运行节点的完整流程，请参见：运行 L2 RPC 节点（Gate Layer Development 章节）。