إدارة التنزيل في fnm

يوفر fnm خيارات تكوين مرنة لمساعدتك في الحصول على إصدارات Node.js بسرعة.

التنزيل الأساسي

أمر التثبيت

# Install latest LTS
fnm install --lts

# Install specific version
fnm install 20

# Install latest version
fnm install --latest

تقدم التنزيل

يعرض fnm شريط تقدم التنزيل افتراضياً:

# Auto display (default)
fnm install 20 --progress=auto

# Always display
fnm install 20 --progress=always

# Never display
fnm install 20 --progress=never

تكوين المرآة

لماذا تحتاج إلى مرآة

مصدر التنزيل الرسمي لـ Node.js موجود في الخارج، وقد تكون التنزيلات بطيئة في البر الرئيسي للصين. يمكن لتكوين مرآة أن يحسن سرعة التنزيل بشكل كبير.

طرق التكوين

الطريقة 1: متغير البيئة

export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

الطريقة 2: معامل سطر الأوامر

fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

الطريقة 3: تكوين الصدفة

# Add to Shell configuration file
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

مصادر المرآة الشائعة

مصدر المرآة	URL	الوصف
Node.js الرسمي	https://nodejs.org/dist	المصدر الافتراضي
npmmirror	https://npmmirror.com/mirrors/node	موصى به
جامعة تسينغهوا	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	محسّن لشبكة التعليم
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	درجة المؤسسات

التكوين حسب المنصة

Linux / macOS

# Add to ~/.bashrc or ~/.zshrc
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Windows PowerShell

# Set user environment variable
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

setx FNM_NODE_DIST_MIRROR "https://npmmirror.com/mirrors/node"

دليل التنزيل

الدليل الافتراضي

يقوم fnم بتنزيل وتثبيت Node.js في:

~/.fnm/
├── fnm                 # fnm binary
├── node-versions/      # Node.js versions directory
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # Alias configuration

دليل مخصص

تخصيص عبر متغير البيئة FNM_DIR:

export FNM_DIR=/custom/path/.fnm

التثبيت دون اتصال

تنزيل الإصدارات مسبقاً

قم بالتنزيل المسبق في بيئة شبكية:

fnm install 20
fnm install 18
fnm install 16

النسخ إلى بيئة دون اتصال

انسخ دليل ~/.fnm إلى البيئة دون الاتصال:

# Package
tar -czvf fnm-backup.tar.gz ~/.fnm

# Extract in offline environment
tar -xzvf fnm-backup.tar.gz -C ~/

التثبيت اليدوي

1. قم بتنزيل أرشيف Node.js من المرآة
2. قم باستخراج إلى دليل fnm:

# Download
wget https://npmmirror.com/mirrors/node/v20.10.0/node-v20.10.0-linux-x64.tar.gz

# Extract to fnm directory
mkdir -p ~/.fnm/node-versions/v20.10.0/installation
tar -xzf node-v20.10.0-linux-x64.tar.gz -C ~/.fnm/node-versions/v20.10.0/installation --strip-components=1

اختيار البنية

عرض البنية الحالية

fnm current
# Output includes architecture information

تثبيت بنية مختلفة

# Install x64 version
fnm install 20 --arch=x64

# Install ARM64 version
fnm install 20 --arch=arm64

تعيين متغير البيئة

export FNM_ARCH=x64
fnm install 20

استكشاف مشكلات التنزيل وإصلاحها

فشل التنزيل

# Try using mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# Check network connection
curl -I https://nodejs.org/dist/

# View detailed logs
fnm install 20 --log-level=info

التنزيل بطيء

1. قم بتكوين مرآة محلية
2. تحقق من إعدادات وكيل الشبكة
3. استخدم طريقة التثبيت دون اتصال

فشل مجموع التحقق

# Clear cache and re-download
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

روابط ذات صلة

• تثبيت Node.js - دليل التثبيت
• إدارة الإصدارات - إدارة الإصدارات
• مرجع الأوامر - جميع تفاصيل الأوامر