노드 스냅샷

스냅샷을 사용하면 Base 노드의 초기 동기화에 필요한 시간을 크게 줄일 수 있습니다. 스냅샷은 정기적으로 업데이트됩니다. Base 노드를 운영 중이거나 운영할 예정이라면 스냅샷에서 복원하여 초기 동기화를 빠르게 할 수 있습니다. 아래 단계를 주의 깊게 따르세요.

스냅샷에서 복원하기

이 단계는 클론된 node 디렉토리(docker-compose.yml이 포함된 디렉토리)에 있다고 가정합니다.

데이터 디렉토리 준비:
- Docker를 처음 실행하기 전에 Docker 컨테이너에 매핑될 호스트 머신의 데이터 디렉토리를 생성합니다. 이 디렉토리는 docker-compose.yml 파일의 volumes 매핑과 일치해야 합니다.
  mkdir ./reth-data
- 이전에 노드를 실행했고 기존 데이터 디렉토리가 있는 경우 노드를 중지(docker compose down)하고, 기존 디렉토리의 _내용_을 삭제(예: rm -rf ./reth-data/*)한 후 진행합니다.

스냅샷 다운로드: 아래 표에서 네트워크와 클라이언트에 적합한 스냅샷을 선택합니다. wget(또는 유사한 도구)을 사용하여 node 디렉토리로 다운로드합니다.

네트워크	스냅샷 유형	다운로드 명령어 (`wget …`)
테스트넷	아카이브 (권장)	`wget -c https://sepolia-reth-archive-snapshots.base.org/$(curl https://sepolia-reth-archive-snapshots.base.org/latest)`
테스트넷	프룬드	`wget -c https://sepolia-reth-pruned-snapshots.base.org/$(curl https://sepolia-reth-pruned-snapshots.base.org/latest)`
메인넷	아카이브 (권장)	`wget -c https://mainnet-reth-archive-snapshots.base.org/$(curl https://mainnet-reth-archive-snapshots.base.org/latest)`
메인넷	프룬드	`wget -c https://mainnet-reth-pruned-snapshots.base.org/$(curl https://mainnet-reth-pruned-snapshots.base.org/latest)`

스냅샷 아카이브(.tar.gz / .tar.zst 파일)를 다운로드하고 내용을 추출하기에 충분한 여유 디스크 공간이 있는지 확인하세요. 추출된 데이터는 아카이브보다 훨씬 큽니다.

스냅샷 추출: 다운로드한 스냅샷 아카이브를 압축 해제합니다. snapshot-filename을 실제 다운로드한 파일명으로 교체하세요:
```
tar -xzvf <snapshot-filename.tar.gz>

# .tar.zst 파일의 경우
tar -I zstd -xvf <snapshot-filename.tar.zst>
```
데이터 이동: 추출 과정에서 reth 디렉토리가 생성될 수 있습니다.
- 해당 디렉토리의 _내용_을 1단계에서 생성한 데이터 디렉토리로 이동합니다:
  mv ./reth/* ./reth-data/ rm -rf ./reth # 빈 추출 폴더 정리
- 목표는 체인 데이터 디렉토리(예: chaindata, nodes, segments 등)가 중첩된 하위 폴더가 아닌 ./reth-data 내에 직접 있는 것입니다.
노드 시작: 스냅샷 데이터가 준비되었으면 Base 노드 폴더의 루트로 돌아가서 노드를 시작합니다:
```
cd ..
docker compose up --build
```

노드가 스냅샷의 마지막 블록부터 동기화를 시작해야 합니다.

확인 및 정리: 노드 로그(docker compose logs -f <service_name>)를 모니터링하거나 동기화 모니터링 명령을 사용하여 노드가 스냅샷의 블록 높이에서 동기화를 시작하는지 확인합니다. 확인되면 다운로드한 스냅샷 아카이브(.tar.gz 파일)를 안전하게 삭제하여 디스크 공간을 확보할 수 있습니다.