Tudásbázis

Zinnector® hibaelhárítás

A hibák, amelyekkel a felhasználók ténylegesen találkoznak a Zinnector® CLI használata során, és az egyes hibák megoldása: spawn EINVAL a Windows rendszeren, a(z) npm EBADENGINE figyelmeztetése, a Visual Studio programot igénylő node-gyp a Node 26-on, EPERM a telepítés során, el nem induló futtatókörnyezet és foglalt port.

A felhasználók által a Zinnector® CLI használata során ténylegesen tapasztalt hibák, azok jelentése és a javításuk módja. Minden bejegyzés pontosan azt a szöveget tartalmazza, amelyet látni fog, így rá tud keresni ezen az oldalon. Ha az Ön hibája nem szerepel itt, futtassa a sikertelen parancsot a ZINNECTOR_DEBUG=1 környezeti változóval, és nyisson egy hibajegyet a github.com/Zinn-Digital/zinnector/issues címen a kimenettel, a node --version verziószámával és az operációs rendszerének megjelölésével.

"spawn EINVAL" közvetlenül a futtatókörnyezet telepítésének elfogadása után (Windows)

Hiba a Zinnector® 0.1.0 és 0.1.1 verziójában. Windows rendszeren a futtatókörnyezet telepítője név szerint futtatta az npm.cmd parancsot, a Node pedig a CVE-2024-27980 javítása óta megtagadja a .cmd fájlok burok (shell) nélküli futtatását – így a telepítés egy másodperccel azután összeomlott, hogy Ön Y választ adott. Javítva a 0.1.2 verzióban: az npm mostantól node npm-cli.js formában fut, amely minden platformon azonos, és nem igényel burkot (shell). Futtassa az npm install -g zinnector@latest parancsot, majd ismét a zinnector dev parancsot.

"npm WARN EBADENGINE" a telepítés során, vagy "Zinnector® needs Node 24 or newer"

Az Ön Node verziója régebbi a 24-esnél. Az npm azért jeleníti meg a figyelmeztetést, mert a csomag a következő deklarációt tartalmazza: engines: >=24.18.1; a telepítés ennek ellenére befejeződik, de a zinnector ezt követően megtagadja az indulást (78-as hibakód), ahelyett, hogy később egy nehezen értelmezhető hibával állna le. Telepítse az aktuális LTS-verziót a nodejs.org oldalról – Windows rendszeren a winget install OpenJS.NodeJS.LTS, macOS rendszeren a brew install node@24 paranccsal –, ellenőrizze, hogy a node --version kimenete v24 vagy újabb, majd telepítse újra a Zinnector® eszközt.

"gyp ERR!", "Building from source with node-gyp", vagy "You need to install Visual Studio"

A WordPress futtatókörnyezet rendelkezik egy natív modullal, amelynek előre lefordított binárisai kizárólag a Node 24 és 25 verziókhoz érhetők el. Újabb Node verzió esetén (26-os és újabb, 2026 szeptemberétől) a telepítője forrásból történő fordításra áll vissza, ami egy alapértelmezett Windows-gépen a Visual Studio telepítésének kérésével végződik. Javítva a 0.1.2 verzióban: a Zinnector® még a letöltés előtt észleli ezt, és kizárólag a futtatókörnyezet számára letölt egy Node 24-et – körülbelül 30 MB méretben, ellenőrizve a nodejs.org ellenőrzőösszegei alapján –, így semmi sem kerül forrásból lefordításra. Ha a frissítés után is ezt látja, futtassa a zinnector dev --reset-runtime parancsot, hogy a rendszer először elvethesse a korábbi, félig befejezett telepítést.

"EPERM" figyelmeztetések az npm részéről a takarítás során (Windows)

Szinte mindig egy víruskereső vagy egy keresési indexelő okozza, amely nyitva tart egy fájlt a futtatókörnyezet node_modules mappájában, miközben az npm megpróbálja eltávolítani azt. A telepítés a következő zinnector dev futtatásakor egy tiszta könyvtárból újra megkísérlésre kerül; ha a hiba továbbra is fennáll, a zinnector dev --reset-runtime először eltávolítja a teljes futtatókörnyezeti könyvtárat, majd újra elvégzi a telepítést.

"the local playground runtime could not be installed"

