Avalanche 노드 문제 해결
AvalancheGo 실행·Bootstrap·RPC 시 자주 겪는 문제와 확인 방법입니다.
Bootstrap이 너무 느리거나 멈춘 것 같을 때
- Mainnet: 수일 걸릴 수 있음. Fuji는 약 1일.
- 동기화 순서: P-Chain → X-Chain → C-Chain. 로그에서 각 체인
consensus starting메시지 확인. - 진행 확인: configuration.md의
info.isBootstrapped로 P/X/C 각각 확인. - 디스크: 1TB SSD 여유 확인. 네트워크·디스크 I/O 상태 점검.
API call rejected because chain is not done bootstrapping
- 원인: 해당 체인이 아직 bootstrap 중.
- 조치:
info.isBootstrapped로 완료 여부 확인. 완료될 때까지 대기 후 다시 호출.
원격에서 RPC 접속 불가
- --http-host:
0.0.0.0으로 기동했는지 확인. 기본은 localhost만 수신. - 방화벽: 9650(HTTP API) 인바운드 허용. 9651(Staking)도 필요 시 허용.
- 보안: RPC를 공개할 경우 방화벽으로 신뢰 IP만 허용하는 등 보안 설정 권장.
NodeID를 찾고 싶을 때
- 직접 실행:
./build/avalanchego --version또는 기동 로그. - systemd:
sudo journalctl -u avalanchego | grep "NodeID". 값 앞에NodeID-접두사 붙여 사용.
업그레이드·버전
- 네트워크와 호환되는 버전 유지 필요. Releases, Managing AvalancheGo 참고.