Baza znanja
Rešavanje problema sa Zinnector®
Greške na koje ljudi zapravo nailaze sa Zinnector CLI i rešenje za svaku od njih: spawn EINVAL na Windowsu, npm-ovo EBADENGINE upozorenje, node-gyp koji traži Visual Studio na Node 26, EPERM tokom instalacije, okruženje koje neće da se pokrene i port koji je u upotrebi.
Greške sa kojima se korisnici zaista susreću u Zinnector® CLI-ju, šta svaka od njih znači i rešenje. Svaki unos navodi tačan tekst koji ćete videti, tako da možete da pretražite ovu stranicu. Ako vaša greška nije ovde, pokrenite neuspešnu komandu sa ZINNECTOR_DEBUG=1 i otvorite problem na github.com/Zinn-Digital/zinnector/issues uz izlaz, vaš node --version i vaš operativni sistem.
"spawn EINVAL" odmah nakon prihvatanja instalacije okruženja za izvršavanje (Windows)
Greška u Zinnector® 0.1.0 i 0.1.1. Na Windowsu je instalater okruženja pokretao npm.cmd po imenu, a Node odbija da pokrene .cmd datoteku bez ljuske (shell-a) još od ispravke za CVE-2024-27980 — tako da je instalacija pala sekundu nakon što ste odgovorili sa Y. Ispravljeno u 0.1.2: npm se sada pokreće kao node npm-cli.js, što je isto na svakoj platformi i ne zahteva ljusku. Pokrenite npm install -g zinnector@latest, pa ponovo zinnector dev.
"npm WARN EBADENGINE" tokom instalacije ili "Zinnector® needs Node 24 or newer"
Vaša verzija Node-a je starija od 24. npm prikazuje upozorenje zato što paket navodi engines: >=24.18.1; instalacija se ipak završava, ali zinnector zatim odbija da se pokrene (izlazni kod 78) umesto da kasnije padne negde gde bi to zbunilo korisnika. Instalirajte trenutnu LTS verziju sa nodejs.org — winget install OpenJS.NodeJS.LTS na Windowsu, brew install node@24 na macOS-u — potvrdite da node --version štampa v24 ili noviju i ponovo instalirajte Zinnector®.
"gyp ERR!", "Building from source with node-gyp" ili "You need to install Visual Studio"
WordPress okruženje ima izvorni modul čiji unapred izgrađeni binarni fajlovi postoje samo za Node 24 i 25. Na novijem Node-u (26 i novijim, od septembra 2026) njegov instalater se vraća na kompajliranje iz izvornog koda, što na običnoj Windows mašini rezultira zahtevom za Visual Studio. Ispravljeno u 0.1.2: Zinnector® ovo otkriva pre nego što bilo šta preuzme i preuzima Node 24 samo za okruženje — oko 30 MB, verifikovano sa kontrolnim sumama sa nodejs.org — tako da se nikada ništa ne kompajlira. Ako ga i dalje vidite nakon nadogradnje, pokrenite zinnector dev --reset-runtime da bi se poluzavršena instalacija od ranije prvo odbacila.
"EPERM" upozorenja od npm-a dok čisti (Windows)
Skoro uvek je u pitanju antivirusni skener ili indeksator pretrage koji drži datoteku otvorenom u direktorijumu node_modules okruženja dok npm pokušava da je ukloni. Instalacija se ponovo pokušava iz čistog direktorijuma prilikom sledećeg pokretanja zinnector dev; ako se to nastavi, zinnector dev --reset-runtime prvo uklanja ceo direktorijum okruženja i ponovo ga instalira.
"the local playground runtime could not be installed"
Poruka uključuje npm-ove sopstvene poslednje linije i tačnu komandu koju je Zinnector® pokrenuo, tako da možete sami da je pokrenete i vidite kompletan izlaz. Uobičajeni uzroci su problem sa mrežom ili proxy-jem — okruženje se preuzima pomoću vašeg sopstvenog npm-a, pa se primenjuju npm config set proxy … i ogledalo registra (registry mirror) — ili poluzavršena ranija instalacija, koju --reset-runtime briše.
"the local playground exited before it was ready", ili postajanje spremnim izostaje
Pokrenite zinnector dev --verbose da biste videli izlaz samog okruženja. Port koji je već u upotrebi je uobičajen razlog: zinnector dev --port 9401, ili podesite port u zinnector.json. Okruženje koje se instaliralo, ali neće da se pokrene: zinnector dev --reset-runtime. Prvo pokretanje takođe preuzima sam WordPress, pa mu na sporoj vezi dajte nekoliko minuta; CLI čeka do pet pre nego što prijavi istekom vremena (timeout) umesto da se blokira.
"this project is not a git repository" prilikom slanja (push)
Zaduživanja (deploy) se pokreću iz repozitorijuma, tako da zinnector push zahteva jedan sa udaljenom lokacijom (remote) koju platforma može da dostigne. git init && git add -A && git commit -m initial, dodajte svoju GitHub ili GitLab udaljenu lokaciju, a zatim zinnector link da biste je povezali sa sajtom.
Sajt je beo nakon zaduživanja (deploy)
Pokrenite zinnector check. Devet puta od deset u pitanju je razlika u verziji PHP-a — gradili ste na novijem PHP-u nego što slot pokreće — i izveštaj govori na koju verziju da prebacite slot pomoću zinnector php <version>, ili protiv koje da razvijate pomoću zinnector dev --php <version>. zinnector logs --error prikazuje samu fatalnu grešku.
Povezano
Još uvek ste zaglavljeni?
Podrška je uključena u svaki paket, a odgovori stižu na vašem jeziku.
Kontaktirajte podršku → Svi članci →