# Tutoriel d'accélération APAC

> Guide pour les utilisateurs APAC sur l'installation de Node.js, Git, la configuration du miroir npm Tencent Cloud et l'accélération du miroir macOS Homebrew.

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 :

1. Visitez le [Miroir Node.js de l'Université Tsinghua](https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/v24.0.0/)
2. Téléchargez le package d'installation `node-v24.0.0-x64.msi`
3. Double-cliquez pour exécuter l'installation et conservez les paramètres par défaut

Ou visitez le [site officiel Node.js](https://nodejs.org/) et sélectionnez la version LTS à gauche.

Après l'installation, ouvrez une ligne de commande pour vérifier :

```bash
node -v
npm -v
```

### macOS

Nous recommandons l'installation via Homebrew (voir la configuration du miroir Homebrew ci-dessous) :

```bash
brew install node
```

Ou utilisez [nvm](https://github.com/nvm-sh/nvm) pour gérer plusieurs versions :

```bash
curl -o- https://github.com/nvm-sh/nvm/raw/main/install.sh | bash
source ~/.zshrc
nvm install --lts
```

### Linux

```bash
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 :

1. Téléchargez [Git-2.53.0.3-64-bit.exe (miroir Tsinghua)](https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/Git-2.53.0.3-64-bit.exe)
3. Double-cliquez pour installer et conservez les options par défaut

Après l'installation, vérifiez :

```bash
git --version
```

### macOS

macOS est livré avec Git préinstallé. Vous pouvez également installer la dernière version via Homebrew :

```bash
brew install git
```

### Linux (Debian/Ubuntu)

```bash
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

```bash
npm config set registry https://mirrors.cloud.tencent.com/npm/
```

### Vérifier la configuration

```bash
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 :

```bash
npm install -g @anthropic-ai/claude-code --registry https://mirrors.cloud.tencent.com/npm/
```

### Restaurer la source officielle

```bash
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` :

```bash
{
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 :

```bash
source ~/.zshrc
```

### Vérifier

```bash
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 :

```bash
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

```bash
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 :

```bash
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 :

```bash
# 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.

Ceci est la version markdown de https://fr.llmoxy.com/docs/code-tutorials/apac-speedup.
