Hedera Mirror Node / Local Node 설치 가이드

Mirror Node(데이터 조회)와 Local Node(개발용) 설치 방법입니다.
출처: Hedera Docs, hedera-mirror-node, hedera-local-node.

Mirror Node

메인넷/테스트넷 데이터를 REST·gRPC로 조회하는 노드입니다.

GCP Marketplace에서 Kubernetes로 Mirror Node를 배포합니다.

사전 준비: One-Click Mirror Node Deployment 문서의 “How To Obtain Google Cloud Platform Requester Pay Information”에 따라 GCP HMAC 액세스 키·시크릿·빌링 프로젝트 ID·GCS 버킷 이름 등을 준비합니다.
테스트넷 버킷: hedera-stable-testnet-streams-2024-02
메인넷 버킷: hedera-mainnet-streams
GCP Marketplace - Hedera Mirror Node에서 배포를 진행합니다. 준비한 Importer GCP secret key, billing project ID, GCS bucket name, access key 등을 입력합니다.
배포 후 gRPC: 서비스 hedera-mirror-node-1-grpc (예: 포트 5600)
REST: 서비스 hedera-mirror-node-1-rest, 예: http://<REST_IP>/api/v1/transactions?limit=1

자세한 단계·엔드포인트 확인: One-Click Deployment.

요구사항: Java 21+, Docker(20.10+), Postgres. Kubernetes 등 환경은 Node Requirements 참고.
저장소: hashgraph/hedera-mirror-node

git clone https://github.com/hashgraph/hedera-mirror-node.git
cd hedera-mirror-node
./gradlew build -x test
# 또는: ./gradlew clean build -x test

실제 실행·디스크·스트리밍 설정은 저장소의 docs 및 Hedera Docs의 Mirror Node 가이드를 따르세요.

로컬 개발/테스트용 Consensus + Mirror 네트워크입니다.

npm install -g @hashgraph/hedera-local
hedera local start

Docker Compose로 로컬 노드가 기동됩니다. 중지·재시작 등은 hedera local --help 및 Setup Hedera Node CLI (NPM) 참고.

hashgraph/hedera-local-node 저장소를 클론한 뒤, 포함된 Docker Compose·README에 따라 실행합니다.

git clone https://github.com/hashgraph/hedera-local-node.git
cd hedera-local-node
# 저장소 README의 실행 방법 따르기

Consensus Node는 Council 멤버만 운영할 수 있습니다.
요구사항(고사양 하드웨어, DMZ 등)·배포 절차는 다음 문서만 참고하세요. 일반 사용자는 설치 대상이 아닙니다.