Starknet Docker 가이드 (Juno 기준)
Juno는 Nethermind가 개발한 Go 구현 Starknet Full Node입니다. 공식 Docker 이미지가 배포됩니다.
- 공식 저장소: https://github.com/NethermindEth/juno
- 공식 이미지: nethermind/juno
- 공식 문서: https://juno.nethermind.io/
빠른 실행 (Mainnet)
# 데이터 볼륨 준비
sudo mkdir -p /data/juno
sudo chown -R 1000:1000 /data/juno
docker run -d --name juno \
--restart unless-stopped \
-p 6060:6060 -p 6061:6061 \
-v /data/juno:/var/lib/juno \
nethermind/juno:v0.13.0 \
--network mainnet \
--http --http-host 0.0.0.0 --http-port 6060 \
--db-path /var/lib/juno \
--eth-node https://<L1_MAINNET_RPC>
- 6060: HTTP JSON-RPC
- 6061: WebSocket RPC
- L1 RPC: Starknet 증명 검증에 필요 (Archive/Execution, WebSocket 권장)
Pathfinder (대안)
docker run -d --name pathfinder \
--restart unless-stopped \
-p 9545:9545 \
-v /data/pathfinder:/usr/share/pathfinder/data \
eqlabs/pathfinder:v0.15.1 \
--network mainnet \
--ethereum.url wss://<L1_WS_RPC>
포트 9545: HTTP/WebSocket RPC.
상태 확인
# 최신 블록
curl -s -X POST http://localhost:6060 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"starknet_blockNumber","params":[],"id":1}' | jq
# 동기화 상태
curl -s -X POST http://localhost:6060 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"starknet_syncing","params":[],"id":1}' | jq
스냅샷
Starknet은 Genesis부터 동기화 시 수 일이 걸립니다. 공식/커뮤니티 스냅샷 사용 권장.
- Juno snapshots: https://juno.nethermind.io/snapshots
- Pathfinder DB snapshots: 커뮤니티 제공