症状:ブラウザは速いのに npm/pnpm だけ固まる
Clash や Mihomo 系クライアントを起動し、海外サイトはブラウザから問題なく開ける状態でも、ターミナルで npm install や pnpm install を実行すると、解決中のメッセージが長く止まったままになる。あるいは特定スコープのパッケージやバージョンだけがタイムアウトする——この記事は、その典型パターンに的を絞ります。Python 向けの pip・conda と PyPI の記事と対になる、JavaScript 系パッケージマネージャの経路設計です。
表示される症状は似ていても、背後では「レジストリからメタデータを読んだあと tarball を別の CDN から引いている」「企業プロキシの内側でミラーのみ許可されている」「git+https 依存で GitHub へ二本目の接続が必要」など、段階が積み重なっていることが多いです。まずはどのホストへ、どの順で触れているかを意識する地図を置き、そのうえで Clash の policy 分流と端末側のプロキシ設定を揃えます。
取得チェーン:npm registry、tarball、ミラー、GitHub
npm(既定の公開レジストリ)では、パッケージ名とバージョンの解決のために registry.npmjs.org へアクセスし、多くの場合 tarball(.tgz)の実体も同系のレジストリ応答から取得します。一方で、組織が Verdaccio や Artifactory、公開ミラー(例:国内向けの registry.npmmirror.com 系)を指していると、インデックス用のホストと実ファイルのホストがログ上で分かれて現れます。どちらを DIRECT にし、どちらを海外ノードに流すかがズレると、「一覧は出るのにダウンロードだけ失敗」という見え方になります。
pnpmはデフォルトでも同じレジストリ前提ですが、グローバルストアとハードリンク/コピー戦略のおかげで一度取得した tarball の再利用は効きます。とはいえ、初回のフェッチやロックファイルの更新時には npm と同様にレジストリと tarball 経路に依存します。.npmrc の registry=、スコープごとの @scope:registry=、認証付きプライベートレジストリ行が混ざっていると、スコープ単位で通るホストが変わるため、ルールもホスト単位で分けたほうが安全です。
リポジトリ依存(git+https://github.com/...)や、GitHub Releases からバイナリを取る postinstall では、github.com に加えて codeload.github.com や objects.githubusercontent.com などが別ホストとして現れます。ブラウザでは GitHub の Web だけ見ていても、CLI はオブジェクトストレージ側へ直行するため、ルールセットで取りこぼしやすい点に注意してください。
ルールの読み方や購読ルールの順序設計は、ルールプロバイダ解説と併読すると、RULE-SET と手書きの DOMAIN-SUFFIX をどこに挿すかがつながります。
分流の考え方:レジストリ・tarball CDN・ミラーを解耦する
方針は pip 稿と同型です。意図的に国内ミラーや社内キャッシュへ寄せたいトラフィックは、広い GEOIP や雑な DOMAIN-KEYWORD より前に、明示的な DOMAIN-SUFFIX で DIRECT(または専用 policy)へ固定する。npm 本家や GitHub オブジェクト、ミラーがカバーしないホストは、遅延と帯域を見ながら別の policy に載せる——この二段構えです。
よくある失敗は、DOMAIN-SUFFIX,npmjs,... のような広い行が先にマッチして tarball まで意図しない出口へ流れること、逆に GEOIP,CN,DIRECT が強すぎてレジストリだけ海外・ tarball だけ国内のような中途半端な分割を壊すことです。実務では、Clash の接続ログに出たホスト名をそのままルールへ昇格する反復が最も確実です。
環境変数に頼らずアプリ全体をトンネルで包むなら TUN も選択肢です。挙動の整理はTUN モードガイドを参照してください。
ルール記述の例(プロファイル断片)
実際の proxy-groups 名・購読ノード名は手元の設定に合わせて置き換えてください。以下は説明用です(コメントは英語のみ)。
# Pin npm registry and tarball-style hosts BEFORE broad GEOIP / KEYWORD rules
DOMAIN-SUFFIX,registry.npmjs.org,NPM_REGISTRY
DOMAIN-SUFFIX,npmjs.org,NPM_REGISTRY
# Common mirror (example — use DIRECT if you intentionally mirror locally)
# DOMAIN-SUFFIX,npmmirror.com,NPM_MIRROR_DIRECT
# DOMAIN-SUFFIX,registry.npmmirror.com,NPM_MIRROR_DIRECT
DOMAIN-SUFFIX,github.com,GITHUB_WEB
DOMAIN-SUFFIX,githubusercontent.com,GITHUB_OBJ
DOMAIN-SUFFIX,codeload.github.com,GITHUB_CODE
# Widen only after you see these in logs during failed installs
# DOMAIN-SUFFIX,objects.githubusercontent.com,GITHUB_OBJ
NPM_REGISTRY を一本化するか、メタデータ用と tarball 用に分けるかはノード品質次第です。ログでセグメント取得の遅延が特定サフィックスに集中するなら分離を検討し、どちらも同程度なら同じ policy で問題ありません。評価は上から順に行われるため、購読ルールの直後に「自分用のピン留め」を差し込む運用も有効です。
.npmrc とレジストリ設定の確認
プロジェクト直下の .npmrc、ユーザー主場の ~/.npmrc、環境変数 NPM_CONFIG_REGISTRY は読み込み順が絡みます。npm config list -l や pnpm config get registry で実際に効いている値を確定させてから Clash 側を触ると、ミラーと本家の取り違えが減ります。CI では .npmrc がリポジトリにコミットされていてローカルと違う、という場合もあるため、install を実行したディレクトリで設定を確認してください。
認証トークンを含むプライベートレジストリを使う場合、TLS インタセプトと相性の悪い企業プロキシでは「接続はするが証明書で落ちる」パターンも出ます。エラーメッセージが ECONNRESET/ETIMEDOUT 系か UNABLE_TO_VERIFY_LEAF_SIGNATURE 系かを分けると、次に直すべきがネットワーク経路か証明書ストアかがはっきりします。
ターミナルがプロキシを踏んでいるか
macOS や Linux では GUI のシステムプロキシとシェルの http_proxy/HTTPS_PROXY は別物です。npm/pnpm は環境変数と設定の両方を解釈するため、ブラウザだけプロキシを知っている状態が起きがちです。手元のシェルでの確認手順はmacOS 向けターミナル・プロキシ診断が流用しやすいです。Windows では WSL2 とホスト側 Clash のポート転送が絡むため、WSL2 稿とあわせて 127.0.0.1 の指し先を揃えてください。
# Same shell you use for npm / pnpm
echo "$HTTP_PROXY" "$HTTPS_PROXY" "$http_proxy" "$https_proxy"
npm config get proxy
npm config get https-proxy
pnpm config get http-proxy
IDE 内蔵ターミナルと外部ターミナルで変数が異なる場合もあるため、失敗した install を起動したプロセスの環境を疑うのがコツです。
検証:ログと curl でホストを確定する
Clash のログまたはダッシュボードの接続一覧で、詰まっている行のターゲットホストをメモします。同じ URL へシェルから curl -I を打ち、プロキシ環境変数の有無で応答が変わるかを見ると、「ルール順の問題か、CLI がプロキシを見ていないか」が切り分けられます。DNS が fake-ip のときは、ドメインルールと名前解決の相互作用に注意してください。
pnpm install は進行ログが読みやすいので、どのパッケージの取得で止まったかを特定しやすいです。そこからリポジトリの tarball URL や Git 依存へ辿ると、次に追加すべき DOMAIN-SUFFIX が決まります。
DIRECT 設計を優先してください。セキュリティ要件と開発体験のトレードオフは現場ごとに異なります。オープンソースとドキュメント
コアの挙動や設定キーは、利用中の実装(Mihomo など)の公式ドキュメントやGitHub リポジトリで確認できます。クライアントの入手と更新は当サイトのダウンロードページを第一導線にし、GitHub は仕様確認・Issue 参照に使い分けると手順の取り違えが減ります。画面操作の流れはドキュメント/チュートリアルも参照してください。
まとめ
npm/pnpm の registry 周りの停滞は、「Clash が壊れている」よりレジストリ・tarball・ミラー・GitHub をホスト単位で分流できているかとCLI が同じ出口を見ているかを疑ったほうが早いことが多いです。ログに出た名前をルールへ反映し、.npmrc の実効レジストリと矛盾がないかを見直す——この流れは 2026 年現在も Node.js 開発環境で繰り返し効くチェックリストです。
同種のツールのなかでも、Clash/Mihomo 系は policy グループと接続ログが追いやすく、CDN やミラーの試行錯誤に向いています。ノードとルールを手元で揃え、クライアントを最新に保てば、大規模な node_modules の取得も安定しやすくなります。