Dans les environnements réseau APAC, le téléchargement direct des packages Node.js, Git et l'installation des dépendances via npm/Homebrew depuis les sources officielles peut être lent ou expirer. Cet article explique comment utiliser les miroirs APAC pour accélérer l'installation et l'utilisation de ces outils.
Installer Node.js
Windows
Nous recommandons de télécharger l'installateur Node.js depuis le miroir de l'Université Tsinghua :
- Visitez le Miroir Node.js de l'Université Tsinghua
- Téléchargez le package d'installation
node-v24.0.0-x64.msi - Double-cliquez pour exécuter l'installation et conservez les paramètres par défaut
Ou visitez le site officiel Node.js et sélectionnez la version LTS à gauche.
Après l'installation, ouvrez une ligne de commande pour vérifier :
node -v
npm -v
macOS
Nous recommandons l'installation via Homebrew (voir la configuration du miroir Homebrew ci-dessous) :
brew install node
Ou utilisez nvm pour gérer plusieurs versions :
curl -o- https://github.com/nvm-sh/nvm/raw/main/install.sh | bash
source ~/.zshrc
nvm install --lts
Linux
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
Installer Git
Windows
Nous recommandons de télécharger depuis le miroir de l'Université Tsinghua :
- Téléchargez Git-2.53.0.3-64-bit.exe (miroir Tsinghua)
- Double-cliquez pour installer et conservez les options par défaut
Après l'installation, vérifiez :
git --version
macOS
macOS est livré avec Git préinstallé. Vous pouvez également installer la dernière version via Homebrew :
brew install git
Linux (Debian/Ubuntu)
sudo apt-get update
sudo apt-get install -y git
Configurer le miroir npm Tencent Cloud
Par défaut, npm télécharge les packages depuis registry.npmjs.org, ce qui peut être lent dans la région APAC. Passer au miroir Tencent Cloud peut améliorer considérablement la vitesse.
Définir le miroir globalement
npm config set registry https://mirrors.cloud.tencent.com/npm/
Vérifier la configuration
npm config get registry
Il devrait afficher : https://mirrors.cloud.tencent.com/npm/
Utilisation temporaire (sans modifier la config globale)
Ajoutez le paramètre --registry à la commande d'installation :
npm install -g @anthropic-ai/claude-code --registry https://mirrors.cloud.tencent.com/npm/
Restaurer la source officielle
npm config set registry https://registry.npmjs.org/
Accélération du miroir macOS Homebrew
Homebrew tire depuis GitHub par défaut, ce qui peut être lent dans la région APAC. Nous recommandons d'utiliser le miroir de l'Université Tsinghua.
Définir le miroir Homebrew
Ajoutez ce qui suit à ~/.zshrc :
{
echo ''
echo '# Miroir Tsinghua Homebrew'
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"'
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"'
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"'
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"'
echo 'export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"'
} >> ~/.zshrc
Appliquez la configuration :
source ~/.zshrc
Vérifier
brew update
Si la vitesse de mise à jour est nettement plus rapide, le miroir est actif.
Première installation de Homebrew
Si Homebrew n'est pas encore installé, vous pouvez utiliser le miroir Tsinghua pour accélérer l'installation :
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install/raw/HEAD/install.sh)"
Restaurer la source officielle
unset HOMEBREW_API_DOMAIN
unset HOMEBREW_BOTTLE_DOMAIN
unset HOMEBREW_BREW_GIT_REMOTE
unset HOMEBREW_CORE_GIT_REMOTE
unset HOMEBREW_PIP_INDEX_URL
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
Accélération du miroir pip (Optionnel)
Si vous utilisez le SDK Python, nous recommandons de configurer le miroir pip Tencent Cloud :
pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
Accélération Git Clone (Optionnel)
Pour les dépôts sur GitHub, vous pouvez utiliser un miroir pour accélérer le clonage :
# Utiliser le proxy GitHub
git clone https://gh.llkk.cc/https://github.com/nom-utilisateur/depot.git
L'adresse d'accélération provient d'un proxy GitHub tiers. Veuillez confirmer que le nom du projet et la version correspondent.