Eseguire un nodo Bitcoin Core nudo : guida operatore

L'articolo Conservare « Un nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → Bitcoin a casa » ha coperto l'opzione facile : installare Umbrel×UmbrelDistribuzione equivalente per mini-PC o Raspberry Pi, con interfaccia web curata e app store (BTCPay, mempool.space, Sparrow Server, ecc.).Vedi nel lessico →, Start9×Start9 (StartOS)Alternativa a Umbrel con focus su sovranità e privacy. Più impegnativa tecnicamente, più rigorosa sulla privacy.Vedi nel lessico →, RaspiBlitz×RaspiBlitzDistribuzione software chiavi in mano per trasformare un Raspberry Pi in un nodo Bitcoin e Lightning. Pioniere del genere, con community in lingua tedesca molto attiva.Vedi nel lessico → o MyNode×MyNodeAltra distribuzione di nodo full-stack, con modello commerciale e versione Premium a pagamento.Vedi nel lessico → su un Raspberry Pi×Raspberry PiPiccolo computer delle dimensioni di una carta di credito, a basso costo (60 a 100 EUR). Permette di gestire un nodo Bitcoin a casa.Vedi nel lessico → 5 o un mini-PC×Mini-PC (NUC)Piccolo computer fanless come Intel NUC, Beelink o Minisforum. Più potente di un Raspberry Pi, ideale per un nodo serio con Lightning e BTCPay.Vedi nel lessico →, seguire l'assistente, godere di un'interfaccia web pulita. Questa via va bene per la maggior parte. Ma nasconde la meccanica sotto uno strato di astrazione, e il giorno in cui qualcosa devia, ci si ritrova sprovveduti.

Eseguire Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → nudo, cioè il demone bitcoind direttamente su un Linux minimale, è la via dell'operatore che vuole capire. È più ruvida all'inizio, ma insegna tutto : la configurazione bitcoin.conf, l'RPC×RPC (Remote Procedure Call)Protocollo standardizzato per chiamare funzioni su un programma remoto. Bitcoin Core espone più di 200 comandi RPC.Vedi nel lessico → che pilota il demone, i log debug.log, gli index opzionali, i benefici e costi del pruning, il backup di wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico →.dat e chainstate, l'aggiornamento Bitcoin Core, il collegamento a un wallet esterno Sparrow o Specter.

Questo articolo segue questa via. Copre l'installazione su un Linux Debian/Ubuntu, la scelta archival vs pruned, la configurazione degli index, l'RPC, l'accesso Tor, gli aggiornamenti versione per versione, il debug via bitcoin-cli, e il backup. Lettura per chi vuole tenere un nodo Bitcoin su un server affittato o un mini-PC, senza dipendere da una distribuzione comunitaria.

Hardware e sistema : cosa basta nel 2026

Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → è sorprendentemente frugale lato CPU. Un Intel N100, un AMD Ryzen 5500U, un Raspberry Pi×Raspberry PiPiccolo computer delle dimensioni di una carta di credito, a basso costo (60 a 100 EUR). Permette di gestire un nodo Bitcoin a casa.Vedi nel lessico → 5 o un mini-PC×Mini-PC (NUC)Piccolo computer fanless come Intel NUC, Beelink o Minisforum. Più potente di un Raspberry Pi, ideale per un nodo serio con Lightning e BTCPay.Vedi nel lessico → da 250 EUR bastano largamente, anche per validare a piena velocità durante la sincronizzazione iniziale. Il fattore limitante è altrove : la memoria viva (8 GB minimo, 16 GB confortevole) e soprattutto lo storage.

Lato storage, due opzioni. Full archival : la catena completa dal 2009, ~620 GB a maggio 2026, cresce di ~80 GB all'anno. Pruned : Bitcoin Core conserva solo gli ultimi N blocchi (tipicamente 5 a 50 GB a seconda di prune=N in MB), elimina man mano i vecchi. Pruned permette di girare su un SSD da 256 GB. Archival richiede 1 TB minimo per avere margine su 3-4 anni.