Az üzenet tartalmazza az npm saját utolsó sorait és azt a pontos parancsot, amelyet a Zinnector® futtatott, így Ön saját maga is futtathatja, és láthatja a teljes kimenetet. A gyakori okok közé tartozik a hálózati vagy proxyprobléma – a futtatókörnyezet letöltése az Ön saját npm-ével történik, így az npm config set proxy … beállítás és a csomagtár-tükrözések érvényesek –, vagy egy félig befejezett korábbi telepítés, amelyet a --reset-runtime töröl.

"the local playground exited before it was ready", vagy soha nem áll készen

Futtassa a zinnector dev --verbose parancsot a futtatókörnyezet saját kimenetének megtekintéséhez. A leggyakoribb ok egy már használatban lévő port: használja a zinnector dev --port 9401 parancsot, vagy állítsa be a port értékét a zinnector.json fájlban. Egy olyan futtatókörnyezet esetén, amely települt, de nem indul el: zinnector dev --reset-runtime. Az első indítás magát a WordPress rendszert is letölti, így lassú kapcsolat esetén adjon neki néhány percet; a CLI akár öt percet is vár, mielőtt időtúllépést jelezne a lefagyás helyett.

"this project is not a git repository" a push művelet során

A telepítések egy tárolóból (repository) indulnak, így a zinnector push parancshoz szükség van egy olyan tárolóra, amely rendelkezik a platform által elérhető távoli (remote) kiszolgálóval. Futtassa a git init && git add -A && git commit -m initial parancsot, adja hozzá GitHub vagy GitLab távoli kiszolgálóját, majd a zinnector link segítségével kapcsolja össze a webhellyel.

A webhely fehér képernyőt mutat a közzététel (deploy) után

Futtassa a zinnector check parancsot. Tízből kilenc esetben a PHP-verziók eltérése áll a háttérben – Ön újabb PHP-n végezte a fejlesztést, mint amin a tárhelyfutási környezet (slot) fut –, a jelentés pedig megadja, hogy a zinnector php <version> paranccsal melyik verzióra kell átváltani a környezetet, vagy a zinnector dev --php <version> paranccsal melyikhez kell fejleszteni. A zinnector logs --error parancs magát a végzetes hibát (fatal error) jeleníti meg.

Kapcsolódó anyagok

Minden fejlesztői dokumentáció →

Legfrissebb a blogról

Amit a tárhelyszolgáltatásról, a SEO-ról és a webhelyek nagy léptékű működtetéséről írtunk.

SEO és linképítés a tárhelyréteg felől: Egy üzemeltető szemszöge 2026-ban

Hogyan alakítja a tárhely az indexelést és a linkértéket 2026-ban: az oldalak indexben tartása, a korosodott domainek ellenőrzése a tartalomépítés előtt, linképítés keresőmotoros lábnyom nélkül, és őszinte áttekintés arról, hogy az infrastruktúra mit tehet és mit nem tehet meg a SEO-ért.

Bejegyzés elolvasása →

A WordPress gyorsabbá és biztonságosabbá tétele: Teljesítmény- és bővítmény-ellenőrzőlista

Gyakorlati ellenőrzőlista a gyors és biztonságos WordPress-hez: kiszolgálószintű gyorsítótárazás, webhelyenkénti objektum-gyorsítótár, a maroknyi futtatásra érdemes bővítmény, a technológiai verem naprakészen tartása és a WooCommerce-oldalak, amelyeket soha nem szabad gyorsítótárazni.

Bejegyzés elolvasása →

Hogyan válasszunk menedzselt webtárhelyet 2026-ban: Útmutató vásárlóknak

Mi különbözteti meg valójában a jó menedzselt tárhelyet egy olcsó, vezérlőpulttal ellátott doboztól — migrációk, biztonsági mentések, elszigetelés, valódi gyorsítótárazás és őszinte skálázhatóság — és hogyan ítélheti meg, mielőtt elkötelezné magát.

Bejegyzés elolvasása →

Olvassa el a blogot →

Még mindig elakadt?

A támogatás minden csomag része, az ügyfélszolgálat a nap 24 órájában rendelkezésre áll, és a 58 támogatott nyelvünk bármelyikén írhat nekünk – mi a ön nyelvén válaszolunk.

Kapcsolatfelvétel az ügyfélszolgálattal → Összes cikk →