پایگاه دانش
خطاهایی که افراد واقعاً در Zinnector® CLI با آن‌ها مواجه می‌شوند و راه‌حل هر یک: خطای spawn EINVAL در Windows، هشدار EBADENGINE در npm، درخواست Visual Studio توسط node-gyp در Node 26، خطای EPERM در هنگام نصب، محیط اجرایی که بوت نمی‌شود و درگاه در حال استفاده.
خطاهایی که کاربران در عمل با CLI Zinnector® با آن‌ها مواجه می‌شوند، معنای هر یک، و راهکار رفع آن. در هر مدخل متن دقیقی که مشاهده خواهید کرد ذکر شده است، بنابراین می‌توانید این صفحه را برای آن جستجو کنید. اگر خطای شما در اینجا نیست، دستور ناموفق را با ZINNECTOR_DEBUG=1 اجرا کنید و در github.com/Zinn-Digital/zinnector/issues به همراه خروجی، node --version و سیستم‌عامل خود یک issue باز کنید.
یک باگ در Zinnector® نسخه 0.1.0 و 0.1.1. در Windows، نصب‌کننده محیط اجرا npm.cmd را بر اساس نام اجرا می‌کرد، و Node از زمان اصلاحیه خود برای CVE-2024-27980 از فراخوانی فایل .cmd بدون shell خودداری کرده است — بنابراین نصب، یک ثانیه پس از اینکه به پاسخ Y دادید دچار crash می‌شد. رفع‌شده در 0.1.2: اکنون npm به صورت node npm-cli.js اجرا می‌شود که در تمام پلتفرم‌ها یکسان است و به هیچ shell نیازی ندارد. دستور npm install -g zinnector@latest و سپس دوباره zinnector dev را اجرا کنید.
نسخه Node شما قدیمی‌تر از ۲۴ است. npm این هشدار را نمایش می‌دهد زیرا بسته حاوی engines: >=24.18.1 است؛ فرایند نصب به هر حال تکمیل می‌شود، اما سپس zinnector به جای اینکه بعداً در نقطه‌ای گیج‌کننده دچار خطا شود، از شروع به کار خودداری می‌کند (کد خروج ۷۸). نسخه LTS فعلی را از nodejs.org نصب کنید — winget install OpenJS.NodeJS.LTS در Windows، و brew install node@24 در macOS — تأیید کنید که node --version مقدار v24 یا بالاتر را نمایش می‌دهد، و Zinnector® را دوباره نصب کنید.
محیط اجرای WordPress دارای یک ماژول بومی (native module) است که باینری‌های از پیش ساخته‌شده آن فقط برای Node 24 و 25 وجود دارد. در نسخه‌های جدیدتر Node (۲۶ به بالا، از سپتامبر ۲۰۲۶)، نصب‌کننده آن به عنوان راهکار جایگزین به سراغ کامپایل از سورس می‌رود، که در یک سیستم استاندارد Windows به درخواست برای Visual Studio منتهی می‌شود. رفع‌شده در 0.1.2: Zinnector® پیش از دانلود هر چیزی این موضوع را تشخیص می‌دهد و یک Node 24 را تنها برای محیط اجرا دریافت می‌کند — حدود ۳۰ مگابایت، که بر اساس چکسام‌های nodejs.org تأیید شده است — بنابراین هیچ چیز هرگز کامپایل نمی‌شود. اگر پس از ارتقا هنوز آن را مشاهده می‌کنید، zinnector dev --reset-runtime را اجرا کنید تا نصب نیمه‌کاره قبلی ابتدا دور ریخته شود.
تقریباً همیشه به دلیل آن است که یک اسکنر آنتی‌ویروس یا ایندکس‌کننده جستجو فایلی را در زیرمجموعه node_modules محیط اجرا، در حالی که npm برای حذف آن تلاش می‌کند، باز نگه داشته است. در اجرای بعدی zinnector dev، فرایند نصب مجدداً از یک دایرکتوری پاک تلاش خواهد شد؛ اگر این وضعیت ادامه داشت، zinnector dev --reset-runtime ابتدا کل دایرکتوری محیط اجرا را حذف کرده و مجدداً نصب می‌کند.
پیام حاوی خطوط پایانی خود npm و دستور دقیقی است که Zinnector® اجرا کرده است، بنابراین می‌توانید خودتان آن را اجرا کرده و خروجی کامل را مشاهده کنید. دلایل معمول شامل مشکل شبکه یا پروکسی است — محیط اجرا با npm خود شما دریافت می‌شود، بنابراین npm config set proxy … و mirror رجیستری اعمال می‌شوند — یا یک نصب نیمه‌کاره قبلی، که --reset-runtime آن را پاک می‌کند.
دستور zinnector dev --verbose را اجرا کنید تا خروجی خود محیط اجرا را مشاهده نمایید. پورتی که قبلاً استفاده شده دلیل شایع آن است: zinnector dev --port 9401، یا تنظیم port در zinnector.json. محیط اجرایی که نصب شده اما بالا نمی‌آید: zinnector dev --reset-runtime. راه‌اندازی اول همچنین خود WordPress را دانلود می‌کند، بنابراین در یک اتصال کند چند دقیقه به آن فرصت دهید؛ CLI تا پنج دقیقه قبل از گزارش timeout منتظر می‌ماند تا معلق نماند.
فرایندهای استقرار از طریق مخزن هدایت می‌شوند، بنابراین zinnector push به مخزنی با یک remote نیاز دارد که پلتفرم بتواند به آن دسترسی پیدا کند. دستور git init && git add -A && git commit -m initial را اجرا کنید، remote مربوط به GitHub یا GitLab خود را اضافه نمایید، و سپس با zinnector link آن را به سایت متصل کنید.
دستور zinnector check را اجرا کنید. نه بار از هر ده بار، مشکل از اختلاف نسخه PHP است — شما با PHP جدیدتری نسبت به نسخه‌ای که اسلات اجرا می‌کند بیلد گرفته‌اید — و گزارش مشخص می‌کند که با zinnector php <version> اسلات را به کدام نسخه تغییر دهید، یا با zinnector dev --php <version> توسعه را بر مبنای کدام نسخه انجام دهید. دستور zinnector logs --error خود خطای fatal را نمایش می‌دهد.
آنچه درباره میزبانی وب، سئو و مدیریت سایت‌ها در مقیاس بزرگ نوشته‌ایم.
چگونه هاستینگ در سال ۲۰۲۶ بر ایندکس شدن و انتقال اعتبار لینک تأثیر می‌گذارد: حفظ صفحات در ایندکس، ارزیابی دامنه‌های قدیمی قبل از راه‌اندازی سایت روی آن‌ها، لینک‌سازی بدون ردپای سئو، و رویکردی واقع‌بینانه درباره اینکه زیرساخت چه کارهایی را می‌تواند و چه کارهایی را نمی‌تواند برای سئو انجام دهد.
خواندن مطلب ←یک چک‌لیست کاربردی برای WordPress سریع و ایمن: کش کردن در سطح سرور، کش اشیاء به ازای هر سایت، تعداد اندک افزونه‌هایی که ارزش استفاده دارند، به‌روز نگه داشتن بسته نرم‌افزاری، و برگه های WooCommerce که هرگز نباید آن‌ها را کش کنید.
خواندن مطلب ←چه چیزی واقعاً یک میزبانی مدیریت‌شده خوب را از یک جعبه ارزان‌قیمت دارای کنترل‌پنل متمایز می‌کند — مهاجرت‌ها، نسخه‌های پشتیبان، جداسازی، حافظه پنهان واقعی و مقیاس‌پذیری صادقانه — و چگونه پیش از تعهد، آن را ارزیابی کنید.
خواندن مطلب ←پشتیبانی در تمامی پلن‌ها گنجانده شده است، میز خدمت 24 ساعت در روز باز است و می‌توانید به هر یک از زبان‌های 58 ما برای ما بنویسید؛ ما به زبان شما پاسخ می‌دهیم.
تماس با پشتیبانی → همه مقاله‌ها →