ცოდნის ბაზა

Zinnector®-ის პრობლემების აღმოფხვრა

შეცდომები, რომლებსაც მომხმარებლები რეალურად აწყდებიან Zinnector® CLI-სთან დაკავშირებით და თითოეულის გამოსავალი: spawn EINVAL სისტემაში Windows, npm-ის EBADENGINE გაფრთხილება, node-gyp, რომელიც მოითხოვს Visual Studio-ს Node 26-ზე, EPERM ინსტალაციის დროს, გაშვების გარემო, რომელიც არ იტვირთება, და დაკავებული პორტი.

შეცდომები, რომლებსაც მომხმარებლები რეალურად აწყდებიან Zinnector® CLI-ს გამოყენებისას, რას ნიშნავს თითოეული მათგანი და მათი გადაჭრის გზები. თითოეული ჩანაწერი ასახელებს ზუსტ ტექსტს, რომელსაც იხილავთ, რათა შეძლოთ მისი მოძიება ამ გვერდზე. თუ თქვენი შემთხვევა აქ არ არის, გაუშვით წარუმატებელი ბრძანება ZINNECTOR_DEBUG=1-ით და გახსენით პრობლემის განაცხადი (issue) მისამართზე github.com/Zinn-Digital/zinnector/issues შედეგით, თქვენი node --version-ითა და თქვენი ოპერაციული სისტემით.

"spawn EINVAL" runtime-ის ინსტალაციაზე თანხმობისთანავე (Windows)

შეცდომა Zinnector® 0.1.0 და 0.1.1 ვერსიებში. Windows-ზე runtime-ის ინსტალატორი სახელით უშვებდა npm.cmd-ს, ხოლო Node-მა უარი თქვა .cmd ფაილის shell-ის გარეშე გაშვებაზე CVE-2024-27980-ის შესწორების შემდეგ — ამიტომ ინსტალაცია შეწყდა Y-ზე პასუხის გაცემიდან ერთ წამში. გასწორებულია 0.1.2-ში: npm ახლა ეშვება როგორც node npm-cli.js, რაც ერთნაირია ყველა პლატფორმაზე და არ საჭიროებს shell-ს. გაუშვით 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-ის runtime-ს გააჩნია ნატიური მოდული, რომლის წინასწარ აწყობილი ბინარული ფაილები არსებობს მხოლოდ Node 24 და 25-ისთვის. უფრო ახალ Node-ზე (26 და ზემოთ, 2026 წლის სექტემბრის მდგომარეობით) მისი ინსტალატორი გადადის პირველწყაროდან კომპილაციაზე, რაც ჩვეულებრივ Windows-ის მანქანაზე მთავრდება Visual Studio-ს მოთხოვნით. გასწორებულია 0.1.2-ში: Zinnector® აფიქსირებს ამას რაიმეს ჩამოტვირთვამდე და იღებს Node 24-ს მხოლოდ runtime-ისთვის — დაახლოებით 30 მბ, გადამოწმებული nodejs.org-ის საკონტროლო ჯამებთან — ასე რომ, არაფერი აღარ კომპილირდება. თუ განახლების შემდეგ კვლავ ხედავთ ამას, გაუშვით zinnector dev --reset-runtime, რათა ჯერ წაიშალოს წინა, ნახევრად დასრულებული ინსტალაცია.

"EPERM" გაფრთხილებები npm-ისგან გასუფთავებისას (Windows)

თითქმის ყოველთვის ანტივირუსული სკანერი ან ძიების ინდექსატორი ტოვებს ფაილს ღიად runtime-ის node_modules-ში, სანამ npm ცდილობს მის წაშლას. ინსტალაცია განმეორდება სუფთა დირექტორიიდან შემდეგი zinnector dev-ის დროს; თუ ეს კვლავ მეორდება, zinnector dev --reset-runtime ჯერ წაშლის მთლიან runtime დირექტორიას და დააინსტალირებს თავიდან.

"the local playground runtime could not be installed"

შეტყობინება მოიცავს npm-ის საკუთარ ბოლო ხაზებს და ზუსტ ბრძანებას, რომელიც Zinnector®-მა გაუშვა, ასე რომ შეგიძლიათ თავად გაუშვათ იგი და იხილოთ სრული შედეგი. ჩვეულებრივი მიზეზებია ქსელის ან პროქსის პრობლემა — runtime იტვირთება თქვენი საკუთარი npm-ით, შესაბამისად მოქმედებს npm config set proxy … და რეესტრის სარკე — ან წინა, ნახევრად დასრულებული ინსტალაცია, რასაც --reset-runtime ასუფთავებს.

"the local playground exited before it was ready", ან ის არასდროს ხდება მზად

გაუშვით zinnector dev --verbose, რათა იხილოთ უშუალოდ runtime-ის გამონატანი. დაკავებული პორტი ყველაზე ხშირი შემთხვევაა: zinnector dev --port 9401, ან მიუთითეთ port ფაილში zinnector.json. runtime, რომელიც დაინსტალირდა, მაგრამ არ იტვირთება: zinnector dev --reset-runtime. პირველი გაშვება ასევე ჩამოტვირთავს თავად WordPress-ს, ამიტომ ნელ კავშირზე მიეცით მას რამდენიმე წუთი; CLI ელოდება ხუთ წუთამდე, სანამ შეატყობინებს ტაიმაუტს, ნაცვლად იმისა, რომ უბრალოდ გაიყინოს.

"this project is not a git repository" push-ის დროს

დეპლოი ხორციელდება რეპოზიტორიიდან, ამიტომ 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-სთვის.

პოსტის წაკითხვა →

WordPress-ის სისწრაფისა და უსაფრთხოების უზრუნველყოფა: წარმადობისა და მოდულების საკონტროლო სია

პრაქტიკული საკონტროლო სია სწრაფი და უსაფრთხო WordPress-ისთვის: სერვერის დონის ქეშირება, ობიექტების ქეში თითოეული საიტისთვის, რამდენიმე მოდული, რომელთა გამოყენებაც ღირს, ტექნოლოგიური დასტის განახლებულ მდგომარეობაში შენარჩუნება და WooCommerce-ის გვერდები, რომლებიც არასდროს უნდა დააქეშოთ.

პოსტის წაკითხვა →

როგორ შევარჩიოთ მართვადი ვებ ჰოსტინგი 2026 წელს: მყიდველის გზამკვლევი

რა განასხვავებს სინამდვილეში კარგ მართულ ჰოსტინგს მართვის პანელიანი იაფი ყუთისგან — მიგრაციები, სარეზერვო ასლები, იზოლაცია, რეალური ქეშირება და პატიოსანი მასშტაბირება — და როგორ შეაფასოთ იგი ვალდებულების აღებამდე.

პოსტის წაკითხვა →

წაიკითხეთ ბლოგი →

კვლავ გაქვთ პრობლემა?

მხარდაჭერა შედის ყველა გეგმაში, სავარძელი ღიაა დღეში 24 საათის განმავლობაში და შეგიძლიათ მოგვწეროთ ჩვენს ნებისმიერ 58 ენაზე — ჩვენ გიპასუხებთ თქვენს ენაზე.

მხარდაჭერასთან დაკავშირება → ყველა სტატია →