База знань

Усунення несправностей Zinnector®

Помилки, з якими користувачі дійсно стикаються в Zinnector® CLI, та способи їх усунення: spawn EINVAL у Windows, попередження EBADENGINE від npm, запит Visual Studio від node-gyp на Node 26, EPERM під час інсталяції, середовище виконання, яке не запускається, і зайнятий порт.

Помилки, з якими користувачі реально стикаються у CLI Zinnector®, значення кожної з них і способи вирішення. Кожен запис містить точний текст, який ви побачите, тому ви можете знайти його за допомогою пошуку на цій сторінці. Якщо вашої помилки тут немає, виконайте команду, що викликає збій, із параметром ZINNECTOR_DEBUG=1 і відкрийте issue за адресою github.com/Zinn-Digital/zinnector/issues, додавши вивід, вашу версію node --version та операційну систему.

"spawn EINVAL" одразу після підтвердження встановлення середовища виконання (Windows)

Помилка у Zinnector® 0.1.0 та 0.1.1. У Windows інсталятор середовища виконання запускав npm.cmd за назвою, а Node відмовляється породжувати файл .cmd без командної оболонки з моменту виправлення вразливості CVE-2024-27980 — тому встановлення аварійно завершувалося через секунду після вашої відповіді Y. Виправлено у 0.1.2: npm тепер запускається як node npm-cli.js, що однаково працює на всіх платформах і не потребує командної оболонки. Виконайте npm install -g zinnector@latest, а потім знову zinnector dev.

"npm WARN EBADENGINE" під час встановлення або "Zinnector® needs Node 24 or newer"

Ваша версія Node старіша за 24. npm виводить це попередження, оскільки пакет декларує engines: >=24.18.1; встановлення однаково завершується, але потім zinnector відмовляється запускатися (код виходу 78), щоб уникнути незрозумілих збоїв пізніше. Встановіть поточну LTS-версію з nodejs.org — winget install OpenJS.NodeJS.LTS у Windows, brew install node@24 у macOS — переконайтеся, що команда node --version повертає v24 або вище, і встановіть Zinnector® знову.

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

Середовище виконання WordPress має нативний модуль, чиї скомпільовані бінарні файли існують лише для Node 24 та 25. На новіших версіях Node (26 і вище, станом на вересень 2026 року) його інсталятор повертається до компіляції з вихідного коду, що на звичайному комп'ютері з Windows завершується вимогою встановити Visual Studio. Виправлено у 0.1.2: Zinnector® виявляє це перед завантаженням будь-чого та отримує Node 24 суто для середовища виконання — близько 30 МБ із перевіркою контрольних сум від nodejs.org — тож компіляція взагалі не відбувається. Якщо після оновлення ви все одно це бачите, виконайте zinnector dev --reset-runtime, щоб спершу видалити незавершене попереднє встановлення.

Попередження "EPERM" від npm під час очищення (Windows)

Майже завжди це антивірус або служба індексації пошуку, які утримують відкритим файл у node_modules середовища виконання, поки npm намагається його видалити. Під час наступного запуску zinnector dev встановлення повторюється з чистого каталогу; якщо це повторюється знову, zinnector dev --reset-runtime спочатку видалить увесь каталог середовища виконання та встановить його повторно.

"the local playground runtime could not be installed"

Повідомлення містить останні рядки від самого npm і точну команду, яку виконав Zinnector®, тож ви можете запустити її самостійно й переглянути повний вивід. Типовими причинами є проблеми з мережею чи проксі — середовище виконання завантажується за допомогою вашого власного npm, тому застосовуються npm config set proxy … і дзеркала реєстру — або незавершене попереднє встановлення, яке очищує --reset-runtime.

"the local playground exited before it was ready" або воно ніколи не переходить у стан готовності

Виконайте zinnector dev --verbose, щоб побачити власний вивід середовища виконання. Найпоширеніша проблема — зайнятий порт: використайте zinnector dev --port 9401 або вкажіть port у zinnector.json. Середовище виконання встановилося, але не запускається: виконайте zinnector dev --reset-runtime. Перший запуск також завантажує власне WordPress, тому за повільного з'єднання зачекайте кілька хвилин; замість зависання CLI очікує до п'яти хвилин, перш ніж повідомити про тайм-аут.

"this project is not a git repository" під час надсилання (push)

Розгортання здійснюються з репозиторію, тому zinnector push потребує наявності репозиторію з віддаленим сервером, до якого платформа має доступ. Виконайте git init && git add -A && git commit -m initial, додайте ваш віддалений репозиторій GitHub чи GitLab, а потім використайте zinnector link, щоб зв'язати його з сайтом.

Білий екран сайту після розгортання

Виконайте zinnector check. У дев'яти випадках із десяти це різниця версій PHP — ви здійснювали збірку на новішій версії PHP, ніж запущена на слоті — і звіт покаже, на яку версію слід перемкнути слот за допомогою zinnector php <version>, або під яку версію слід розробляти за допомогою zinnector dev --php <version>. Команда zinnector logs --error показує саму критичну помилку.

Пов'язані матеріали

Уся документація для розробників →

Останнє з блогу

Що ми писали про хостинг, SEO та роботу сайтів у великих масштабах.

SEO та лінкбілдінг із рівня хостингу: Погляд оператора 2026 року

Як хостинг впливає на індексацію та передачу ваги посилань (link equity) у 2026 році: підтримка сторінок у пошуковому індексі, перевірка старих доменів перед створенням сайтів, лінкбілдинг без слідів (footprint) та відвертий погляд на те, що інфраструктура може і чого не може зробити для SEO.

Читати допис →

Як зробити WordPress швидким та безпечним: контрольний список оптимізації та плагінів

Практичний контрольний список для швидкого та безпечного WordPress: кешування на рівні сервера, об'єктний кеш для кожного сайту, кілька дійсно вартих плагінів, підтримання стека в актуальному стані та сторінки WooCommerce, які в жодному разі не можна кешувати.

Читати допис →

Як вибрати керований вебхостинг у 2026 році: Посібник для покупця

Що насправді відрізняє якісний керований хостинг від дешевого сервера з панеллю керування — міграції, резервні копії, ізоляція, справжнє кешування та чесне масштабування — і як оцінити його, перш ніж брати на себе зобов'язання.

Читати допис →

Читати блог →

Усе ще потрібна допомога?

Підтримка включена до кожного тарифу, служба працює 24 годин на добу, і ви можете писати нам будь-якою з наших 58 мов — ми відповідаємо вашою.

Звернутися до служби підтримки → Усі статті →