L'OS raccomandato è Debian stable o Ubuntu LTS, installati al minimo (nessun desktop grafico). Bitcoin Core gira anche su FreeBSD e NixOS per chi vuole. macOS e Windows sono supportati ma sconsigliati per un nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → 24/7 : lo stack Linux è più prevedibile. Evitare Arch o distribuzioni rolling-release per un nodo : la stabilità batte la freschezza dei pacchetti.

Installazione di Bitcoin Core da binari ufficiali

L'installazione pulita passa dai binari ufficiali pubblicati su bitcoincore.org, mai da un repository apt non ufficiale. I binari sono accompagnati da firme GPG dei contributori Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → che hanno riprodotto deterministicamente la compilazione (Guix builds). Verificare queste firme prima dell'esecuzione è la prima buona abitudine operativa.

Procedura tipo : scaricare l'archivio bitcoin-X.Y.Z-x86_64-linux-gnu.tar.gz, l'archivio SHA256SUMS, e il file SHA256SUMS.asc. Importare le chiavi GPG dei release signer dal repository bitcoin/bitcoin su GitHub×GitHubPiattaforma web dove sono ospitati gran parte dei progetti open source del mondo, fra cui Bitcoin Core, electrs, BDK, LDK. Permette di vedere il codice, lo storico delle modifiche e di proporre contributi.Vedi nel lessico →. Verificare che SHA256SUMS.asc validi bene SHA256SUMS (gpg --verify×Don't trust, verifyMantra Bitcoiner. Non fidarti di nessuno (banca, governo, exchange, influencer), verifica di persona tramite il tuo nodo.Vedi nel lessico →), poi che l'archivio scaricato corrisponda all'hash×Hash (impronta)Funzione che trasforma un dato di dimensione qualunque in un'impronta di dimensione fissa. Lo stesso input dà sempre lo stesso output, ma dall'output non si risale all'input.Vedi nel lessico → elencato (sha256sum -c). Se uno di questi passaggi fallisce, non eseguire il binario. Tar -xzf, poi copiare bitcoind e bitcoin-cli in /usr/local/bin.

Creare un utente dedicato (adduser --system bitcoin), creare la cartella dati (mkdir /home/bitcoin/.bitcoin, chown bitcoin:bitcoin), scrivere un file unit systemd che lanci bitcoind come questo utente (User=bitcoin, ExecStart=/usr/local/bin/bitcoind -datadir=/home/bitcoin/.bitcoin -conf=/home/bitcoin/.bitcoin/bitcoin.conf -daemon). Il servizio gira poi via systemctl start bitcoind, parte al boot, logga in journalctl.

Configurazione base : bitcoin.conf

Il file bitcoin.conf nel datadir contiene tutte le opzioni di bitcoind. Una configurazione tipica nel 2026 assomiglia a : dbcache=4000 (cache memoria in MB, accelera la sincronizzazione iniziale), maxconnections=40 (numero massimo di peer), maxuploadtarget=5000 (cap upload in MB al giorno, utile su connessione limitata), txindex=1 se si vuole interrogare qualsiasi transazione storica, prune=0 per archival o prune=10000 per conservare solo gli ultimi 10 GB.

Per l'RPC×RPC (Remote Procedure Call)Protocollo standardizzato per chiamare funzioni su un programma remoto. Bitcoin Core espone più di 200 comandi RPC.Vedi nel lessico → : server=1 attiva l'interfaccia RPC, rpcauth=... o rpcuser=... / rpcpassword=... definisce l'autenticazione (preferire rpcauth per memorizzare l'hash×Hash (impronta)Funzione che trasforma un dato di dimensione qualunque in un'impronta di dimensione fissa. Lo stesso input dà sempre lo stesso output, ma dall'output non si risale all'input.Vedi nel lessico → invece della password in chiaro), rpcbind=127.0.0.1 / rpcallowip=127.0.0.1 limita l'ascolto al loopback locale (obbligo di sicurezza se il nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → è su un server esposto). Per esporre l'RPC a un wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → esterno sulla rete locale, aprire con cautela tramite rpcallowip verso un IP preciso.

Per Tor : proxy=127.0.0.1:9050 instrada le connessioni in uscita tramite il demone Tor locale, listenonion=1 pubblica un servizio onion v3 per le connessioni in entrata. onlynet=onion impone solo Tor (interrompe se Tor è down, quindi non per un principiante). Tor deve essere installato separatamente : apt install tor, verificare che il socket SOCKS5 del demone ascolti su 9050.

Pruning e index : adattare ai bisogni

Il pruning permette di mantenere Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → utile con poco storage. Con prune=10000, il nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → valida sempre integralmente la catena durante la sincronizzazione iniziale (quindi l'Initial Block Download resta lungo, ~620 GB da scaricare e validare), ma conserva poi solo gli ultimi 10 GB di blocchi. Può servire richieste sugli UTXO×UTXO (Unspent Transaction Output)« Pezzo » di bitcoin ricevuto e non ancora speso. Un wallet non ha un unico saldo, ha una collezione di UTXO la cui somma costituisce il saldo.Vedi nel lessico → recenti e inviare o ricevere transazioni, ma non può rispondere a una richiesta su un blocco storico antico.

Gli index opzionali arricchiscono le capacità. txindex=1 indicizza tutte le transazioni per TXID, il che permette a un wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico → esterno o explorer di recuperare qualsiasi transazione storica (incompatibile con pruned). coinstatsindex=1 permette di interrogare getutxos rapidamente senza rescan. blockfilterindex=1 attiva i compact block filter BIP×BIP (Bitcoin Improvement Proposal)Documento standard che descrive un miglioramento proposto al protocollo Bitcoin. Numerati (BIP 32, BIP 39, BIP 174, ecc.). Processo aperto e pubblico su GitHub.Vedi nel lessico → 157/158 (utili per wallet SPV light che si collegano al vostro nodo).

Scelte tipiche nel 2026. Caso 1 : nodo archival con txindex per servire Sparrow/Specter, 1 TB SSD, ~620 GB usati. Caso 2 : nodo pruned a 50 GB con blockfilterindex per servire un wallet mobile (Sparrow Server, Electrum personal server), 256 GB SSD largamente sufficiente. Caso 3 : nodo archival senza index per pura validazione e peer-to-peer (far girare la rete), 1 TB SSD, nessun wallet esterno. Scegliere secondo cosa se ne fa, non secondo la coolness delle opzioni.

RPC e connessione di un wallet esterno

L'RPC×RPC (Remote Procedure Call)Protocollo standardizzato per chiamare funzioni su un programma remoto. Bitcoin Core espone più di 200 comandi RPC.Vedi nel lessico → di Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → è l'API×API (Application Programming Interface)Interfaccia che permette a un programma di interrogare un altro programma o servizio. mempool.space espone un'API pubblica per interrogare la chain.Vedi nel lessico → che permette di pilotare il demone dall'esterno. bitcoin-cli è solo un client a riga di comando che parla JSON-RPC a bitcoind. Una volta configurato l'RPC, qualsiasi strumento (Sparrow Wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico →, Specter Desktop, Lightning lnd, BTCPay Server) può collegarsi al nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → per ottenere lo stato della catena, leggere transazioni, diffondere transazioni, sorvegliare indirizzi o uno xpub×xpub (extended public key)Chiave pubblica estesa. Consente a un wallet in sola lettura di conoscere indirizzi e saldi senza poter firmare. Utilizzata per tracking e osservazione.Vedi nel lessico →.

Per collegare Sparrow Wallet : Settings, Server, Bitcoin Core, inserire host (l'IP del nodo), porta (8332 di default), user/password (quelli del bitcoin.conf), testare la connessione. Sparrow inizia allora a interrogare il nodo per seguire gli xpub configurati, senza dipendere da un server terzo. Per Specter Desktop : stesso principio via Connect Node.

Se Bitcoin Core e Sparrow girano sulla stessa macchina, rpcallowip=127.0.0.1 basta. Se Sparrow gira su un laptop separato sulla LAN, aprire rpcallowip=192.168.1.0/24 (il vostro subnet locale) e rpcbind=0.0.0.0 (ascolto su tutte le interfacce) o più precisamente rpcbind=192.168.1.X. Se il nodo è su un VPS×VPS (Virtual Private Server)Server virtuale affittato presso un hoster (Hetzner, DigitalOcean, OVH), accessibile via SSH. Costo tipico fra 5 e 30 EUR al mese.Vedi nel lessico → remoto, esporre l'RPC è molto rischioso : preferire un tunnel SSH×SSH (Secure Shell)Protocollo per connettersi da remoto alla linea di comando di un server in modo cifrato.Vedi nel lessico → (ssh -L 8332:127.0.0.1:8332 vps) piuttosto che aprire la porta 8332 su Internet.

Debug, aggiornamento, backup

Debug. Bitcoin Core×Bitcoin CoreImplementazione di riferimento del software Bitcoin, scritta in C++ e mantenuta da una comunità open source. È il software utilizzato dalla maggior parte dei nodi.Vedi nel lessico → scrive debug.log nel datadir. È la prima cosa da consultare quando qualcosa devia : tail -f ~/.bitcoin/debug.log dà un flusso in tempo reale. Per richieste puntuali, bitcoin-cli getblockchaininfo, getnetworkinfo, getmempoolinfo, getpeerinfo danno lo stato globale. bitcoin-cli help elenca i ~200 comandi RPC×RPC (Remote Procedure Call)Protocollo standardizzato per chiamare funzioni su un programma remoto. Bitcoin Core espone più di 200 comandi RPC.Vedi nel lessico → disponibili. La regola : prima di googlare un errore, leggere 50 righe del debug.log e provare 3 comandi bitcoin-cli.

Aggiornamento. Bitcoin Core pubblica circa una release maggiore all'anno (24 nel 2022, 25 nel 2023, ecc.) e release minori più frequenti. Procedura : systemctl stop bitcoind, scaricare il nuovo archivio, verificare le firme GPG, sostituire i binari in /usr/local/bin, systemctl start bitcoind. Leggere le release notes in anticipo, in particolare eventuali migrazioni di formato chainstate o wallet×Wallet (portafoglio)Software o dispositivo che gestisce le tue chiavi Bitcoin e permette di firmare le transazioni. Un wallet non « contiene » davvero i tuoi bitcoin, contiene le chiavi che dimostrano che ne sei proprietario.Vedi nel lessico →.dat. Un aggiornamento di versione minore passa in qualche minuto ; una maggiore può richiedere una re-validazione parziale (5-30 minuti a seconda dell'hardware).

Backup. wallet.dat (se usate il wallet integrato di Bitcoin Core) deve essere salvato fuori dal server alla creazione, e dopo ogni importazione di chiavi. La catena e il chainstate (l'UTXO×UTXO (Unspent Transaction Output)« Pezzo » di bitcoin ricevuto e non ancora speso. Un wallet non ha un unico saldo, ha una collezione di UTXO la cui somma costituisce il saldo.Vedi nel lessico → set, ~10 GB) non richiedono backup : si ricostruiscono dalla rete se persi. Per migrare un nodo×Nodo (node)Computer che esegue il software Bitcoin e partecipa alla rete validando blocchi e transazioni. Un « full node » conserva una copia completa della blockchain.Vedi nel lessico → verso un nuovo server, copiare l'intero datadir via rsync, lanciare bitcoind sulla nuova macchina, attendere qualche minuto di re-validazione, è tutto. Il wallet stesso va trattato con la stessa cura di una seed phrase×Seed phrase (frase di recupero)Sequenza di 12 o 24 parole (di solito in inglese) che codifica la tua chiave maestra. Backup universale di un wallet : con queste parole puoi ripristinare i tuoi fondi su qualsiasi software compatibile.Vedi nel lessico → : backup cifrato fuori dal server, idealmente con passphrase×PassphraseParola o frase aggiuntiva che aggiungi alla tua seed phrase per creare un wallet nascosto. Strato di sicurezza opzionale, indipendente dal seed.Vedi nel lessico → BIP39×BIP39Standard che definisce l'elenco di 2 048 parole utilizzate per le seed phrase. Consente a tutte le marche di wallet di generare seed reciprocamente compatibili.Vedi nel lessico → in un hardware wallet×Hardware walletPiccolo dispositivo dedicato (Ledger, Trezor, Coldcard, BitBox, ecc.) che conserva la chiave privata lontano da un computer potenzialmente compromesso. Firma le transazioni all'interno del dispositivo.Vedi nel lessico → piuttosto che via wallet.dat.