Polkadot 노드 설정 참고

Polkadot Full Node 실행 시 자주 쓰는 커맨드 라인 옵션 요약입니다.
출처: Set Up a Node, Important Flags for RPC Node.

체인·노드 이름

• --chain: polkadot (기본), kusama 등. 동일 바이너리로 릴레이 체인 전환.
• --name: 노드 식별자. Telemetry에 표시됨.

Pruning (저장 용량·역사 조회)

• 기본 Pruned: 옵션 없으면 최근 256블록 등 기본값 적용.
• 커스텀 Pruned:
  --state-pruning 1000 --blocks-pruning archive (예: 최근 1000 블록 상태만 유지).
• Archive (전체 이력):
  --state-pruning archive --blocks-pruning archive
  저장 공간·디스크 I/O 요구사항이 큼.

RPC

• --rpc-external: RPC를 외부에서 접근 가능하게 바인딩 (기본은 localhost).
• --rpc-cors: 허용 오리진. 전체 허용: --rpc-cors all (보안 고려해 프로덕션에서는 제한 권장).
• --rpc-methods: safe 권장. 위험한 메서드 제한.
• --rpc-max-connections: 예) --rpc-max-connections 200.

RPC 노드 운영 시: Important Flags for Running an RPC Node 참고.

포트

• P2P: 30333 (기본).
• WebSocket RPC: 9944 (기본).
• HTTP RPC: 9933.
• Prometheus: 9615. 외부에서 스크래핑 시 --prometheus-external 필요.

Telemetry

• --telemetry-url 'wss://telemetry.polkadot.io/submit/ 0'
  telemetry.polkadot.io에서 노드 확인 가능.

데이터 디렉터리

• 기본: ~/.local/share/polkadot/chains/polkadot/ (Linux).
  --base-path 로 변경 가능.

전체 옵션

polkadot --help

Validator·Parachain Collator 설정은 각각 전용 가이드 참고.