Cardano Docker 노드 가이드

공식적으로 IOHK가 배포하는 cardano-node Docker 이미지를 사용해 Relay/Full 노드를 실행할 수 있습니다.

• 공식 이미지: ghcr.io/intersectmbo/cardano-node
• 공식 문서: Cardano docs - Installing Docker

빠른 실행 (Mainnet Relay)

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

# Relay 노드 실행
docker run -d \
  --name cardano-node \
  --restart unless-stopped \
  -p 3001:3001 \
  -v cardano-data:/data/db \
  -v cardano-ipc:/ipc \
  -e NETWORK=mainnet \
  ghcr.io/intersectmbo/cardano-node:10.1.4

• 3001: P2P 포트(기본)
• /ipc: cardano-cli가 노드와 통신할 Unix 소켓이 위치

상태 확인

# 로그
docker logs -f cardano-node

# 동기화 진행률
docker exec -ti cardano-node bash -c '
  CARDANO_NODE_SOCKET_PATH=/ipc/node.socket \
  cardano-cli query tip --mainnet'

응답 예시:

{
  "block": 10999999,
  "epoch": 500,
  "era": "Conway",
  "hash": "…",
  "slot": 140000000,
  "syncProgress": "100.00"
}

Preprod/Preview 테스트넷

docker run -d --name cardano-node-preprod \
  -p 3001:3001 \
  -v cardano-preprod:/data/db -v cardano-ipc-preprod:/ipc \
  -e NETWORK=preprod \
  ghcr.io/intersectmbo/cardano-node:10.1.4

블록 프로듀서(BP) 구성 참고

BP 노드는 KES/VRF/Operational Certificate 키 관리가 필수이며, Relay 뒤에 배치해 P2P 노출을 최소화합니다. Docker로도 가능하지만 키 주입·방화벽 설정은 ../localhost/README.md 의 수동 설치 절차를 참고하세요.

참고

• Cardano Stake Pool Operators School
• Guild Operators guide-mode — 커뮤니티 운영 스크립트