节点快照（Snapshots）
本文档介绍如何使用快照快速启动 Gate Layer 节点（全节点与归档节点），涵盖适用场景、下载与校验、替换数据目录及常见注意事项。
1. 何时使用快照
- 加速同步：直接使用官方提供的数据目录，可显著缩短初次同步时间。
- 归档需求：需要执行历史追溯或完整链上数据时，可使用归档快照。
- 灾备恢复：节点故障后快速恢复至某个时间点。
说明：执行层客户端为 gatelayer-geth，快照主要用于其数据目录替换。
2. 快照目录与下载链接
主网（Gate Layer Mainnet）
| 全节点（Full） | 2025-11-17 | 44G | https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst | 896af659234f242006e4ed3fb9205d33 |
| 归档（Archive） | 2025-11-17 | 443G | https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/archive/chaindata-2025-11-17.tar.zst | d6e3c3d247e4fd85d5a003494e08a4ac |
3. 使用教程
3.1 下载与校验
3.1 使用 aria2/wget 下载
# 使用 aria2c（并发分段下载，速度更快）
aria2c -x 16 -s 16 https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst
# 使用 wget
wget https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst
3.2 验证校验和
# 若已提供 .xxh 文件，可先下载
https://gatelayer-snapshot.s3.ap-northeast-1.amazonaws.com/mainnet/full/chaindata-2025-11-17.tar.zst.xxh
# 校验
xxhsum -H128 -c chaindata-2025-11-17.tar.zst.xxh
对比输出与发布的校验值是否一致，若不一致请重新下载。
3.3 解压
方法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.2 替换数据目录（以 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 章节）。