메인 콘텐츠로 건너뛰기
이 가이드는 사전 동기화된 스냅샷으로 OP Stack 실행 클라이언트를 부트스트랩하는 과정을 안내합니다. 스냅샷을 다운로드하고, 체크섬을 검증하고, 데이터 디렉터리에 압축을 해제한 후, genesis부터 체인을 재실행하는 대신 스냅샷의 tip에서 node를 시작합니다. OP Mainnet에서 어떤 스냅샷을 사용할 수 있는지와 다운로드 링크는 스냅샷 레퍼런스 페이지를 참조하십시오.

스냅샷을 사용해야 하는 경우

op-geth는 지원이 종료되었으며(2026-05-31) 현재 활성화된 Karst 하드포크를 지원하지 않으므로, op-geth node는 더 이상 정식(canonical) 체인을 따라갈 수 없습니다. 주요 지원 실행 클라이언트인 op-reth로 마이그레이션하십시오. 전체 마이그레이션 계획은 op-geth 지원 중단 공지를 참조하십시오.
이 가이드는 op-reth node를 전제로 합니다. 스냅샷이 항상 필요한 것은 아닙니다. op-node에서 --syncmode=execution-layer와 --l2.enginekind=reth를 사용하는 실행 레이어 동기화를 사용하면, op-reth는 각 블록을 도출하는 대신 P2P 네트워크를 통해 블록을 가져옵니다. 이렇게 하면 초기 동기화가 훨씬 빨라지며, 대부분의 OP Stack 체인에서는 스냅샷이 전혀 필요하지 않습니다. Nethermind는 필요한 데이터를 자동으로 다운로드합니다. 다음과 같은 경우 스냅샷을 사용하십시오.
  • archive node를 실행하거나, 그 밖의 이유로 전체 체인을 트레이스해야 하는 경우
  • 초기 동기화를 완전히 건너뛰고 싶은 경우: 성숙한 체인의 데이터 디렉터리는 수백 기가바이트에 달할 수 있으며(OP Mainnet의 full node는 약 700 GB), 실행 레이어 동기화를 사용하더라도 처음부터 동기화하는 데 며칠이 걸립니다.
OP Mainnet에서 새 데이터 디렉터리로 op-reth를 동기화하는 경우에도 스냅샷을 사용해야 할 이유가 있습니다. 실행 레이어 동기화가 활성화되어 있더라도 Bedrock 이전 상태 가져오기 요구 사항을 한 번에 충족할 수 있습니다.

시작하기 전에

  • 디스크 공간: 복원하는 동안 압축된 아카이브와 압축 해제된 데이터 디렉터리를 모두 저장할 공간이 일시적으로 필요하므로, 빠른(NVMe 급) 스토리지에 스냅샷 크기의 약 2배를 준비하십시오.
  • 도구: curl(또는 대용량 다운로드 속도를 크게 높일 수 있는 aria2), zstd, tar.
  • 중지된 클라이언트: 실행 클라이언트가 사용 중인 데이터 디렉터리에는 절대 압축을 해제하지 마십시오.

스냅샷 복원

1

스냅샷 선택하기

체인의 스냅샷 제공자에서 네트워크와 클라이언트에 맞는 최신 스냅샷을 선택하십시오. OP Mainnet의 경우 OP Labs가 관리하는 Data Directories 웹사이트를 확인하십시오. 스냅샷 레퍼런스 페이지에는 서드파티 제공자를 포함하여 사용 가능한 소스가 나와 있습니다.
2

다운로드하고 검증하기

아카이브를 다운로드하고 SHA256을 인덱스 페이지에 게시된 값과 비교하십시오.
검증을 건너뛰지 마십시오. 수백 기가바이트 규모의 다운로드가 중간에 잘린 것은 놓치기 쉬우며, 손상된 데이터베이스를 만들게 됩니다.
3

node를 중지하고 기존 datadir 정리하기

node를 이전에 실행한 적이 있고 스냅샷에서 깨끗하게 시작하려면, 실행 클라이언트를 중지하고 데이터 디렉터리의 내용을 삭제(또는 다른 곳으로 이동)하십시오.
4

데이터 디렉터리에 압축 해제하기

먼저 아카이브 구조를 확인한 후 클라이언트의 데이터 디렉터리에 압축을 해제하십시오.
--strip-components=1은 tarball 내부의 최상위 래핑 디렉터리를 제거합니다. 확인 결과 파일이 이미 아카이브 루트에 있다면 이 옵션을 생략하십시오. 클라이언트에 구성된 것과 동일한 경로(op-reth의 경우 --datadir 플래그)를 사용하십시오.
5

node를 시작하고 스냅샷이 적용되었는지 확인하기

복원된 데이터 디렉터리를 가리키도록 실행 클라이언트를 시작한 후, node가 최신 블록으로 0이 아닌 스냅샷의 블록 높이를 보고하는지 확인하십시오.
그러면 node는 스냅샷의 tip에서 현재 head까지 동기화하며, 스냅샷이 얼마나 오래되었는지에 따라 몇 분에서 몇 시간이 걸립니다. 따라잡은 후에는 다운로드한 .tar.zst 아카이브를 삭제하여 디스크 공간을 확보할 수 있습니다.

다음 단계