Configuration des miroirs pour NVM

Lorsque vous utilisez NVM pour installer Node.js, vous pouvez rencontrer des vitesses de téléchargement lentes, en particulier dans certaines régions géographiques. La configuration de miroirs peut améliorer considérablement les vitesses de téléchargement en utilisant des serveurs plus proches de votre emplacement.

Pourquoi utiliser des miroirs ?

• Téléchargements plus rapides : Les miroirs situés plus près de vous peuvent offrir de meilleures vitesses de téléchargement
• Fiabilité améliorée : Les miroirs alternatifs peuvent aider lorsque les serveurs officiels rencontrent des problèmes
• Contourner les restrictions réseau : Certains réseaux peuvent avoir des restrictions d'accès à certains domaines

Configuration des miroirs pour Windows (nvm-windows)

NVM pour Windows fournit des commandes pour définir des miroirs pour les téléchargements de Node.js et npm.

Configuration du miroir Node.js

nvm node_mirror <url>

Par exemple :

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

Configuration du miroir npm

nvm npm_mirror <url>

Par exemple :

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

Vérification des paramètres de miroir

Les paramètres de miroir sont stockés dans le fichier settings.txt dans votre répertoire d'installation NVM, généralement à :

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

Vous pouvez vérifier ce fichier pour confirmer vos paramètres de miroir :

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/

Configuration des miroirs pour Linux/macOS (nvm-sh)

Pour nvm-sh sur Linux et macOS, vous pouvez définir des miroirs en utilisant des variables d'environnement dans votre fichier de profil shell.

Configuration du miroir Node.js

Ajoutez la ligne suivante à votre fichier de profil shell (~/.bashrc, ~/.zshrc, etc.) :

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

Configuration du miroir npm

Ajoutez la ligne suivante à votre fichier de profil shell :

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

Application des modifications

Après avoir ajouté ces lignes, appliquez les modifications :

source ~/.bashrc  # ou ~/.zshrc, etc.

Miroirs recommandés

Voici quelques miroirs populaires que vous pouvez utiliser :

Miroirs globaux

• Node.js officiel : https://nodejs.org/dist
• npm officiel : https://registry.npmjs.org

Miroirs pour la région Chine

• npmmirror (anciennement 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/

Miroirs pour la région Europe

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

Utilisation temporaire d'un miroir

Si vous souhaitez utiliser un miroir uniquement pour une installation ponctuelle sans modifier votre configuration :

Pour nvm-sh (Linux/macOS)

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

Résolution des problèmes liés aux miroirs

Délai de connexion au miroir

Si vous rencontrez des délais d'attente lors de la connexion à un miroir :

1. Vérifiez votre connexion Internet
2. Essayez un miroir différent
3. Vérifiez que l'URL du miroir est correcte et à jour

URL de miroir invalide

Si NVM signale une URL de miroir invalide :

1. Assurez-vous que l'URL se termine par une barre oblique (/) si nécessaire
2. Vérifiez le format de l'URL (doit être http:// ou https://)
3. Vérifiez si le miroir est toujours opérationnel

Problèmes de synchronisation des miroirs

Les miroirs peuvent ne pas être immédiatement synchronisés avec les dépôts officiels. Si vous ne trouvez pas une version très récente de Node.js :

1. Essayez d'utiliser le dépôt officiel de Node.js
2. Attendez quelques heures pour que le miroir se synchronise
3. Essayez un miroir différent qui pourrait être mis à jour plus fréquemment

Restauration des miroirs par défaut

Windows (nvm-windows)

Pour restaurer les miroirs par défaut, définissez-les à nouveau sur les URL officielles :

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

Linux/macOS (nvm-sh)

Pour restaurer les miroirs par défaut, supprimez les variables d'environnement de votre fichier de profil shell et sourcez-le à nouveau :

# Supprimez ces lignes de votre ~/.bashrc ou ~/.zshrc
# export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

# Puis sourcez votre fichier de profil
source ~/.bashrc  # ou ~/.zshrc, etc.

Prochaines étapes

Après avoir configuré les miroirs, vous pouvez procéder à :

• Installer des versions de Node.js avec des vitesses de téléchargement améliorées
• En savoir plus sur l'utilisation de NVM
• Consulter la FAQ pour les questions et problèmes courants