logo

APAC アクセス高速化チュートリアル

APAC 地域のネットワーク環境では、公式ソースから直接 Node.js パッケージ、Git をダウンロードしたり、npm/Homebrew で依存関係をインストールしたりする際に、速度が遅かったりタイムアウトしたりすることがあります。本記事では、APAC 地域のミラーソースを利用してこれらのツールのインストールと使用を高速化する方法を紹介します。

Node.js のインストール

Windows

清華大学ミラーサイトから Node.js インストーラーをダウンロードすることをお勧めします:

  1. 清華大学 Node.js ミラー にアクセス
  2. node-v24.0.0-x64.msi インストーラーをダウンロード
  3. ダブルクリックしてインストールを実行し、デフォルト設定のまま進める

または 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

清華大学ミラーサイトからのダウンロードを推奨:

  1. Git-2.53.0.3-64-bit.exe(清華ミラー) をダウンロード
  2. ダブルクリックしてインストールし、デフォルト設定のまま進める

インストール完了後、確認:

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 からパッケージをダウンロードしますが、APAC 地域ではアクセスが遅い場合があります。騰訊雲ミラーに切り替えることで速度が大幅に向上します。

ミラーをグローバル設定

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 '# 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 騰訊雲ミラーの設定を推奨:

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 Proxy から提供されています。プロジェクト名とバージョンが一致していることを確認してください。