Tezos 호스트 설치 가이드

Ubuntu 22.04 기준 octez-node 설치·실행 개요입니다. 공식 문서: https://tezos.gitlab.io/introduction/howtoget.html.

시스템 요구사항

패키지 설치 (권장)

# Serokell Tezos Packaging
wget https://github.com/serokell/tezos-packaging/releases/latest/download/tezos-client
wget https://github.com/serokell/tezos-packaging/releases/latest/download/tezos-node
chmod +x tezos-client tezos-node
sudo mv tezos-client tezos-node /usr/local/bin/
octez-node --version

또는 공식 APT:

REPO="ppa:serokell/tezos"
sudo add-apt-repository -y "$REPO"
sudo apt update
sudo apt install -y tezos-client tezos-node tezos-baker

노드 설정

DATA_DIR=$HOME/.tezos-node

octez-node config init \
  --data-dir="$DATA_DIR" \
  --network=mainnet \
  --history-mode=rolling \
  --rpc-addr=127.0.0.1:8732 \
  --net-addr=0.0.0.0:9732

# 스냅샷 가져오기
wget -O /tmp/mainnet.rolling.snapshot https://mainnet.xtz-shots.io/rolling
octez-node snapshot import /tmp/mainnet.rolling.snapshot --data-dir="$DATA_DIR"

실행

octez-node run --data-dir="$DATA_DIR" --rpc-addr=127.0.0.1:8732

systemd 서비스

# /etc/systemd/system/octez-node.service
[Unit]
Description=Tezos (octez) Node
After=network-online.target

[Service]
User=tezos
ExecStart=/usr/local/bin/octez-node run --data-dir /home/tezos/.tezos-node --rpc-addr 127.0.0.1:8732 --net-addr 0.0.0.0:9732
Restart=on-failure
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now octez-node
journalctl -u octez-node -f

상태 조회

octez-client rpc get /chains/main/blocks/head/header
octez-client rpc get /monitor/bootstrapped

Baker 추가 절차

1. 베이커 계정 생성·등록 (octez-client gen keys ..., octez-client register key ... as delegate)
2. 활성 프로토콜에 맞는 octez-baker-* 실행 (systemd 권장)
3. Accuser도 함께 실행(이중 서명 감시·슬래시 방지)

자세한 절차는 Baking 가이드 참고.

참고

• Octez Documentation
• Tezos Network Stats