2026年リモートMac 避坑ガイド

1. ネットワーク：海外ノードでは公式源が遅延・タイムアウトしやすいです。2. コスト：CIで毎回フル取得するとビルド時間・クレジットが増えます。3. 安定性：ミラー選定と断点続伝・キャッシュが重要です。

国内・跨境ノードの速度・安定性の目安です。CIは同リージョンのミラー利用を推奨します。

Step 1：Homebrew ミラー（ターミナルで実行）。

export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/git/homebrew-core.git"

Step 2：npm レジストリ・リトライ・タイムアウト。

npm config set registry https://registry.npmmirror.com
npm config set fetch-retries 5
npm config set fetch-timeout 600000

Step 3：CocoaPods の source（Podfile 先頭に記載）。

source 'https://cdn.cocoapods.org/'

Step 4：git で断点続伝的に取得（失敗時は --depth を増やして再実行）。

git fetch --depth=1 --no-tags

Step 5：CI では npm ci と Pods キャッシュの再利用を推奨します。

手順です。

• 1

  Git：git fetch --depth=1 失敗時は --depth=100 で再実行。

• 2

  npm：npm ci で lock に合わせ取得。~/.npm をCIでキャッシュ再利用。

• 3

  CocoaPods：Pods をキャッシュしCIでリストア後 pod install。

• 4

  Homebrew：HOMEBREW_CORE_GIT_REMOTE をミラーにし brew update 再実行。

跨境では all_proxy や npm config set proxy でプロキシを統一。SSH中継で経路を安定化。CIは同リージョンのミラー利用を推奨します。

Q：Homebrew が途中で失敗 → 国内ミラーに切り替え、git fetch の --depth を増やして再実行。

Q：npm がタイムアウト → fetch-retries・fetch-timeout 延長、npmmirror 等。CIでは npm ci とキャッシュ再利用。

Q：pod install が遅い → CDN／git ミラーと Pods キャッシュで短縮。

Macは依存拉取・ミラー・ターミナルで有利です。

CIではiOSビルド・ミラー・キャッシュの面でリモートMacが有利です。