Cardano 호스트 설치 가이드

Ubuntu 22.04 기준 cardano-node 바이너리 설치·실행 개요입니다. 공식 상세 문서: https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/.

시스템 요구사항

바이너리 설치 (공식 릴리스)

# 최신 릴리스 다운로드
wget https://github.com/IntersectMBO/cardano-node/releases/download/10.1.4/cardano-node-10.1.4-linux.tar.gz
tar -xzvf cardano-node-10.1.4-linux.tar.gz -C ~/cardano

# PATH 등록
echo 'export PATH=$HOME/cardano/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

cardano-node --version
cardano-cli --version

네트워크 설정 파일 다운로드

mkdir -p ~/cardano/mainnet && cd ~/cardano/mainnet
BASE=https://book.play.dev.cardano.org/environments/mainnet

for f in config.json topology.json byron-genesis.json \
         shelley-genesis.json alonzo-genesis.json conway-genesis.json; do
  wget -q "$BASE/$f"
done

실행

cardano-node run \
  --topology ~/cardano/mainnet/topology.json \
  --database-path ~/cardano/mainnet/db \
  --socket-path ~/cardano/mainnet/node.socket \
  --host-addr 0.0.0.0 --port 3001 \
  --config ~/cardano/mainnet/config.json

systemd 서비스 (예시)

# /etc/systemd/system/cardano-node.service
[Unit]
Description=Cardano Node
After=network-online.target

[Service]
Type=simple
User=cardano
ExecStart=/home/cardano/cardano/bin/cardano-node run \
  --topology /home/cardano/cardano/mainnet/topology.json \
  --database-path /home/cardano/cardano/mainnet/db \
  --socket-path /home/cardano/cardano/mainnet/node.socket \
  --host-addr 0.0.0.0 --port 3001 \
  --config /home/cardano/cardano/mainnet/config.json
Restart=on-failure
LimitNOFILE=32768

[Install]
WantedBy=multi-user.target

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

Tip 조회

export CARDANO_NODE_SOCKET_PATH=$HOME/cardano/mainnet/node.socket
cardano-cli query tip --mainnet

참고

• Guild Operators CNTools
• Cardano Stake Pool School