Polkadot (DOT) 노드 가이드
Polkadot Relay Chain Full Node 설치 및 운영 가이드입니다. Rust 기반 Substrate/Polkadot SDK를 사용하며, 동일 바이너리로 Kusama(--chain kusama) 등 다른 릴레이 체인도 실행할 수 있습니다.
공식 문서: Polkadot Developer Docs - Run a Node.
노드 종류
| 역할 | 설명 |
|---|---|
| Full Node (Pruned) | 기본: 최근 256블록 등 pruning. RPC·피어 제공. |
| Archive Node | --state-pruning archive --blocks-pruning archive로 전체 상태·블록 보관. 저장 공간 많이 필요. |
| Validator | 키 생성(polkadot-keygen) + 온체인 등록. 별도 Validator 가이드 참고. |
| Parachain Collator | 파라체인 블록 생성. Deploy to Polkadot 참고. |
하드웨어 요구사항 (권장)
- CPU: 4코어+
- RAM: 16GB+
- 스토리지: 1TB SSD (Archive는 더 필요)
- 네트워크: 안정적인 인터넷. P2P 포트 30333 오픈 권장.
첫 동기화는 1~2일(환경에 따라 수십 시간) 소요될 수 있습니다.
지원 환경
- OS: Linux (x86_64), macOS, Windows(WSL + Ubuntu).
- 설치 방식: 사전 빌드 바이너리 다운로드, 소스 빌드(
cargo build --release), Snap, Docker. - 바이너리: paritytech/polkadot-sdk Releases. 태그는
polkadot-vX.Y.Z형식 확인.
설치 방법
Localhost 설치 (권장)
바이너리 다운로드 또는 소스 빌드 → 실행 옵션(chain, pruning, RPC) 설정 → 동기화.
시작하기: localhost/README.md
Docker
참고: docker/README.md
폴더 구조
polkadot/
├── README.md # 이 파일
├── localhost/
│ ├── README.md
│ ├── installation.md # 바이너리·소스 빌드·Snap·실행 옵션
│ ├── configuration.md # pruning·RPC·Telemetry·포트
│ ├── troubleshooting.md
│ └── updates/
│ └── README.md
└── docker/
└── README.md
포트·엔드포인트
- P2P: 30333 (기본)
- RPC (WebSocket): 9944 (기본). HTTP 9933.
- Prometheus: 9615 (메트릭). 외부 노출 시
--prometheus-external. - 로컬 연결:
ws://127.0.0.1:9944— Polkadot.js Apps에서 개발 노드로 선택 가능.
주의사항
- Full Node 가이드는 Validator용이 아님. Validator는 Set Up a Validator 참고.
- RPC를 외부에 열 때:
--rpc-external,--rpc-cors,--rpc-methods safe등 보안 설정. Important Flags for RPC Node. - Telemetry: telemetry.polkadot.io에서 노드 확인. 옵션:
--telemetry-url 'wss://telemetry.polkadot.io/submit/ 0'.