Zcash 노드 문제 해결

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

Params 관련 오류

• 증상: proving/key params가 없다는 메시지.
• 조치: fetch-params.sh(릴리스 포함) 또는 ./zcutil/fetch-params.sh(소스 빌드) 실행. 약 4GB 다운로드. 문서에 안내된 params 경로가 올바른지 확인.

동기화가 매우 느리거나 멈춤

• 첫 동기화: 1~2일 걸릴 수 있음. 디스크 500GB+ 여유, 안정적인 네트워크 확인.
• addnode: addnode=mainnet.z.cash 등이 설정되어 있는지 확인.
• 방화벽: 8233 포트 인바운드 허용 시 피어 수 증가에 도움.

EOS (End-of-Support) halt

• 원인: 16주 이상 미업그레이드.
• 조치: GitHub Releases에서 최신 버전으로 업그레이드. 릴리스 주기. 사전 경고는 getdeprecationinfo RPC 또는 메트릭 화면에서 확인 가능.

RPC 연결 실패

• server=1: zcash.conf에 설정되어 있는지 확인.
• rpcallowip: 접속하는 클라이언트 IP가 허용되어 있는지 확인.
• rpcport: 기본 8232. 변경 시 클라이언트 포트 일치 여부 확인.

지갑·백업

• 지갑 사용 시: Wallet Backup. ~/.zcash/wallet.dat 권한·백업 관리.
• 노드만 운영 시: disablewallet=1 로 지갑 비활성화 권장.

추가 도움

• Troubleshooting Guide (ReadTheDocs)
• Known Issues / Security Warnings
• Forum - Full Node
• zcash/zcash GitHub