Znalostní báze
Řešení problémů s nástrojem Zinnector®
Chyby, se kterými se lidé u Zinnector CLI skutečně setkávají, a řešení pro každou z nich: spawn EINVAL ve Windows, varování EBADENGINE v npm, požadavek node-gyp na Visual Studio v Node 26, EPERM během instalace, runtime, který se odmítá spustit, a obsazený port.
Chyby, se kterými se uživatelé u Zinnector® CLI skutečně setkávají, co každá z nich znamená a jak je opravit. Každá položka uvádí přesný text, který uvidíte, takže ho na této stránce můžete vyhledat. Pokud tu vaše chyba není, spusťte selhávající příkaz s proměnnou ZINNECTOR_DEBUG=1 a otevřete hlášení problému (issue) na adrese github.com/Zinn-Digital/zinnector/issues spolu s výstupem, informací o příkazu node --version a vaším operačním systémem.
"spawn EINVAL" hned po odsouhlasení instalace runtime (Windows)
Chyba v Zinnector® 0.1.0 a 0.1.1. V systému Windows spouštěl instalační program runtime příkaz npm.cmd podle názvu a Node odmítá spustit soubor .cmd bez shellu od vydání opravy zranitelnosti CVE-2024-27980 – instalace proto selhala vteřinu poté, co jste odpověděli Y. Opraveno ve verzi 0.1.2: npm se nyní spouští jako node npm-cli.js, což je na každé platformě stejné a nevyžaduje to shell. Spusťte příkaz npm install -g zinnector@latest a poté znovu zinnector dev.
"npm WARN EBADENGINE" během instalace nebo "Zinnector® needs Node 24 or newer"
Vaše verze Node je starší než 24. Npm vypíše varování, protože balíček deklaruje engines: >=24.18.1; instalace sice doběhne do konce, ale zinnector se poté odmítne spustit (výstupní kód 78), než aby později selhal nějakým matoucím způsobem. Nainstalujte aktuální verzi LTS z nodejs.org – v systému Windows pomocí winget install OpenJS.NodeJS.LTS, na macOS pomocí brew install node@24 –, ověřte, že node --version vypíše v24 nebo novější, a znovu nainstalujte Zinnector®.
"gyp ERR!", "Building from source with node-gyp" nebo "You need to install Visual Studio"
Runtime WordPressu obsahuje nativní modul, jehož předkompilované binární soubory existují pouze pro Node 24 a 25. V novější verzi Node (26 a novější, stav k září 2026) se jeho instalační program uchýlí ke kompilaci ze zdrojového kódu, což na čistém počítači se systémem Windows skončí požadavkem na Visual Studio. Opraveno ve verzi 0.1.2: Zinnector® to detekuje ještě před stažením čehokoliv a stáhne Node 24 pouze pro samotný runtime – má přibližně 30 MB a je ověřen proti kontrolním součtům z nodejs.org –, takže se nikdy nic kompilovat nebude. Pokud tuto chybu vidíte i po aktualizaci, spusťte zinnector dev --reset-runtime, aby se nedokončená instalace z předchozí doby nejprve zahodila.
Varování "EPERM" od npm během úklidu (Windows)
Téměř vždy se jedná o antivirový skener nebo indexování souborů, které drží soubor otevřený v adresáři node_modules prostředí runtime, zatímco se npm pokouší tento soubor odstranit. Instalace se opakuje z čistého adresáře při příštím spuštění zinnector dev; pokud to nepřestává, zinnector dev --reset-runtime nejprve odstraní celý adresář runtime a provede instalaci znovu.
"the local playground runtime could not be installed"
Zpráva obsahuje poslední řádky samotného nástroje npm a přesný příkaz, který Zinnector® spustil, takže si jej můžete spustit sami a zobrazit celý výstup. Obvyklou příčinou je problém se sítí nebo proxy – runtime se stahuje pomocí vašeho vlastního npm, takže se uplatní příkaz npm config set proxy … a zrcadlo registru –, případně nedokončená předchozí instalace, kterou vymaže přepínač --reset-runtime.
"the local playground exited before it was ready" nebo se lokální prostředí nikdy nepřipraví k provozu
Spuštěním příkazu zinnector dev --verbose zobrazení výstup samotného runtime. Častou příčinou je port, který se již používá: použijte zinnector dev --port 9401 nebo nastavte port v souboru zinnector.json. Runtime, který se nainstaloval, ale odmítá se spustit: zinnector dev --reset-runtime. První spuštění stahuje také samotný WordPress, takže mu na pomalém připojení dopřejte několik minut; CLI čeká až pět minut, než ohlásí časový limit (timeout), namísto toho, aby zamrzlo.
"this project is not a git repository" při pokusu o push
Nasazení (deploy) jsou řízena z repozitáře, takže příkaz zinnector push vyžaduje repozitář se vzdáleným úložištěm, které platforma dokáže oslovit. Proveďte git init && git add -A && git commit -m initial, přidejte vzdálené úložiště GitHub nebo GitLab a poté pomocí zinnector link propojte repozitář s webem.
Web je po nasazení prázdný (bílý)
Spusťte příkaz zinnector check. V devíti případech z deseti jde o nesoulad verzí PHP – sestavili jste web na novější verzi PHP, než jakou slot používá –, a hlášení uvede, na jakou verzi máte slot přepnout pomocí zinnector php <version>, případně proti jaké verzi máte vyvíjet pomocí zinnector dev --php <version>. Samotnou fatální chybu zobrazuje zinnector logs --error.
Související
Stále si nevíte rady?
Podpora je součástí každého tarifu a odpovídáme v češtině.
Kontaktovat podporu → Všechny články →