Kennisbank
De fouten waar gebruikers daadwerkelijk tegenaan lopen met de Zinnector® CLI en de oplossing voor elk probleem: spawn EINVAL op Windows, de EBADENGINE-waarschuwing van npm, node-gyp dat vraagt om Visual Studio op Node 26, EPERM tijdens de installatie, een runtime die niet start, en een poort die al in gebruik is.
De fouten waar gebruikers in de praktijk tegenaan lopen bij de Zinnector®-CLI, wat ze allemaal betekenen en de bijbehorende oplossing. Elk item vermeldt de exacte tekst die u te zien krijgt, zodat u deze pagina daarop kunt doorzoeken. Staat die van u er niet tussen, voer dan de mislukte opdracht uit met ZINNECTOR_DEBUG=1 en open een issue op github.com/Zinn-Digital/zinnector/issues met de uitvoer, uw node --version en uw besturingssysteem.
Een fout in Zinnector® 0.1.0 en 0.1.1. Op Windows voerde het installatieprogramma van de runtime npm.cmd bij naam uit, en Node weigert sinds de oplossing voor CVE-2024-27980 een .cmd-bestand te spawnen zonder shell — waardoor de installatie één seconde nadat u Y had geantwoord crashte. Opgelost in 0.1.2: npm wordt nu uitgevoerd als node npm-cli.js, wat op elk platform hetzelfde is en geen shell vereist. Voer npm install -g zinnector@latest uit en vervolgens opnieuw zinnector dev.
Uw Node-versie is ouder dan 24. npm toont de waarschuwing omdat het pakket engines: >=24.18.1 declareert; de installatie wordt evengoed voltooid, maar zinnector weigert vervolgens te starten (afsluitcode 78) in plaats van later op een verwarrende manier te mislukken. Installeer de huidige LTS via nodejs.org — winget install OpenJS.NodeJS.LTS op Windows, brew install node@24 op macOS — controleer of node --version v24 of hoger weergeeft en installeer Zinnector® opnieuw.
De WordPress-runtime bevat een native module waarvan voorgecompileerde binaire bestanden alleen bestaan voor Node 24 en 25. Op een nieuwere Node-versie (26 en hoger, vanaf september 2026) valt het installatieprogramma terug op compileren vanaf broncode, wat op een standaard Windows-machine uitmondt in een vraag om Visual Studio. Opgelost in 0.1.2: Zinnector® detecteert dit voordat er iets wordt gedownload en haalt uitsluitend voor de runtime een Node 24 op — ongeveer 30 MB, geverifieerd aan de hand van de checksums van nodejs.org — waardoor er nooit iets wordt gecompileerd. Als u dit na het upgraden nog steeds ziet, voert u zinnector dev --reset-runtime uit zodat de halfvoltooide installatie van eerdere pogingen eerst wordt verwijderd.
Vrijwel altijd een virusscanner of een zoekindexeerder die een bestand geopend houdt onder de node_modules van de runtime terwijl npm dit probeert te verwijderen. Bij de volgende zinnector dev wordt de installatie opnieuw geprobeerd vanuit een schone map; blijft dit gebeuren, dan verwijdert zinnector dev --reset-runtime eerst de volledige runtime-map en wordt er opnieuw geïnstalleerd.
Het bericht bevat de eigen laatste regels van npm en de exacte opdracht die Zinnector® heeft uitgevoerd, zodat u deze zelf kunt uitvoeren en de volledige uitvoer kunt zien. De gebruikelijke oorzaken zijn een netwerk- of proxyprobleem — de runtime wordt opgehaald met uw eigen npm, dus npm config set proxy … en een registry-mirror zijn van toepassing — of een halfvoltooide eerdere installatie, die met --reset-runtime wordt gewist.
Voer zinnector dev --verbose uit om de eigen uitvoer van de runtime te bekijken. Een poort die al in gebruik is, is de meest voorkomende oorzaak: zinnector dev --port 9401, of stel port in binnen zinnector.json. Een runtime die wel geïnstalleerd is maar niet wil opstarten: zinnector dev --reset-runtime. De eerste keer opstarten downloadt ook WordPress zelf, dus geef het op een trage verbinding een paar minuten; de CLI wacht maximaal vijf minuten alvorens een time-out te melden in plaats van vast te lopen.
Implementaties worden aangestuurd vanuit een repository, dus zinnector push heeft er een nodig met een remote die het platform kan bereiken. git init && git add -A && git commit -m initial, voeg uw GitHub- of GitLab-remote toe en voer vervolgens zinnector link uit om deze aan de site te koppelen.
Voer zinnector check uit. In negen van de tien gevallen gaat het om een verschil in PHP-versie — u heeft gebouwd op een nieuwere PHP-versie dan het slot gebruikt — en het rapport geeft aan naar welke versie u het slot moet overzetten met zinnector php <version>, of met welke u moet ontwikkelen via zinnector dev --php <version>. zinnector logs --error toont de fatale fout zelf.
Wat we hebben geschreven over hosting, SEO en het op grote schaal beheren van websites.
Hoe hosting de indexering en link equity vormgeeft in 2026: pagina's geïndexeerd houden, oude domeinen screenen voordat u erop bouwt, linkbuilding zonder zoekmachine-footprint en een eerlijke kijk op wat infrastructuur wel en niet kan betekenen voor SEO.
Bericht lezen →Een praktische controlelijst voor een snel, veilig WordPress: caching op serverniveau, een objectcache per site, het handjevol plug-ins dat het waard is om te gebruiken, het up-to-date houden van de stack en de WooCommerce-pagina's die u nooit mag cachen.
Bericht lezen →Wat goede beheerde hosting nu echt onderscheidt van een goedkope server met een controlepaneel — migraties, back-ups, isolatie, echte caching en eerlijke schaalbaarheid — en hoe u dit kunt beoordelen voordat u zich vastlegt.
Bericht lezen →Ondersteuning is inbegrepen in elk abonnement, de helpdesk is 24 uur per dag geopend en u kunt ons in elk van onze 58 talen schrijven — wij antwoorden u in de uwe.
Contact opnemen met support → Alle artikelen →