آموزش استفاده از npm mirror برای نصب پکیج‌ها در ایران بدون مشکل تحریم و کندی اینترنت

توسعه‌دهندگانی که در ایران با Node.js و npm کار می‌کنند معمولاً با مشکلاتی مثل کندی شدید دانلود پکیج‌ها، خطاهای اتصال و محدودیت‌های اینترنت بین‌المللی مواجه می‌شوند. این مشکل مخصوصاً هنگام نصب وابستگی‌های پروژه با دستور npm install بیشتر خودش را نشان می‌دهد.

یکی از راه‌حل‌های ساده و مؤثر برای حل این مشکل، استفاده از npm mirror است. در این روش به جای استفاده از رجیستری اصلی npm، از یک آینه (mirror) سریع‌تر استفاده می‌کنیم که دسترسی به پکیج‌ها را پایدارتر و سریع‌تر می‌کند.

در این آموزش نحوه استفاده از mirror مربوط به runflare را برای نصب سریع‌تر پکیج‌های npm بررسی می‌کنیم.

مشکل رجیستری اصلی npm در ایران

رجیستری اصلی npm در آدرس زیر قرار دارد:

https://registry.npmjs.org

اما به دلیل محدودیت‌های شبکه، تحریم‌ها یا اختلال در اینترنت بین‌المللی، بسیاری از توسعه‌دهندگان در ایران با مشکلات زیر مواجه می‌شوند:

- timeout هنگام نصب پکیج‌ها
- سرعت بسیار پایین دانلود
- خطاهای network error
- قطع شدن نصب در میانه فرآیند

استفاده از npm mirror برای حل مشکل

برای رفع این مشکل می‌توانید رجیستری npm را به یک mirror سریع‌تر تغییر دهید.

یکی از گزینه‌های مناسب، mirror مربوط به runflare است.

برای تنظیم آن کافی است دستور زیر را اجرا کنید:

npm config set registry https://mirror-npm.runflare.com

بعد از اجرای این دستور، npm به جای رجیستری اصلی از mirror استفاده می‌کند و نصب پکیج‌ها معمولاً **پایدارتر و سریع‌تر** انجام می‌شود.

بررسی تنظیمات npm registry

برای اینکه مطمئن شوید تنظیمات به درستی اعمال شده است می‌توانید دستور زیر را اجرا کنید:

npm config get registry

اگر خروجی شبیه این بود یعنی تنظیمات درست انجام شده است:
 

https://mirror-npm.runflare.com

بازگرداندن به رجیستری اصلی npm

در صورتی که بخواهید دوباره از رجیستری رسمی npm استفاده کنید، دستور زیر را اجرا کنید:

npm config set registry https://registry.npmjs.org

جمع‌بندی

اگر در ایران هستید و هنگام نصب پکیج‌های npm با مشکل سرعت یا خطای اتصال مواجه می‌شوید، استفاده از npm mirror می‌تواند یک راه‌حل ساده و مؤثر باشد. با تغییر رجیستری npm به mirrorهایی مثل runflare می‌توانید فرآیند نصب وابستگی‌های پروژه را سریع‌تر و بدون دردسر انجام دهید.

این روش مخصوصاً برای توسعه‌دهندگانی که با Node.js، React، Next.js، Vue یا سایر ابزارهای جاوااسکریپت کار می‌کنند بسیار مفید است.