Nodes/zcash/localhost/installation

zcash

Zcash Full Node 설치 가이드

3분 읽기 · localhost/installation

list목차(9)

Zcash Full Node 설치 가이드

Zcash Full Node(zcashd)를 Linux(Debian/Ubuntu) 또는 macOS에 설치하고 실행하는 방법입니다.
출처: Run a Zcash Full Node, zcashd (ReadTheDocs).

목차

요구사항

  • 디스크: 500GB+ SSD
  • RAM: 8GB 이상
  • 네트워크: 포트 8233 오픈 권장. 첫 동기화 1~2일.
  • Params: proving/key params 약 4GB 다운로드 필수(fetch-params.sh).
  • GPG: 바이너리 사용 시 GPG 검증 권장.

Linux 의존성

Debian/Ubuntu:

sudo apt-get update
sudo apt install -y build-essential libtool autotools-dev automake pkg-config \
  libssl-dev libevent-dev bsdmainutils

소스 빌드 시 추가 의존성은 Debian/Ubuntu build 참고.

다운로드 및 검증

  1. GitHub Releases에서 OS·아키텍처에 맞는 릴리스 선택(예: v6.11.0, linux tar.gz).
  2. GPG 서명·해시로 무결성 검증. 릴리스 페이지와 z.cash/learn 안내 따르기.
  3. 압축 해제 후 zcashd, zcash-cli, fetch-params.sh 등이 포함된 디렉터리로 이동.

소스 빌드 (선택)

git clone https://github.com/zcash/zcash.git
cd zcash
git checkout v6.11.0   # 또는 최신 태그
./zcutil/build.sh -j$(nproc)

바이너리: ./src/zcashd, ./src/zcash-cli. Params는 아래 fetch-params 실행.

Proving/Key params

첫 실행 전 proving/key params를 받아야 합니다. 약 4GB입니다.

  • 릴리스 tarball에 fetch-params.sh가 있으면:
    ./fetch-params.sh
  • 소스 빌드 시:
    ./zcutil/fetch-params.sh

실행 후 노드가 사용하는 경로에 params가 내려받아집니다. 필요 시 문서·에러 메시지에 안내된 경로를 확인하세요.

설정 파일

mkdir -p ~/.zcash
touch ~/.zcash/zcash.conf

필요한 옵션을 zcash.conf.example를 참고해 추가합니다. 빈 파일이면 기본값으로 동작합니다.

실행

# 데몬(백그라운드)
./zcashd -daemon

# 또는 포그라운드
./zcashd

동기화가 끝난 뒤:

./zcash-cli getinfo

RPC 명령 목록: Zcash RPC.

업그레이드

  • 16주 내에 업그레이드하지 않으면 EOS(End-of-Support) halt로 노드가 종료됩니다. 릴리스 주기.
  • 소스 빌드 시:
    git fetch origin
git checkout v6.11.0   # 최신 태그
./zcutil/clean.sh
./zcutil/build.sh -j$(nproc)
  • params 재다운로드가 필요하면 ./zcutil/fetch-params.sh 또는 배포에 포함된 fetch-params.sh 실행.
  • 지갑 사용 시 백업 후 업그레이드.

자세한 설정: configuration.md. 문제 발생 시: troubleshooting.md.

zcash 다른 챕터