Polkadot 노드 문제 해결
Full Node 동기화·실행·RPC 관련 자주 쓰는 확인 방법입니다.
동기화가 느리거나 멈춤
- 시간: 첫 동기화는 1~2일(수십 시간) 걸릴 수 있음. 저사양 VPS에서는 36시간 이상도 가능.
- 디스크: 1TB SSD 권장. 여유 공간·I/O 성능 부족 시 느려지거나 중단될 수 있음.
- 피어: 로그에서
(N peers)확인. P2P 포트 30333이 방화벽·라우터에서 열려 있는지 확인. - Telemetry: telemetry.polkadot.io에서 노드가 보이면 접속은 된 상태. 회색 = 동기화 중, 흰색 = 동기화 완료.
cannot execute binary file: Exec format error
- 사전 빌드 바이너리가 현재 아키텍처/OS와 맞지 않음.
해결: 같은 환경용 바이너리를 받거나, 소스 빌드(installation.md#linux--macos-소스-빌드) 또는 Docker 사용.
RPC에 연결 안 됨
- 바인딩: 기본은 localhost. 원격에서 접속하려면
--rpc-external필요. Docker는-p 9944:9944등 포트 매핑 확인. - CORS: 브라우저/앱에서 접속 시
--rpc-cors허용 범위 확인. 테스트용으로--rpc-cors all. - 엔드포인트: WebSocket
ws://IP:9944. Polkadot.js Apps에서 Development → 해당 주소 입력.
Prometheus 메트릭이 안 보임
- 기본은 localhost 바인딩. 호스트/외부에서 스크래핑하려면
--prometheus-external추가.
Docker 사용 시-p 9615:9615및 해당 플래그 확인.
Validator 관련
- Full Node 설정으로는 Validator가 되지 않음.
키 생성·세션 키·온체인 등록은 Set Up a Validator 및polkadot-keygen문서 참고.
로그·버전
- 실행 시 버전·체인·Node name·Role (FULL)·DB 경로·피어 수·동기화 진행이 로그에 출력됨.
polkadot --version으로 바이너리 버전 확인. 네트워크 업그레이드 시 요구 버전으로 업데이트 필요할 수 있음.