Zcash Full Node Docker 가이드

Docker로 Zcash Full Node(zcashd)를 실행하는 방법입니다.
공식 이미지: electriccoinco/zcashd.
참고: Run a Zcash Full Node.

빠른 시작

cp env-example.txt .env
# ZCASH_RPC_PASSWORD, DATA_DIR 등 필요 시 수정

docker compose up -d

공식 이미지에 proving/key params(약 4GB)가 포함되어 있지 않다면, 첫 실행 시 params 관련 오류가 날 수 있습니다. 그 경우 Params 절을 참고하세요.

docker compose logs -f
docker exec zcash-node zcash-cli -datadir=/data -rpcuser=zcash -rpcpassword=changeme getinfo

첫 동기화는 1~2일 걸릴 수 있습니다.

포트	용도
8233	P2P
8232	RPC

${DATA_DIR:-./zcash-data}가 컨테이너 내 /data에 마운트됩니다.
블록체인 데이터와 zcash.conf(선택)를 두면 됩니다.

공식 이미지가 zk-SNARK params를 포함하지 않는 경우:

호스트에서 릴리스의 fetch-params.sh를 받아 실행해 params를 다운로드(~4GB). 기본 경로는 ~/.zcash-params(Linux).
해당 디렉터리를 컨테이너의 적절한 경로(이미지 문서 참고)에 볼륨으로 마운트하거나, 데이터 볼륨 안에 params를 두고 이미지가 기대하는 경로와 맞춥니다.

이미지별 params 경로는 Electric Coin Co. 문서를 확인하세요.

zcash.conf.example를 복사해 zcash.conf로 편집한 뒤:

volumes:
  - ${DATA_DIR:-./zcash-data}:/data
  - ./zcash.conf:/data/zcash.conf:ro

그리고 command의 RPC 인자를 제거해 설정 파일에 맡깁니다.

기본 command에 -disablewallet=1이 들어가 있어, 노드 전용으로 동작합니다. 지갑을 쓰려면 해당 옵션을 제거하고, wallet.dat 백업을 권장합니다.