Base ng kaalaman

Pag-troubleshoot sa Zinnector®

Ang mga error na talagang nararanasan ng mga tao sa Zinnector® CLI at ang solusyon para sa bawat isa: spawn EINVAL sa Windows, ang babalang EBADENGINE ng npm, ang node-gyp na humihingi ng Visual Studio sa Node 26, EPERM habang nag-i-install, isang runtime na hindi nagbu-boot, at isang port na ginagamit na.

Ang mga error na aktuwal na nararanasan ng mga tao sa Zinnector® CLI, ang kahulugan ng bawat isa, at ang solusyon. Tinutukoy ng bawat entry ang eksaktong text na makikita mo, upang mahanap mo ito sa pahinang ito. Kung wala rito ang sa iyo, patakbuhin ang nabigong command nang may ZINNECTOR_DEBUG=1 at magbukas ng issue sa github.com/Zinn-Digital/zinnector/issues kasama ang output, ang iyong node --version, at ang iyong operating system.

"spawn EINVAL" pagkatapos na pagkatapos tanggapin ang pag-install ng runtime (Windows)

Isang bug sa Zinnector® 0.1.0 at 0.1.1. Sa Windows, pinatakbo ng runtime installer ang npm.cmd ayon sa pangalan, at tumatanggi ang Node na mag-spawn ng .cmd na file nang walang shell mula noong pag-aayos nito para sa CVE-2024-27980 — kaya nag-crash ang pag-install isang segundo pagkatapos mong sumagot ng Y. Naayos sa 0.1.2: pinapatakbo na ngayon ang npm bilang node npm-cli.js, na pareho sa bawat platform at hindi nangangailangan ng shell. Patakbuhin ang npm install -g zinnector@latest, pagkatapos ay zinnector dev muli.

"npm WARN EBADENGINE" habang nag-i-install, o "Zinnector® needs Node 24 or newer"

Mas luma sa 24 ang iyong Node. Ipinapakita ng npm ang babala dahil ipinapahayag ng package ang engines: >=24.18.1; natatapos pa rin ang pag-install, ngunit tatanggi ang zinnector na magsimula (exit code 78) sa halip na mabigo sa nakakalitong paraan sa ibang pagkakataon. I-install ang kasalukuyang LTS mula sa nodejs.org — winget install OpenJS.NodeJS.LTS sa Windows, brew install node@24 sa macOS — kumpirmahing nagpapakita ang node --version ng v24 o mas mataas, at i-install muli ang Zinnector®.

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

Mayroong native module ang WordPress runtime na ang mga prebuilt binary ay umiiral lamang para sa Node 24 at 25. Sa mas bagong Node (26 pataas, simula noong Setyembre 2026), nagbabalik ang installer nito sa pag-compile mula sa source, na sa isang karaniwang Windows machine ay nagtatapos sa kahilingan para sa Visual Studio. Naayos sa 0.1.2: Natutukoy ito ng Zinnector® bago mag-download ng anuman at kumukuha ito ng Node 24 para sa runtime lamang — humigit-kumulang 30 MB, na na-verify laban sa mga checksum ng nodejs.org — kaya walang kailanman kino-compile. Kung nakikita mo pa rin ito pagkatapos mag-upgrade, patakbuhin ang zinnector dev --reset-runtime upang itapon muna ang kalahating tapos na pag-install mula dati.

Mga babalang "EPERM" mula sa npm habang naglilinis ito (Windows)

Halos palaging isang antivirus scanner o isang search indexer ang nagpapanatiling nakabukas sa isang file sa ilalim ng node_modules ng runtime habang sinusubukan itong alisin ng npm. Sinusubukang muli ang pag-install mula sa isang malinis na directory sa susunod na zinnector dev; kung patuloy itong nangyayari, aalisin muna ng zinnector dev --reset-runtime ang buong directory ng runtime at mag-i-install muli.

"the local playground runtime could not be installed"

