Nodes/sui/localhost/troubleshooting

sui

Sui Full Node 문제 해결

2분 읽기 · localhost/troubleshooting

list목차(6)

Sui Full Node 문제 해결

sui-node 실행·동기화·빌드 시 자주 겪는 문제와 확인 방법입니다.

빌드 오류: cannot find -lpq

  • 원인: PostgreSQL 클라이언트 라이브러리 미설치.
  • Linux: sudo apt-get install libpq-dev
  • macOS: brew install libpq 후 brew link --force libpq
    참고: Stack Overflow

Address already in use (9184)

  • 증상: panicked at error binding to 0.0.0.0:9184: Address already in use (os error 98) 등.
  • 조치: fullnode.yaml에서 메트릭 포트 변경.
    metrics-address: "0.0.0.0:9180"

동기화가 너무 느리거나 디스크 부족

  • Genesis부터 동기화하지 마세요. Sui Snapshots에서 스냅샷을 받아 그 기준으로 시작하세요.
  • 디스크: 공식 권장 4TB NVMe. 인덱싱·gRPC 사용 시 저장 공간이 더 필요할 수 있습니다.
  • Archival Fallback: seed-peers만으로는 최근 몇 에폭만 유지됩니다. 오래된 체크포인트가 필요하면 Archives 설정을 검토하세요.

네트워크·피어

  • seed-peers: Mainnet/Testnet용 seed 목록을 fullnode.yaml의 p2p-config.seed-peers에 반드시 넣었는지 확인하세요. 공식 Full Node 가이드에 예시가 있습니다.
  • 방화벽: P2P 포트(기본 8084) 인바운드/아웃바운드 허용 여부를 확인하세요.

업데이트

  • 노드는 네트워크와 맞는 버전으로 유지해야 합니다. Updates 가이드를 참고해 업데이트 절차를 따르세요.

추가 도움

sui 다른 챕터