logo

Hướng dẫn tăng tốc truy cập khu vực APAC

Trong môi trường mạng khu vực APAC, việc tải gói Node.js, Git từ nguồn chính thức cũng như cài đặt phụ thuộc qua npm/Homebrew thường chậm, thậm chí bị timeout. Bài viết này giới thiệu cách dùng các nguồn mirror trong khu vực APAC để tăng tốc quá trình cài đặt và sử dụng các công cụ này.

Cài đặt Node.js

Windows

Khuyến nghị tải bộ cài Node.js từ mirror của Đại học Thanh Hoa:

  1. Truy cập Node.js mirror của Đại học Thanh Hoa
  2. Tải bộ cài node-v24.0.0-x64.msi
  3. Nhấp đúp để cài đặt, có thể giữ nguyên mặc định

Hoặc truy cập trực tiếp trang chủ Node.js, rồi chọn phiên bản LTS ở bên trái để tải.

Sau khi cài xong, mở dòng lệnh để kiểm tra:

node -v
npm -v

macOS

Khuyến nghị cài bằng Homebrew (cấu hình mirror Homebrew xem ở phần dưới):

brew install node

Hoặc dùng nvm để quản lý nhiều phiên bản:

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

Cài đặt Git

Windows

Khuyến nghị tải từ mirror của Đại học Thanh Hoa:

  1. Tải Git-2.53.0.3-64-bit.exe（mirror Thanh Hoa）
  2. Nhấp đúp để cài đặt, giữ nguyên các tùy chọn mặc định

Sau khi cài xong, kiểm tra:

git --version

macOS

macOS có sẵn Git, hoặc bạn cũng có thể cài bản mới nhất qua Homebrew:

brew install git

Linux (Debian/Ubuntu)

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

Cấu hình mirror Tencent Cloud cho npm

Mặc định npm tải gói từ registry.npmjs.org, nên ở khu vực APAC thường chậm. Chuyển sang mirror Tencent Cloud có thể tăng tốc rõ rệt.

Đặt mirror toàn cục

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

Kiểm tra cấu hình

npm config get registry

Kết quả nên hiển thị: https://mirrors.cloud.tencent.com/npm/

Dùng tạm thời (không đổi cấu hình toàn cục)

Thêm tham số --registry vào lệnh cài đặt:

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

Khôi phục nguồn chính thức

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

Tăng tốc Homebrew trên macOS

Mặc định Homebrew tải từ GitHub, nên ở khu vực APAC thường chậm. Khuyến nghị dùng mirror của Đại học Thanh Hoa.

Thiết lập mirror Homebrew

Thêm nội dung sau vào ~/.zshrc:

{
    echo ''
    echo '# Homebrew mirror Thanh Hoa'
    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

Áp dụng cấu hình:

source ~/.zshrc

Kiểm tra

brew update

Nếu tốc độ cập nhật nhanh hơn rõ rệt, nghĩa là mirror đã có hiệu lực.

Cài đặt Homebrew lần đầu

Nếu chưa cài Homebrew, bạn có thể dùng mirror Thanh Hoa để tăng tốc cài đặt:

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

Khôi phục nguồn chính thức

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

Tăng tốc mirror pip (tuỳ chọn)

Nếu bạn dùng Python SDK, khuyến nghị cấu hình mirror Tencent Cloud cho pip:

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

Tăng tốc Git Clone (tuỳ chọn)

Với các repository trên GitHub, bạn có thể dùng mirror để clone nhanh hơn:

# Dùng GitHub proxy
git clone https://gh.llkk.cc/https://github.com/用户名/仓库名.git

Địa chỉ tăng tốc lấy từ GitHub Proxy bên thứ ba; vui lòng xác nhận tên dự án và số phiên bản khớp với địa chỉ GitHub chính thức ở trên.

SmallPhone
Hướng dẫn cấu hình Claude Code