Edit this page on GitHub (opens in a new tab)
Zcash Stack είναι το κιτ ανάπτυξης ανοικτού κώδικα από την ομάδα πίσω από το zec.rocks. Περιλαμβάνει έναν πλήρη κόμβο Zcash, έναν διακομιστή light wallet και προαιρετικά πρόσθετα (Zaino, έναν block explorer, μια κρυφή υπηρεσία Tor, έναν DNS seeder, zecd, έναν διακομιστή μεσολάβησης gRPC-web για πορτοφόλια προγράμματος περιήγησης) ως Helm chart για το Kubernetes και ως αρχεία Compose Docker. Όλοι οι διακομιστές zec.rocks lightwalletd εκτελούνται από αυτό το chart. Το έργο χρηματοδοτείται από το Zcash Community Grants.
Αυτή η σελίδα συνοψίζει τι αναπτύσσει το κιτ, τι χρειάζεσαι πριν από την εγκατάστασή του και ποιες ρυθμίσεις έχουν τη μεγαλύτερη σημασία. Ακολουθεί την έκδοση chart 0.4.9 (κυκλοφόρησε στις 13 Νοεμβρίου 2026). Το README του chart και οι σημειώσεις του εργαστηρίου του έργου είναι οι πηγές αναφοράς· διάβασέ τα πριν εκτελέσεις οτιδήποτε σε περιβάλλον παραγωγής.
Κάθε στοιχείο ενεργοποιείται ή απενεργοποιείται μέσω ενός διακόπτη στο values.yaml του chart. Μόνο το lightwalletd είναι ενεργοποιημένο από προεπιλογή και χρειάζεται έναν κόμβο αλυσίδας, γι’ αυτό και τα παραδείγματα ενεργοποιούν επίσης το Zebra.
| Στοιχείο | Image στο chart 0.4.9 | Προεπιλογή | Λειτουργία |
|---|---|---|---|
| Zebra | zfnd/zebra:7.0.0 | απενεργοποιημένο (ενεργοποιημένο στα παραδείγματα) | Πλήρης κόμβος· επικυρώνει την αλυσίδα και παρέχει RPC σε όλα τα άλλα στοιχεία |
| Zakura | zakuracore/zakura:1.8.6 | απενεργοποιημένο | Fork του Zebra· εναλλακτικό backend για το lightwalletd ή το Zaino αντί για το Zebra |
| lightwalletd | electriccoinco/lightwalletd:v0.6.1 | ενεργοποιημένο | Διακομιστής light wallet (gRPC) για πορτοφόλια κινητών και υπολογιστών |
| Zaino | zingodevops/zaino:0.8.0-no-tls |
Δύο σημειώσεις για τις εκδόσεις. Το upstream του Zaino βρίσκεται στην έκδοση 0.10.1, ενώ το chart εξακολουθεί να περιλαμβάνει το image 0.8.0, οπότε έλεγξε το values.yaml προτού βασιστείς σε νεότερη συμπεριφορά του Zaino. Επίσης, οι κόμβοι Zakura σταματούν στο Mainnet σε ύψος λήξης υποστήριξης που ορίζεται ανά έκδοση: για την 1.8.6 αυτό είναι το μπλοκ 3.643.309, γύρω στις 5 Δεκεμβρίου 2026, ενώ οι εκδόσεις x86-64 από την 1.8.0 και μετά αρνούνται να ξεκινήσουν σε CPU χωρίς BMI2 και ADX. Η σελίδα καλύπτει και τα δύο.
Το chart αναπτύσσεται με βάση τρία πράγματα που ρυθμίζεις μία φορά για κάθε cluster.
Ingress και ορίζει από προεπιλογή την κλάση nginx· προτείνεται το ingress-nginx, επειδή χειρίζεται το gRPC με τον ίδιο τρόπο σε k3s και GKE. Στο k3s, είτε εγκατέστησε το k3s με --disable traefik είτε διατήρησε το Traefik και όρισε τα ingress.className: traefik και ingress.backendProtocol: GRPC (το chart τότε δημιουργεί ένα Traefik IngressRoute, επειδή ένα απλό Ingress μέσω Traefik επιστρέφει HTTP 500 για gRPC). Στο GKE, η ενσωματωμένη κλάση ingress gce δεν μπορεί να δρομολογήσει gRPC προς το lightwalletd ή το Zaino.examples/cluster-issuer.yaml· πρώτα δοκίμασε με τον issuer staging). Στο GKE Autopilot, εγκατέστησε το cert-manager με το --set global.leaderElection.namespace=cert-manager, διαφορετικά η δημιουργία issuer αποτυγχάνει με σφάλμα x509 «unknown authority». Μπορείς να παραλείψεις το cert-manager και να ορίσεις το <service>.ingress.tls.secretName στο δικό σου πιστοποιητικό.Στη συνέχεια, όρισε μια εγγραφή DNS για κάθε όνομα κεντρικού υπολογιστή, ώστε να δείχνει στην εξωτερική IP του ingress controller. Αν δεν έχεις ακόμη DNS, πρόσθεσε ένα όνομα sslip.io, όπως το 203-0-113-7.sslip.io, δίπλα στο πραγματικό σου όνομα: επιλύεται στη διεύθυνση IP που περιέχει, οπότε εκδίδεται αμέσως πιστοποιητικό. Για διακομιστές μόνιμης λειτουργίας, κράτησε το δικό σου όνομα κεντρικού υπολογιστή ως κύριο.
helm repo add zcash https://zecrocks.github.io/zcash-stack
helm repo update
# copy an example from the repo's examples/ folder, set your hostnames and RPC credentials, then:
helm install zcash zcash/zcash-stack -f examples/zebra-mainnet.yaml
Το παράδειγμα zebra-mainnet.yaml ενεργοποιεί το Zebra, συνδέει το lightwalletd σε αυτό, δίνει στο lightwalletd cache 40 GiB και TLS ingress και διατηρεί το RPC του κόμβου εντός του cluster. Άλλαξε το ενδεικτικό όνομα χρήστη και τον κωδικό πρόσβασης RPC πριν από την εγκατάσταση. Άλλα παραδείγματα καλύπτουν το testnet, το GKE, το GKE Autopilot με υψηλή διαθεσιμότητα, μια κρυφή υπηρεσία Tor και την αρχική ρύθμιση sslip.io.
Για αναβάθμιση, εκτέλεσε το helm repo update, κάνε προεπισκόπηση της αλλαγής με το πρόσθετο helm-diff (helm diff upgrade zcash zcash/zcash-stack -f values.yaml) και μετά εκτέλεσε το helm upgrade με τα ίδια ορίσματα. Αν αναβαθμίζεις από chart 0.0.x, διάβασε πρώτα το MIGRATION.md: η έκδοση 0.1.0 αντικατέστησε την παλιά ρύθμιση Traefik με τυπικό Ingress και cert-manager, ενώ άλλαξε και η διάταξη των values.
| Κανονική λειτουργία | Αρχικός συγχρονισμός | Δίσκος | |
|---|---|---|---|
| Zebra | περίπου 0,1 vCPU, 1,6 GiB | Μεγάλη χρήση CPU, IOPS και μνήμης | περίπου 260 GiB (Ιούνιος 2026) και αυξάνεται· προεπιλογή chart 500 GiB |
| lightwalletd | περίπου 0,15 vCPU, 165 MiB | Δημιουργεί την cache του μπλοκ προς μπλοκ | περίπου 17 GiB· προεπιλογή chart 40 GiB |
Όλη η στοίβα ζητά περίπου 1,5 vCPU και 4,5 GiB μνήμης. Για ένα μηχάνημα, το chart προτείνει 8 vCPU, 32 GiB RAM και περίπου 1 TB NVMe (στο GKE, ένα n2-standard-8 με τόμο Hyperdisk ή pd-ssd 500 GiB). Τα προεπιλεγμένα αιτήματα καλύπτουν ήδη τα ελάχιστα του GKE Autopilot, ενώ τα όρια CPU παραμένουν απενεργοποιημένα ώστε ο συγχρονισμός να μπορεί να χρησιμοποιεί πρόσθετη ισχύ.
Επαναφορά από snapshot. Όρισε το <chain>.initSnapshot.enabled: true (με initSnapshot.url, gs:// ή https://), ώστε να ξεκινήσεις από δημοσιευμένο snapshot αντί να συγχρονίσεις από τη γένεση. Η επαναφορά καταγράφει την πρόοδό της, επαναλαμβάνει σωστά μια διακοπείσα λήψη και δεν διαγράφει ποτέ έναν υγιή τόμο από προηγούμενη εγκατάσταση. Ένα snapshot αποτελεί συντόμευση εμπιστοσύνης: τα μπλοκ μετά από αυτό εξακολουθούν να επικυρώνονται, και ένα κακό snapshot γίνεται αντιληπτό όταν τα μπλοκ αποτυγχάνουν στην επικύρωση. Σύμφωνα με το εργαστήριο, ο συγχρονισμός από την αρχή διαρκεί περίπου 10 ημέρες, ενώ η εκκίνηση από snapshot περίπου 10 ώρες.
Κλιμάκωση και μηδενικός χρόνος διακοπής. Τα lightwalletd και Zaino είναι ελαφριές cache μπροστά από τον κόμβο, γι’ αυτό εκτέλεσε το replicas: 2 για σταδιακές ενημερώσεις χωρίς διακοπή (ένα PodDisruptionBudget προστίθεται αυτόματα όταν υπάρχουν περισσότερα από 1 αντίγραφα). Οι κόμβοι αλυσίδας δεν προορίζονται για φόρτο: κάθε αντίγραφο είναι ένας επιπλέον πλήρης κόμβος με δικό του τόμο και δικό του συγχρονισμό, οπότε εκτέλεσε έναν ή δύο για πλεονασμό.
Εισερχόμενοι ομότιμοι κόμβοι. Από προεπιλογή, το Zebra δημιουργεί μόνο εξερχόμενες συνδέσεις. Το zebra.p2pPublic.enabled: true δέχεται εισερχόμενους ομότιμους κόμβους στη θύρα 8233 (18233 στο testnet) και ανακοινώνει τη διεύθυνσή σου· επίλεξε το externalAddrFrom: hostIP σε γυμνό υλικό και k3s, το nodeExternalIP σε cloud όπου η IP του ίδιου του κόμβου είναι ιδιωτική ή το loadBalancer με δεσμευμένη στατική IP στο GKE Autopilot.
TLS και gRPC. Το TLS τερματίζεται στο ingress και στο cluster χρησιμοποιείται απλό HTTP/2, οπότε πολλά ονόματα κεντρικών υπολογιστών μπορούν να δείχνουν σε ένα lightwalletd. Διατήρησε το path: / μαζί με το pathType: Prefix, επειδή το gRPC χρειάζεται τις διαδρομές μεθόδων. Αν το πρώτο πιστοποιητικό αποτύχει λόγω της ανακατεύθυνσης HTTPS, έκδωσέ το με τον issuer staging ή όρισε προσωρινά το ingress.tls.sslRedirect: "false".
Κρυφή υπηρεσία Tor. Χρήσιμη όταν το cluster σου δεν έχει δημόσια IP ή domain:
tor:
enabled: true
targetService: zaino # or lightwalletd
hiddenServicePort: 443
Διάβασε τη διεύθυνση με το kubectl exec -it tor-0 -- cat /var/lib/tor/hidden_service/hostname και δοκίμασέ την μέσω ενός τοπικού client Tor με το zecping: ./zecping -socks localhost:9150 -addr <address>.onion:443.
Γύρω από αναβαθμίσεις δικτύου. Το Zebra μπορεί να αποκλείσει ομότιμους κόμβους που εξακολουθούν να χρησιμοποιούν παλιές εκδόσεις και να κολλήσει, καταγράφοντας ότι οι ενημερώσεις της αλυσίδας έχουν σταματήσει. Η λίστα αποκλεισμού του αποθηκεύεται στη μνήμη, οπότε το kubectl delete pod zebra-0 την εκκαθαρίζει· το pod επανέρχεται με τα ίδια δεδομένα αλυσίδας, χωρίς νέο συγχρονισμό.
Για ένα μηχάνημα, κλωνοποίησε το repo και ξεκίνησε το προεπιλεγμένο αρχείο από τον φάκελο docker/:
git clone https://github.com/zecrocks/zcash-stack.git
cd zcash-stack/docker
docker compose up --detach
docker compose logs --follow
Το compose.yaml εκτελεί τα Zebra, lightwalletd και Watchtower σε x86· το compose.arm.yaml κάνει το ίδιο σε κεντρικούς υπολογιστές ARM. Το Watchtower κατεβάζει αυτόματα νέα images και το προεπιλεγμένο αρχείο χρησιμοποιεί την ετικέτα zfnd/zebra:latest, ώστε ο κόμβος να ακολουθεί τις νέες εκδόσεις του Zebra χωρίς χειροκίνητες αναβαθμίσεις. Το compose.zaino.yaml αντικαθιστά το lightwalletd με το Zaino, αλλά καρφιτσώνει ένα παλιό community image (emersonian/zcash-zaino:0.1.2-zr4), γι’ αυτό έλεγξέ το πριν το χρησιμοποιήσεις. Άλλα αρχεία προσθέτουν ένα Caddy TLS front end, έναν διακομιστή μεσολάβησης VPS και μια σήραγγα autossh για κόμβους στο σπίτι.
Όρισε το LIGHTWALLETD_DONATION_ADDRESS στο αρχείο .env στη δική σου ενοποιημένη διεύθυνση, ώστε να δημοσιευτεί ως διεύθυνση δωρεών του διακομιστή. Αν εκτελέσεις το ./download-snapshot.sh από τον φάκελο docker/ πριν από την πρώτη docker compose up, γίνεται λήψη snapshot της αλυσίδας αντί για συγχρονισμό από την αρχή.
Το δεύτερο μάθημα του εργαστηρίου καλύπτει πώς να εκθέσεις τον διακομιστή: με δημόσια στατική IP, κρύβοντας την οικιακή IP σου πίσω από μια σήραγγα SSH προς VPS ή Tailscale Funnel ή με διακομιστή αποκλειστικά Tor. Δοκίμασε το αποτέλεσμα συνδέοντας ένα πορτοφόλι σε αυτόν (στις ZODL, Ρυθμίσεις για προχωρημένους· δες την ) ή καλώντας το GetLightdInfo με client gRPC.
Για παρακολούθηση, το τρίτο μάθημα παρουσιάζει τις χειροκίνητες εντολές Docker και προτείνει να καταχωρίσεις δημόσιο διακομιστή στο hosh, το zec.rocks uptime monitor. Η καταχώριση γίνεται με pull request που προσθέτει το όνομα κεντρικού υπολογιστή και τη θύρα σου στη λίστα διακομιστών του hosh. Για βοήθεια σε οποιοδήποτε βήμα, επισκέψου το φόρουμ των εργαστηρίων zec.rocks.
Εγκατάσταση του lightwalletd χωρίς κόμβο αλυσίδας. Το lightwalletd διαβάζει από το Zebra (ή το Zakura). Ενεργοποίησε έναν κόμβο ή ξεκίνησε από ένα αρχείο παραδείγματος που τον ενεργοποιεί.
Διατήρηση των ενδεικτικών διαπιστευτηρίων RPC του παραδείγματος. Τα παραδείγματα περιλαμβάνουν ενδεικτικές τιμές. Το RPC παραμένει εντός του cluster, αλλά άλλαξέ τες ούτως ή άλλως.
Εκτέλεση κόμβου αλυσίδας με το προεπιλεγμένο όριο δίσκου του GKE. Ο τόμος δεν δεσμεύεται ποτέ. Αύξησε το περιφερειακό όριο πριν από την εγκατάσταση.
Κλιμάκωση του Zebra για φόρτο. Κάθε επιπλέον αντίγραφο Zebra απαιτεί πλήρη νέο συγχρονισμό. Κλιμάκωσε το lightwalletd ή το Zaino αντί γι’ αυτό.
Καρφίτσωμα παλιού chart κατά τη διάρκεια αναβάθμισης δικτύου. Ένας κόμβος που προηγείται μιας αναβάθμισης σταματά να ακολουθεί το Mainnet μετά από αυτήν (το Zebra χρειάζεται την έκδοση 7.0.0 ή νεότερη από το NU7). Εκτέλεσε το helm repo update και αναβάθμισε το chart πριν από τα ύψη ενεργοποίησης και τα ύψη λήξης υποστήριξης του Zakura.
Τελευταία ενημέρωση: Νοέμβριος 2026 (chart 0.4.9)
| απενεργοποιημένο |
| Indexer του Rust που εξυπηρετεί επίσης light wallet |
| Block explorer | emersonian/zcash-explorer:v0.0.6 | απενεργοποιημένο | Web explorer που διαβάζει το JSON-RPC του κόμβου (το Zaino δεν μπορεί να το υποστηρίξει: παρέχει μόνο gRPC) |
| Tor | osminogin/tor-simple:0.4.9.16 | απενεργοποιημένο | Δημοσιεύει το lightwalletd ή το Zaino ως υπηρεσία .onion |
| DNS seeder | zfnd/dnsseeder:v1.8.0 | απενεργοποιημένο | Βοηθά τους νέους κόμβους να βρίσκουν ομότιμους κόμβους |
| zecd | ghcr.io/zecrocks/zecd:0.6.3 | απενεργοποιημένο | Διακομιστής πορτοφολιού με προτεραιότητα στα θωρακισμένα δεδομένα (δες ) |
| Διακομιστής μεσολάβησης gRPC-web | envoyproxy/envoy:v1.40.2 | απενεργοποιημένο | Επιτρέπει στα πορτοφόλια προγράμματος περιήγησης να επικοινωνούν με το lightwalletd, στο οποίο δεν μπορούν να έχουν πρόσβαση τα προγράμματα περιήγησης μέσω απλού gRPC |
| Πορτοφόλι WebZjs | ghcr.io/zecrocks/webzjs-wallet | απενεργοποιημένο | Πορτοφόλι προγράμματος περιήγησης· χρειάζεται τον διακομιστή μεσολάβησης gRPC-web στον ίδιο κεντρικό υπολογιστή |
local-pathPendingQUOTA_EXCEEDEDstorageClassName