Руководство по ускорению APAC

В сетевых средах APAC прямое скачивание пакетов Node.js, Git и установка зависимостей через npm/Homebrew из официальных источников может быть медленным или превышать время ожидания. В этой статье объясняется, как использовать зеркала APAC для ускорения установки и использования этих инструментов.

Установка Node.js

Windows

Рекомендуется скачивать установщик Node.js с зеркала Университета Цинхуа:

Посетите Зеркало Node.js Университета Цинхуа
Скачайте установщик node-v24.0.0-x64.msi
Дважды щелкните для запуска установки и оставьте настройки по умолчанию

Или посетите официальный сайт Node.js и выберите версию LTS слева.

После установки откройте командную строку для проверки:

node -v
npm -v

macOS

Рекомендуется установка через Homebrew (см. настройку зеркала Homebrew ниже):

brew install node

Или используйте nvm для управления несколькими версиями:

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

Установка Git

Windows

Рекомендуется скачивание с зеркала Университета Цинхуа:

Скачайте Git-2.53.0.3-64-bit.exe (зеркало Цинхуа)
Дважды щелкните для установки и оставьте параметры по умолчанию

После установки проверьте:

git --version

macOS

macOS поставляется с предустановленным Git. Вы также можете установить последнюю версию через Homebrew:

brew install git

Linux (Debian/Ubuntu)

sudo apt-get update
sudo apt-get install -y git

Настройка зеркала npm Tencent Cloud

По умолчанию npm скачивает пакеты с registry.npmjs.org, что может быть медленным в регионе APAC. Переключение на зеркало Tencent Cloud может значительно повысить скорость.

Установить зеркало глобально

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

Проверить конфигурацию

npm config get registry

Должно отображаться: https://mirrors.cloud.tencent.com/npm/

Временное использование (без изменения глобальной конфигурации)

Добавьте параметр --registry к команде установки:

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

Восстановить официальный источник

npm config set registry https://registry.npmjs.org/

Ускорение зеркала macOS Homebrew

Homebrew по умолчанию загружает с GitHub, что может быть медленным в регионе APAC. Рекомендуется использовать зеркало Университета Цинхуа.

Установить зеркало Homebrew

Добавьте следующее в ~/.zshrc:

{
echo ''
echo '# Зеркало 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

Примените конфигурацию:

source ~/.zshrc

Проверить

brew update

Если скорость обновления заметно увеличилась, зеркало активно.

Первая установка Homebrew

Если Homebrew еще не установлен, вы можете использовать зеркало Цинхуа для ускорения установки:

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)"

Восстановить официальный источник

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

Ускорение зеркала pip (Опционально)

Если вы используете Python SDK, рекомендуется настроить зеркало pip Tencent Cloud:

pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple

Ускорение Git Clone (Опционально)

Для репозиториев на GitHub вы можете использовать зеркало для ускорения клонирования:

# Использовать прокси GitHub
git clone https://gh.llkk.cc/https://github.com/имя-пользователя/репозиторий.git

Адрес ускорения предоставлен сторонним прокси GitHub. Пожалуйста, подтвердите, что имя проекта и версия совпадают.