zkSync Era Docker 노드 가이드 (External Node)

zkSync Era의 일반 사용자용 노드는 External Node (EN) 입니다. Postgres를 함께 운영합니다.

• 공식 이미지: matterlabs/external-node
• 공식 가이드: https://matter-labs.github.io/zksync-era/core/latest/guides/external-node/
• docker-compose 예시: https://github.com/matter-labs/zksync-era/tree/main/docker/external-node

빠른 실행 (Mainnet EN)

git clone https://github.com/matter-labs/zksync-era.git
cd zksync-era/docker-compose-examples/external-node

cp .env.example .env
# .env 편집
#   MAIN_NETWORK=mainnet
#   L1_RPC_URL=<Ethereum L1 RPC>
#   DATABASE_URL=postgres://postgres:postgres@postgres:5432/en

docker compose -f docker-compose.yml up -d
docker compose logs -f external-node

포트

• 3050: HTTP JSON-RPC
• 3051: WebSocket RPC
• 3322: External Node HTTP API (조회용)

디스크

• Mainnet EN: 약 1 TB Postgres + 추가 state 디스크

상태 확인

curl -s -X POST http://localhost:3050 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' | jq

참고

• External Node Setup
• zksync-era Releases