База от знания

Отстраняване на неизправности с Zinnector®

Грешките, с които хората реално се сблъскват при Zinnector® CLI, и решението за всяка от тях: spawn EINVAL в Windows, предупреждението EBADENGINE на npm, изискването на Visual Studio от node-gyp при Node 26, EPERM по време на инсталация, среда за изпълнение, която не се стартира, и зает порт.

Грешките, с които потребителите действително се сблъскват при Zinnector® CLI, какво означава всяка от тях и как се отстранява. Всеки запис посочва точния текст, който ще видите, така че можете да търсите на тази страница по него. Ако Вашият случай липсва тук, изпълнете неуспешната команда със ZINNECTOR_DEBUG=1 и отворете проблем на адрес 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 MB, проверени спрямо контролните суми на 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, така че при бавна връзка изчакайте няколко минути; интерфейсът с команден ред изчаква до пет минути, преди да отчете изтекло време, вместо да блокира.

„this project is not a git repository“ при качване

Внедряванията се управляват от хранилище, затова zinnector push се нуждае от такова с отдалечен адрес (remote), до който платформата има достъп. Изпълнете 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 г.

Как хостингът влияе на индексирането и предаването на линк авторитет през 2026 г.: запазване на страниците индексирани, проверка на стари домейни преди изграждане върху тях, изграждане на линкове без SEO отпечатък и честен поглед върху това какво инфраструктурата може и не може да направи за SEO.

Прочетете публикацията →

Как да направите WordPress бърз и сигурен: контролен списък за производителност и плъгини

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

Прочетете публикацията →

Как да изберете управляван уеб хостинг през 2026 г.: Ръководство за купувача

Какво всъщност отличава добрия управляван хостинг от евтина кутия с контролен панел — миграции, резервни копия, изолация, реално кеширане и честно мащабиране — и как да го прецените, преди да се ангажирате.

Прочетете публикацията →

Прочетете блога →

Все още се затруднявате?

Поддръжката е включена във всеки план, отделът работи 24 часа в денонощието и можете да ни пишете на всеки от нашите 58 езика — ние ви отговаряме на вашия.

Свържете се с поддръжката → Всички статии →