Solana 노드 설정 참고

solana-validator 실행 시 사용하는 주요 플래그와 설정 요약입니다.
상세 옵션은 solana-validator --help와 공식 문서를 참고하세요.

클러스터별 설정

엔트리포인트·expected-genesis-hash·known-validator 예시는 Available Clusters에서 확인하세요.

클러스터	RPC URL	엔트리포인트 예시
Mainnet Beta	https://api.mainnet-beta.solana.com	entrypoint.mainnet-beta.solana.com:8001
Testnet	https://api.testnet.solana.com	entrypoint.testnet.solana.com:8001
Devnet	https://api.devnet.solana.com	entrypoint.devnet.solana.com:8001

필수·주요 플래그

식별·경로

--identity <KEYPAIR>: 검증자 identity 키페이어 (RPC만 쓸 때도 필요).
--vote-account <KEYPAIR>: 검증자만 사용. RPC 전용이면 생략하고 --no-voting 사용.
--ledger <DIR>: Ledger 저장 경로 (NVMe 권장).
--accounts <DIR>: Accounts DB 경로 (Ledger와 별도 디스크 권장).

네트워크

--entrypoint <HOST:PORT>: 클러스터 엔트리포인트. 여러 개 지정 가능.
--expected-genesis-hash <HASH>: 클러스터 genesis hash (클러스터 문서 참고).
--known-validator <PUBKEY>: 신뢰할 검증자 목록. 여러 개 지정.
--only-known-rpc: known-validator RPC로만 연결.
--dynamic-port-range <START>-<END>: P2P용 포트 범위 (예: 8000-8020). 8000-10000 TCP/UDP 개방 필요.

RPC

--rpc-port <PORT>: JSON-RPC HTTP 포트 (기본 8899).
--rpc-bind-address <ADDR>: RPC 바인드 주소 (0.0.0.0 시 외부 접근 가능).
--full-rpc-api: 전체 RPC API 활성화.
--private-rpc: RPC 포트를 gossip에 공개하지 않음.

검증자 vs RPC

--no-voting: 합의 참여 안 함 → RPC 전용 노드.
--limit-ledger-size: 로컬 Ledger 크기 제한 (RPC 노드 권장).

복구·로깅

--wal-recovery-mode skip_any_corrupted_record: WAL 손상 시 해당 레코드 건너뜀.
--log <FILE>: 로그 파일 경로.

계정 인덱싱 (Account indexing)

getProgramAccounts, SPL 토큰 관련 RPC 성능 향상을 위해 사용합니다.
RAM 512 GB 이상 권장.

--account-index program-id      # getProgramAccounts
--account-index spl-token-mint # getTokenAccountsByDelegate, getTokenLargestAccounts
--account-index spl-token-owner # getTokenAccountsByOwner 등

여러 인덱스를 쓸 수 있습니다.

포트

8000-10000 TCP/UDP: P2P (gossip, turbine, repair 등). --dynamic-port-range로 13개 포트 범위 지정 가능.
8899 TCP: JSON-RPC HTTP (기본). --rpc-port로 변경 가능.
8900 TCP: WebSocket (RPC_PORT + 1).
스테이킹 검증자는 보안상 RPC 포트를 외부에 열지 않는 경우가 많습니다.

설정 파일

Solana validator는 주로 커맨드라인 인자로 설정합니다.
반복 사용 시 스크립트(예: validator.sh)로 만들어 두고, 필요하면 systemd 서비스로 등록해 사용하세요.