Polkadot 노드 Localhost 설치 가이드

Polkadot Relay Chain Full Node를 호스트에 설치하고 실행하는 방법입니다.
동일 바이너리로 Kusama는 --chain kusama로 실행할 수 있습니다.

전제 조건

OS: Ubuntu/Linux (x86_64), macOS, Windows(WSL + Ubuntu).
하드웨어: 4코어+, 16GB RAM, 1TB SSD 권장. README 참고.
Rust: 소스 빌드 시 Rust 설치 및 Polkadot SDK 의존성 필요.

빠른 시작

1. 바이너리 다운로드 (Linux, 가장 쉬움)

polkadot-sdk Releases에서 polkadot Linux 바이너리 다운로드. 태그는 polkadot-vX.Y.Z 형식 확인.

# 버전은 Releases 페이지에서 확인 (예: polkadot-v1.20.0)
wget https://github.com/paritytech/polkadot-sdk/releases/download/polkadot-v1.20.0/polkadot
chmod +x polkadot
./polkadot --version

2. 실행 (Pruned Full Node)

./polkadot --chain polkadot --name "MyNode"

RPC를 로컬에서 쓰려면:

./polkadot --chain polkadot --name "MyNode" --rpc-cors all --rpc-methods safe --rpc-external

3. 동기화 확인

터미널 로그에서 Syncing, target=#... best: #... 확인.
Polkadot Telemetry에서 노드 이름 검색(동기화 중 회색, 완료 시 흰색).
Polkadot.js Apps에서 개발 노드로 ws://127.0.0.1:9944 연결.

동기화는 1~2일 걸릴 수 있습니다.

4. Archive / Validator / Kusama

Archive: --state-pruning archive --blocks-pruning archive 추가.
Kusama: --chain kusama 로 변경.
Validator: 이 가이드는 Full Node용. Validator는 공식 Validator 가이드 참고.

자세한 옵션·소스 빌드·Snap·Docker: installation.md, configuration.md.