Kasama sa mensahe ang sariling mga huling linya ng npm at ang eksaktong command na pinatakbo ng Zinnector®, upang mapatakbo mo ito mismo at makita ang buong output. Ang karaniwang mga sanhi ay problema sa network o proxy — kinukuha ang runtime gamit ang iyong sariling npm, kaya nalalapat ang npm config set proxy … at isang registry mirror — o isang kalahating tapos na naunang pag-install, na nililinis ng --reset-runtime.

"the local playground exited before it was ready", o hindi ito kailanman nagiging handa

Patakbuhin ang zinnector dev --verbose upang makita ang sariling output ng runtime. Ang isang port na ginagamit na ang karaniwang dahilan: zinnector dev --port 9401, o itakda ang port sa zinnector.json. Isang runtime na na-install ngunit hindi mag-boot: zinnector dev --reset-runtime. Dina-download din sa unang pag-boot ang WordPress mismo, kaya sa isang mabagal na koneksyon, bigyan ito ng ilang minuto; naghihintay ang CLI nang hanggang limang minuto bago mag-ulat ng timeout sa halip na mag-hang.

"this project is not a git repository" sa pag-push

Pinapagana mula sa isang repository ang mga pag-deploy, kaya nangangailangan ang zinnector push ng isa na may remote na maaabot ng platform. git init && git add -A && git commit -m initial, idagdag ang iyong GitHub o GitLab remote, pagkatapos ay zinnector link upang ikonekta ito sa site.

Puti ang site pagkatapos ng pag-deploy

Patakbuhin ang zinnector check. Siyam sa sampung beses ay isa itong agwat sa bersyon ng PHP — nag-build ka sa mas bagong PHP kaysa sa pinapatakbo ng slot — at sinasabi ng ulat kung aling bersyon ililipat ang slot gamit ang zinnector php <version>, o kung alin ang gagamitin sa pag-develop gamit ang zinnector dev --php <version>. Ipinapakita ng zinnector logs --error ang fatal error mismo.

Kaugnay

Lahat ng dokumentasyon ng developer →

Pinakabago mula sa blog

Ang aming mga isinulat tungkol sa hosting, SEO, at pagpapatakbo ng mga site nang malawakan.

SEO at Pagbuo ng Link mula sa Hosting Layer: Pananaw ng isang Operator sa 2026

Kung paano hinuhubog ng hosting ang pag-index at link equity sa 2026: pagpapanatiling naka-index ang mga page, pagsusuri sa mga lumang domain bago magtayo sa mga ito, pagbuo ng link nang walang bakas ng search engine, at tapat na pagtingin sa kung ano ang kaya at hindi kayang gawin ng imprastraktura para sa SEO.

Basahin ang post →

Paggawang Mabilis at Ligtas sa WordPress: Isang Checklist sa Pagganap at Plugin

Isang praktikal na checklist para sa mabilis at ligtas na WordPress: pag-cache sa antas ng server, isang object cache bawat site, ang iilang plugin na sulit patakbuhin, pagpapanatiling updated sa stack, at ang mga pahina ng WooCommerce na hinding-hindi mo dapat i-cache.

Basahin ang post →

Paano Pumili ng Managed Web Hosting sa 2026: Gabay ng Mamimili

Kung ano talaga ang nagtatangi sa mahusay na pinamamahalaang hosting mula sa isang murang kahon na may control panel — mga migrasyon, backup, paghihiwalay, totoong pag-cache, at tapat na pag-scale — at kung paano ito huhusgahan bago kayo magpasya.

Basahin ang post →

Basahin ang blog →

Kailangan pa rin ng tulong?

Kasama ang suporta sa bawat plan, bukas ang desk 24 oras bawat araw, at maaari kang sumulat sa amin sa alinman sa aming 58 na mga wika — sasagutin ka namin sa iyong wika.

Makipag-ugnayan sa suporta → Lahat ng artikulo →