亚太地区加速访问教程

在亚太地区，直接访问官方源安装 Node.js、Git、npm 包或 Homebrew 依赖时，常见问题是慢、卡顿、超时。
这篇文档把常用的镜像和配置方法整理在一起，适合本地开发机、个人电脑和日常环境。

INFO

下面的命令主要用于开发环境。生产机器如果已经有统一镜像策略，建议优先遵循内部规范。

适用范围

场景	推荐做法
Windows	用镜像站下载安装包
macOS	用 Homebrew 或 nvm 管理
Linux	用发行版包管理器或 NodeSource
npm	切到腾讯云镜像
Homebrew	切到清华镜像
pip	切到腾讯云镜像
Git clone	临时使用代理镜像

安装 Node.js

Windows

推荐先去清华大学镜像站下载 Windows 安装包。

• 打开 清华大学 Node.js 镜像
• 下载 node-v24.0.0-x64.msi
• 双击安装，一路默认即可

也可以直接访问 Node.js 官网 选择 LTS 版本。

安装完成后，打开命令行验证：

node -v
npm -v

macOS

推荐使用 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 腾讯云镜像

npm 默认从 registry.npmjs.org 拉包，亚太地区可能较慢。切换到腾讯云镜像后通常会更稳定。

全局设置

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 拉取，亚太地区常会比较慢。可以切到清华镜像。

写入 shell 配置

将下面内容追加到 ~/.zshrc：

{
echo ''
echo '# 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 config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple

Git Clone 加速

对于 GitHub 仓库，可以临时通过代理镜像拉取：

git clone https://gh.llkk.cc/https://github.com/用户名/仓库名.git

WARNING

这是第三方代理地址。请确认仓库名称和版本号一致，必要时再回到官方 GitHub 地址。

常见检查

看看镜像有没有生效

npm config get registry
brew update
git --version
node -v

一句话总结

工具	推荐镜像
Node.js	清华大学镜像站
npm	腾讯云镜像
Homebrew	清华大学镜像
pip	腾讯云镜像
GitHub clone	第三方代理，仅临时使用