Solana 노드 Localhost 설치 가이드

호스트 시스템(Ubuntu 권장)에 Solana CLI와 solana-validator를 설치하고, 검증자 또는 RPC 노드로 운영하는 방법입니다.

공식 문서: Setup a Validator, Setup an RPC Node.

파일 구조

localhost/
├── installation.md       # 설치 가이드 (CLI → Validator → RPC)
├── configuration.md      # 설정·플래그 참고
├── troubleshooting.md   # 트러블슈팅
├── updates/
│   └── README.md
└── README.md            # 이 파일

빠른 시작

1. 설치

installation.md를 참고하여 Solana CLI를 설치한 뒤, 검증자 또는 RPC 노드로 solana-validator를 설정·실행하세요.

2. 설정

configuration.md에서 클러스터별 플래그, RPC 전용 옵션, --account-index 등을 참고하세요.

3. 문제 해결

문제가 발생하면 troubleshooting.md와 Solana Validator 문서를 참고하세요.

메트릭 엔드포인트 (Prometheus)

Agave(구 solana-validator)는 자체 Prometheus exporter를 제공합니다.
기본 바인딩: --expose-metrics + --metrics-config "host=0.0.0.0,port=9100" (과거 경로의 예). 최신 플래그는 Agave metrics docs 참고.
노출 포트: 9100
전체 모니터링 스택: ../../../common/monitoring-stack.md

Docker 설치 (RPC 노드)

Docker로 RPC 노드를 실행하는 방법은 ../docker/README.md를 참고하세요.