Tezos Docker 노드 가이드

Tezos 공식 Docker 이미지(tezos/tezos)는 모든 바이너리(octez-node, octez-client, octez-baker-*)를 포함합니다.

• 공식 이미지: DockerHub tezos/tezos
• 공식 문서: https://tezos.gitlab.io/introduction/howtoget.html#using-docker-images
• 사전 구성 이미지(helpers): serokell/tezos-packaging

Mainnet (Rolling 모드)

# 데이터 볼륨 생성
docker volume create node-data

# 노드 실행
docker run -d --name tezos-node \
  --restart unless-stopped \
  -p 8732:8732 -p 9732:9732 \
  -v node-data:/var/run/tezos/node \
  tezos/tezos:octez-v20.3 \
  octez-node --network=mainnet --history-mode=rolling \
  --rpc-addr=0.0.0.0:8732 --net-addr=0.0.0.0:9732

• 8732: RPC
• 9732: P2P

스냅샷 가져오기 (권장)

Rolling 모드도 Genesis 동기화가 오래 걸립니다. 스냅샷으로 시작:

# 스냅샷 다운로드 (XtzTools, Marigold 등)
wget -O /tmp/mainnet.rolling.snapshot \
  https://mainnet.xtz-shots.io/rolling

docker run --rm \
  -v node-data:/var/run/tezos/node \
  -v /tmp:/snapshots \
  tezos/tezos:octez-v20.3 \
  octez-node snapshot import /snapshots/mainnet.rolling.snapshot

상태 확인

# Chain header
curl -s http://localhost:8732/chains/main/blocks/head/header | jq

# Bootstrap status
curl -s http://localhost:8732/monitor/bootstrapped | jq

History modes

--history-mode=archive로 교체 시 새로운 데이터 디렉토리부터 시작 권장.

Baker / Accuser 실행

Baking은 별도 컨테이너로 실행:

docker run -d --name tezos-baker \
  --restart unless-stopped \
  -v node-data:/var/run/tezos/node \
  -v client-data:/var/run/tezos/client \
  tezos/tezos:octez-v20.3 \
  octez-baker-PtParisB run with local node /var/run/tezos/node <BAKER_ALIAS>

프로토콜이 활성화될 때마다 베이커 바이너리 suffix(PtParisB, PsQuebec 등)가 달라집니다. 활성 프로토콜에 맞는 베이커를 사용하세요.

참고

• Octez Releases
• XTZ Shots (snapshots)
• TZNode