Gestion des Téléchargements fnm

fnm fournit des options de configuration de téléchargement flexibles pour vous aider à obtenir rapidement les versions de Node.js.

Téléchargement de Base

Commande d'Installation

# Installer la dernière LTS
fnm install --lts

# Installer une version spécifique
fnm install 20

# Installer la dernière version
fnm install --latest

Progression du Téléchargement

fnm affiche une barre de progression de téléchargement par défaut:

# Affichage automatique (défaut)
fnm install 20 --progress=auto

# Toujours afficher
fnm install 20 --progress=always

# Ne jamais afficher
fnm install 20 --progress=never

Configuration des Mirrors

Pourquoi Vous Avez Besoin d'un Mirror

La source de téléchargement officielle de Node.js est située à l'étranger et les téléchargements peuvent être lents en Chine continentale. Configurer un mirror peut améliorer considérablement la vitesse de téléchargement.

Méthodes de Configuration

Méthode 1: Variable d'Environnement

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

Méthode 2: Paramètre en Ligne de Commande

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

Méthode 3: Configuration du Shell

# Ajouter au fichier de configuration du Shell
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Sources de Mirrors Courantes

Source de Mirror	URL	Description
Node.js Officiel	https://nodejs.org/dist	Défaut
npmmirror	https://npmmirror.com/mirrors/node	Recommandé
Université de Tsinghua	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	Optimisé pour le réseau éducatif
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	Niveau entreprise

Configuration Spécifique à la Plateforme

Linux / macOS

# Ajouter à ~/.bashrc ou ~/.zshrc
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Windows PowerShell

# Définir la variable d'environnement utilisateur
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

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

Répertoire de Téléchargement

Répertoire Par Défaut

fnm télécharge et installe Node.js dans:

~/.fnm/
├── fnm                 # Binaire fnm
├── node-versions/      # Répertoire des versions Node.js
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # Configuration des alias

Répertoire Personnalisé

Personnaliser via la variable d'environnement FNM_DIR:

export FNM_DIR=/custom/path/.fnm

Installation Hors Ligne

Pré-télécharger les Versions

Pré-télécharger dans un environnement réseau:

fnm install 20
fnm install 18
fnm install 16

Copier vers un Environnement Hors Ligne

Copier le répertoire ~/.fnm vers l'environnement hors ligne:

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

# Extraire dans l'environnement hors ligne
tar -xzvf fnm-backup.tar.gz -C ~/

Installation Manuelle

1. Télécharger l'archive Node.js depuis un mirror
2. Extraire dans le répertoire fnm:

# Télécharger
wget https://npmmirror.com/mirrors/node/v20.10.0/node-v20.10.0-linux-x64.tar.gz

# Extraire dans le répertoire fnm
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

Sélection de l'Architecture

Afficher l'Architecture Actuelle

fnm current
# La sortie inclut les informations d'architecture

Installer une Architecture Différente

# Installer la version x64
fnm install 20 --arch=x64

# Installer la version ARM64
fnm install 20 --arch=arm64

Paramètre de Variable d'Environnement

export FNM_ARCH=x64
fnm install 20

Dépannage des Téléchargements

Échec du Téléchargement

# Essayer d'utiliser un mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# Vérifier la connexion réseau
curl -I https://nodejs.org/dist/

# Voir les logs détaillés
fnm install 20 --log-level=info

Téléchargement Lent

1. Configurer un mirror national
2. Vérifier les paramètres de proxy réseau
3. Utiliser la méthode d'installation hors ligne

Échec de la Somme de Contrôle

# Effacer le cache et retélécharger
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

Liens Connexes

• Installer Node.js - Guide d'installation
• Gestion de Version - Gestion de version
• Référence des Commandes - Tous les détails des commandes