Basis pengetahuan

Pemecahan Masalah Zinnector®

Kesalahan yang benar-benar dialami orang saat menggunakan CLI Zinnector® dan perbaikan untuk masing-masing masalah: spawn EINVAL di Windows, peringatan EBADENGINE milik npm, node-gyp yang meminta Visual Studio di Node 26, EPERM saat penginstalan, runtime yang tidak mau boot, dan porta yang sedang digunakan.

Kesalahan-kesalahan yang benar-benar dialami pengguna dengan CLI Zinnector®, arti dari masing-masing kesalahan tersebut, dan solusinya. Setiap entri menyebutkan teks persis yang akan Anda lihat, sehingga Anda dapat mencarinya di halaman ini. Jika masalah Anda tidak tercantum di sini, jalankan perintah yang gagal dengan ZINNECTOR_DEBUG=1 dan buka issue di github.com/Zinn-Digital/zinnector/issues yang menyertakan output tersebut, node --version Anda, dan sistem operasi Anda.

"spawn EINVAL" tepat setelah menyetujui penginstalan runtime (Windows)

Bug pada Zinnector® 0.1.0 dan 0.1.1. Pada Windows, alat penginstal runtime menjalankan npm.cmd berdasarkan nama, dan Node menolak untuk menjalankan file .cmd tanpa shell sejak perbaikannya untuk CVE-2024-27980 — sehingga penginstalan mengalami crash satu detik setelah Anda menjawab Y. Diperbaiki pada 0.1.2: npm kini dijalankan sebagai node npm-cli.js, yang sama di setiap platform dan tidak memerlukan shell. Jalankan npm install -g zinnector@latest, lalu jalankan zinnector dev kembali.

"npm WARN EBADENGINE" saat penginstalan, atau "Zinnector® needs Node 24 or newer"

Versi Node Anda lebih lama dari 24. npm menampilkan peringatan tersebut karena paket mendeklarasikan engines: >=24.18.1; penginstalan tetap selesai, tetapi zinnector kemudian menolak untuk memulai (kode keluar 78) alih-alih mengalami kegagalan yang membingungkan nantinya. Instal versi LTS saat ini dari nodejs.org — winget install OpenJS.NodeJS.LTS di Windows, brew install node@24 di macOS — pastikan node --version mencetak v24 atau lebih tinggi, lalu instal Zinnector® kembali.

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

Runtime WordPress memiliki modul native yang biner siap pakainya hanya tersedia untuk Node 24 dan 25. Pada Node yang lebih baru (26 ke atas, per September 2026), alat penginstalnya beralih untuk mengompilasi dari sumber (source), yang pada mesin Windows standar berakhir dengan permintaan untuk memasang Visual Studio. Diperbaiki pada 0.1.2: Zinnector® mendeteksi hal ini sebelum mengunduh apa pun dan mengambil Node 24 khusus untuk runtime saja — sekitar 30 MB, diverifikasi terhadap checksum nodejs.org — sehingga tidak ada yang dikompilasi sama sekali. Jika Anda masih melihatnya setelah melakukan pembaruan, jalankan zinnector dev --reset-runtime agar penginstalan yang baru selesai sebagian dari sebelumnya dibuang terlebih dahulu.

Peringatan "EPERM" dari npm saat sedang melakukan pembersihan (Windows)

Hampir selalu disebabkan oleh pemindai antivirus atau pengindeks pencarian yang membiarkan file tetap terbuka di bawah node_modules runtime saat npm mencoba menghapusnya. Penginstalan akan dicoba kembali dari direktori yang bersih pada zinnector dev berikutnya; jika hal ini terus terjadi, zinnector dev --reset-runtime akan menghapus seluruh direktori runtime terlebih dahulu dan menginstalnya kembali.

"the local playground runtime could not be installed"

Pesan ini menyertakan baris-baris terakhir milik npm sendiri dan perintah persis yang dijalankan Zinnector®, sehingga Anda dapat menjalankannya sendiri dan melihat output lengkapnya. Penyebab umumnya adalah masalah jaringan atau proksi — runtime diambil menggunakan npm Anda sendiri, sehingga npm config set proxy … dan mirror registri berlaku — atau penginstalan sebelumnya yang baru selesai sebagian, yang dapat dibersihkan oleh --reset-runtime.

"the local playground exited before it was ready", atau tidak kunjung siap

Jalankan zinnector dev --verbose untuk melihat output dari runtime itu sendiri. Port yang sudah digunakan adalah masalah yang umum terjadi: zinnector dev --port 9401, atau atur port di zinnector.json. Runtime yang terinstal tetapi tidak mau melakukan booting: zinnector dev --reset-runtime. Booting pertama juga mengunduh WordPress itu sendiri, jadi pada koneksi lambat, berikan waktu beberapa menit; CLI menunggu hingga lima menit sebelum melaporkan batas waktu habis alih-alih mengalami freeze.

"this project is not a git repository" saat push

Penerapan (deploy) dijalankan dari repositori, sehingga zinnector push memerlukan repositori dengan remote yang dapat dijangkau oleh platform. git init && git add -A && git commit -m initial, tambahkan remote GitHub atau GitLab Anda, lalu jalankan zinnector link untuk menghubungkannya ke situs.

Situs menjadi putih setelah penerapan

Jalankan zinnector check. Sembilan dari sepuluh kasus merupakan perbedaan versi PHP — Anda membangun pada versi PHP yang lebih baru daripada yang dijalankan slot — dan laporan tersebut menyebutkan ke versi mana slot harus dialihkan dengan zinnector php <version>, atau versi mana yang digunakan untuk pengembangan dengan zinnector dev --php <version>. zinnector logs --error menampilkan fatal error itu sendiri.

Terkait

Semua dokumentasi pengembang →

Terbaru dari blog

Apa yang telah kami tulis tentang hosting, SEO, dan mengelola situs dalam skala besar.

SEO dan Pembangunan Tautan dari Lapisan Hosting: Pandangan Operator Tahun 2026

Bagaimana hosting membentuk pengindeksan dan link equity pada tahun 2026: menjaga halaman tetap terindeks, memeriksa domain lama sebelum mengembangkannya, membangun tautan tanpa jejak mesin pencari, dan pandangan jujur tentang apa yang dapat dan tidak dapat dilakukan infrastruktur untuk SEO.

Baca postingan →

Membuat WordPress Cepat dan Aman: Daftar Periksa Performa dan Plugin

Daftar periksa praktis untuk WordPress yang cepat dan aman: caching tingkat server, object cache per situs, beberapa plugin yang layak dijalankan, menjaga tumpukan teknologi tetap mutakhir, dan halaman WooCommerce yang tidak boleh Anda simpan di cache.

Baca postingan →

Cara Memilih Web Hosting Terkelola di Tahun 2026: Panduan Pembeli

Apa yang sebenarnya membedakan hosting terkelola yang baik dari kotak murah dengan panel kontrol — migrasi, pencadangan, isolasi, caching nyata, dan penskalaan yang jujur — dan cara menilainya sebelum Anda berkomitmen.

Baca postingan →

Baca blog →

Masih mengalami kendala?

Dukungan disertakan pada setiap paket, layanan meja bantuan buka selama 24 jam sehari, dan Anda dapat menulis kepada kami dalam salah satu dari 58 bahasa kami — kami akan menjawab Anda dalam bahasa Anda.

Hubungi dukungan → Semua artikel →