Hedera 노드 가이드

Hedera Hashgraph 노드 관련 문서 정리입니다.
Hedera는 퍼미션드 네트워크이며, Consensus Node는 Council 멤버(26개 기관)만 운영할 수 있습니다. 일반 사용자는 Mirror Node(데이터 조회용) 또는 Local Node(개발/테스트용)를 설치합니다.

공식 문서: Hedera Docs · Node Requirements.

노드 종류

종류	대상	용도
Consensus Node	Council 멤버만	메인넷 합의·트랜잭션 처리. 초대제, 고사양(Docker 20.10+, K8s 등).
Mirror Node	일반 사용자 권장	메인넷/테스트넷 데이터 조회. REST/gRPC API. One-Click(GCP) 또는 자체 설치(Java 21+, Docker, Postgres).
Local Node	개발자	로컬 개발/테스트 네트워크. NPM `@hashgraph/hedera-local` 또는 hedera-local-node Docker Compose.

개발·데이터 쿼리는 Mirror Node 또는 Local Node부터 시작하세요. SDK는 @hashgraph/sdk 사용.

설치 방법

Mirror Node (데이터 쿼리용)

One-Click: One-Click Mirror Node Deployment — GCP Marketplace, Kubernetes.
자체 설치: hedera-mirror-node — Java 21+, Docker, Postgres, ./gradlew build.

시작하기: localhost/README.md

Local Node (개발용)

NPM: npm i -g @hashgraph/hedera-local 후 hedera local start (Docker Compose로 consensus + mirror).
GitHub: hashgraph/hedera-local-node.

시작하기: localhost/README.md

Consensus Node (Council 전용)

Node Requirements: 고사양(CPU 64+, RAM 512GB+, NVMe 10TB+ 등), DMZ 네트워크.
Node Deployment Process: Council 전용 배포 절차.

일반인은 운영 불가. 참고용으로만 문서 링크를 둡니다.

폴더 구조

hedera/
├── README.md                 # 이 파일
├── localhost/                # Mirror Node / Local Node 가이드
│   ├── README.md
│   ├── installation.md       # Mirror Node·Local Node 설치
│   ├── configuration.md      # Mirror·Local 설정 참고
│   ├── troubleshooting.md
│   └── updates/
│       └── README.md
└── docker/                   # 배포 참고 (One-Click·Local Node)
    └── README.md

hedera