Knowledge base
Gli errori in cui le persone si imbattono effettivamente con la CLI di Zinnector® e la relativa soluzione: spawn EINVAL su Windows, l'avviso EBADENGINE di npm, node-gyp che richiede Visual Studio su Node 26, EPERM durante l'installazione, un runtime che non si avvia e una porta già in uso.
Gli errori in cui ci si imbatte effettivamente con la CLI di Zinnector®, il significato di ciascuno e la relativa soluzione. Ogni voce riporta il testo esatto visualizzato, consentendo di cercarlo all'interno di questa pagina. Se il Suo errore non è presente qui, esegua il comando interessato con ZINNECTOR_DEBUG=1 e apra una segnalazione su github.com/Zinn-Digital/zinnector/issues includendo l'output, la Sua versione di node --version e il Suo sistema operativo.
Un bug presente in Zinnector® 0.1.0 e 0.1.1. Su Windows il programma di installazione del runtime eseguiva npm.cmd per nome, e Node rifiuta di avviare un file .cmd senza una shell a partire dalla correzione per la vulnerabilità CVE-2024-27980 — l'installazione andava quindi in crash un secondo dopo aver risposto Y. Risolto nella versione 0.1.2: npm viene ora eseguito come node npm-cli.js, una modalità identica su ogni piattaforma che non richiede alcuna shell. Esegua npm install -g zinnector@latest, quindi nuovamente zinnector dev.
La Sua versione di Node è precedente alla 24. npm mostra l'avviso perché il pacchetto dichiara engines: >=24.18.1; l'installazione viene comunque completata, ma zinnector rifiuta poi di avviarsi (codice di uscita 78) invece di fallire in seguito con errori poco chiari. Installi la versione LTS attuale da nodejs.org — winget install OpenJS.NodeJS.LTS su Windows, brew install node@24 su macOS — verifichi che node --version restituisca v24 o superiore, e installi nuovamente Zinnector®.
Il runtime di WordPress include un modulo nativo i cui binari precompilati esistono solo per Node 24 e 25. Su una versione di Node più recente (26 e successive, a partire da settembre 2026), il relativo installer ricorre alla compilazione dal codice sorgente, operazione che su un comune sistema Windows si conclude con la richiesta di installare Visual Studio. Risolto nella versione 0.1.2: Zinnector® rileva questa condizione prima di scaricare qualsiasi file e recupera una versione di Node 24 dedicata esclusivamente al runtime — circa 30 MB, verificati rispetto ai checksum di nodejs.org — evitando così qualsiasi compilazione. Se l'errore dovesse persistere dopo l'aggiornamento, esegua zinnector dev --reset-runtime per eliminare preventivamente l'installazione incompleta precedente.
Si tratta quasi sempre di un antivirus o di un indicizzatore di ricerca che mantiene aperto un file all'interno della directory node_modules del runtime mentre npm tenta di rimuoverlo. L'installazione viene ritentata a partire da una directory pulita alla successiva esecuzione di zinnector dev; se il problema persiste, zinnector dev --reset-runtime rimuove preliminarmente l'intera directory del runtime e procede a una nuova installazione.
Il messaggio include le ultime righe generate da npm e l'esatto comando eseguito da Zinnector®, permettendo di eseguirlo autonomamente e visualizzare l'output completo. Le cause più comuni sono un problema di rete o di proxy — il runtime viene scaricato tramite la Sua istanza di npm, pertanto si applicano le configurazioni di npm config set proxy … e gli eventuali mirror del registry — oppure un'installazione precedente non portata a termine, rimovibile con --reset-runtime.
Esegua zinnector dev --verbose per visualizzare l'output del runtime. Una porta già in uso rappresenta il caso più frequente: utilizzi zinnector dev --port 9401 oppure imposti port all'interno di zinnector.json. In caso di runtime installato che non riesce ad avviarsi: zinnector dev --reset-runtime. Il primo avvio scarica inoltre WordPress stesso, pertanto su connessioni lente è opportuno attendere alcuni minuti; la CLI attende fino a cinque minuti prima di segnalare un timeout invece di bloccarsi indefinitamente.
I deploy vengono gestiti a partire da un repository; pertanto, zinnector push richiede la presenza di un repository con un remote raggiungibile dalla piattaforma. Esegua git init && git add -A && git commit -m initial, aggiunga il Suo remote GitHub o GitLab, quindi esegua zinnector link per collegarlo al sito.
Esegua zinnector check. In nove casi su dieci si tratta di una discrepanza tra le versioni di PHP — lo sviluppo è avvenuto su una versione di PHP più recente rispetto a quella eseguita nello slot — e il report indica a quale versione passare lo slot con zinnector php <version>, oppure su quale versione sviluppare con zinnector dev --php <version>. Il comando zinnector logs --error mostra l'errore irreversibile specifico.
Cosa abbiamo scritto su hosting, SEO e gestione di siti su larga scala.
Come l'hosting modella l'indicizzazione e l'equità dei link nel 2026: mantenere le pagine indicizzate, verificare i domini datati prima di svilupparli, link building senza tracce per i motori di ricerca e una visione onesta di ciò che l'infrastruttura può e non può fare per la SEO.
Leggi l'articolo →Una lista di controllo pratica per un WordPress veloce e sicuro: memorizzazione nella cache a livello di server, una cache degli oggetti per sito, la manciata di plugin che vale la pena eseguire, il mantenimento dello stack aggiornato e le pagine WooCommerce da non memorizzare mai nella cache.
Leggi l'articolo →Cosa distingue davvero un buon hosting gestito da una macchina economica con pannello di controllo — migrazioni, backup, isolamento, caching reale e scalabilità trasparente — e come valutarlo prima di impegnarsi.
Leggi l'articolo →Il supporto è incluso in ogni piano, il servizio è attivo 24 ore al giorno e potete scriverci in una qualsiasi delle nostre 58 lingue: vi risponderemo nella vostra.
Contatta l'assistenza → Tutti gli articoli →