Skip to content

پیکربندی آینه‌ها برای NVM

هنگام استفاده از NVM برای نصب Node.js، ممکن است با سرعت دانلود کند مواجه شوید، به ویژه در مناطق جغرافیایی خاص. پیکربندی آینه‌ها می‌تواند با استفاده از سرورهایی که به مکان شما نزدیک‌تر هستند، سرعت دانلود را به طور قابل توجهی بهبود بخشد.

چرا از آینه استفاده کنیم؟

  • دانلود سریع‌تر: آینه‌های نزدیک‌تر به شما می‌توانند سرعت دانلود بهتری ارائه دهند
  • قابلیت اطمینان بهبود یافته: آینه‌های جایگزین می‌توانند زمانی که سرورهای رسمی مشکل دارند کمک کنند
  • دور زدن محدودیت‌های شبکه: برخی شبکه‌ها ممکن است محدودیت‌هایی برای دسترسی به دامنه‌های خاص داشته باشند

پیکربندی آینه برای Windows (nvm-windows)

NVM برای Windows دستوراتی برای تنظیم آینه‌ها برای دانلودهای Node.js و npm ارائه می‌دهد.

تنظیم آینه Node.js

bash
nvm node_mirror <url>

مثلاً:

bash
nvm node_mirror https://npmmirror.com/mirrors/node/

تنظیم آینه npm

bash
nvm npm_mirror <url>

مثلاً:

bash
nvm npm_mirror https://npmmirror.com/mirrors/npm/

تأیید تنظیمات آینه

تنظیمات آینه در فایل settings.txt در دایرکتوری نصب NVM شما ذخیره می‌شود، معمولاً در:

C:\Users\<username>\AppData\Roaming\nvm\settings.txt

می‌توانید این فایل را برای تأیید تنظیمات آینه خود بررسی کنید:

root: C:\Users\<username>\AppData\Roaming\nvm
path: C:\Program Files\nodejs
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

پیکربندی آینه برای Linux/macOS (nvm-sh)

برای nvm-sh در Linux و macOS، می‌توانید آینه‌ها را با استفاده از متغیرهای محیطی در فایل پروفایل shell خود تنظیم کنید.

تنظیم آینه Node.js

خط زیر را به فایل پروفایل shell خود (~/.bashrc، ~/.zshrc و غیره) اضافه کنید:

bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

تنظیم آینه npm

خط زیر را به فایل پروفایل shell خود اضافه کنید:

bash
export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

اعمال تغییرات

پس از اضافه کردن این خطوط، تغییرات را اعمال کنید:

bash
source ~/.bashrc  # یا ~/.zshrc و غیره

آینه‌های توصیه شده

در اینجا برخی از آینه‌های محبوب که می‌توانید استفاده کنید آمده است:

آینه‌های جهانی

  • Node.js رسمی: https://nodejs.org/dist
  • npm رسمی: https://registry.npmjs.org

آینه‌های منطقه چین

  • npmmirror (قبلاً CNPM):

    • Node.js: https://npmmirror.com/mirrors/node/
    • npm: https://npmmirror.com/mirrors/npm/
  • Tencent Cloud:

    • Node.js: https://mirrors.cloud.tencent.com/nodejs-release/
  • Huawei Cloud:

    • Node.js: https://repo.huaweicloud.com/nodejs/
    • npm: https://repo.huaweicloud.com/repository/npm/

آینه‌های منطقه اروپا

  • NodeSource:
    • Node.js: https://deb.nodesource.com/node/

استفاده موقت از آینه

اگر می‌خواهید فقط برای یک نصب از آینه استفاده کنید بدون تغییر پیکربندی:

برای nvm-sh (Linux/macOS)

bash
NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node nvm install 18.16.0

عیب‌یابی مشکلات آینه

تایم‌اوت اتصال آینه

اگر هنگام اتصال به آینه تایم‌اوت تجربه کردید:

  1. اتصال اینترنت خود را بررسی کنید
  2. یک آینه دیگر را امتحان کنید
  3. تأیید کنید که URL آینه صحیح و به‌روز است

URL آینه نامعتبر

اگر NVM یک URL آینه نامعتبر گزارش داد:

  1. مطمئن شوید که URL در صورت نیاز با یک اسلش (/) به پایان می‌رسد
  2. فرمت URL را تأیید کنید (باید http:// یا https:// باشد)
  3. بررسی کنید که آیا آینه هنوز فعال است

مشکلات همگام‌سازی آینه

آینه‌ها ممکن است بلافاصله با مخازن رسمی همگام‌سازی نشوند. اگر نمی‌توانید یک نسخه بسیار جدید Node.js پیدا کنید:

  1. سعی کنید از مخزن رسمی Node.js استفاده کنید
  2. چند ساعت صبر کنید تا آینه همگام‌سازی شود
  3. یک آینه دیگر را امتحان کنید که ممکن است بیشتر به‌روز شود

بازگرداندن آینه‌های پیش‌فرض

Windows (nvm-windows)

برای بازگرداندن آینه‌های پیش‌فرض، آن‌ها را به URL‌های رسمی برگردانید:

bash
nvm node_mirror https://nodejs.org/dist/
nvm npm_mirror https://github.com/npm/cli/archive/

Linux/macOS (nvm-sh)

برای بازگرداندن آینه‌های پیش‌فرض، متغیرهای محیطی را از فایل پروفایل shell خود حذف کنید و دوباره source کنید:

bash
# این خطوط را از ~/.bashrc یا ~/.zshrc خود حذف کنید
# export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

# سپس فایل پروفایل خود را source کنید
source ~/.bashrc  # یا ~/.zshrc و غیره

مراحل بعدی

پس از پیکربندی آینه‌ها، می‌توانید ادامه دهید:

NVM - مدیر نسخه Node برای Windows، Linux و macOS