Algorand Docker 노드 가이드

Algorand는 공식 algorand/algod Docker 이미지를 제공합니다. Participation Node(Validator)와 Non-Participation Node 모두 같은 이미지로 운영합니다.

• 공식 이미지: algorand/algod
• 공식 문서: https://developer.algorand.org/docs/run-a-node/setup/install/

Mainnet 실행

docker run -d --name algod \
  --restart unless-stopped \
  -p 4160:4160 -p 8080:8080 \
  -v algod-data:/algod/data \
  -e NETWORK=mainnet \
  -e TOKEN="" \
  -e TELEMETRY_NAME="my-algo-node" \
  algorand/algod:latest

• 4160: P2P
• 8080: algod REST API

상태 확인

# 토큰 조회 (컨테이너 내부)
ALGOD_TOKEN=$(docker exec algod cat /algod/data/algod.token)
ADMIN_TOKEN=$(docker exec algod cat /algod/data/algod.admin.token)

# 최신 라운드
curl -s -H "X-Algo-API-Token: $ALGOD_TOKEN" \
  http://localhost:8080/v2/status | jq '.["last-round"]'

# 동기화 상태
curl -s -H "X-Algo-API-Token: $ALGOD_TOKEN" \
  http://localhost:8080/v2/status | jq '{last: .["last-round"], catch: .["catchup-time"]}'

Archival 모드

# profile을 archival로 지정
docker run -d --name algod-archival \
  -p 4160:4160 -p 8080:8080 \
  -v algod-archive-data:/algod/data \
  -e NETWORK=mainnet \
  -e PROFILE=archival \
  algorand/algod:latest

Archival은 디스크 요구가 훨씬 큽니다(수 TB). 필요 없다면 기본(Relay) 모드로 운영하세요.

참고

• Algorand Node Types
• algod Config