1. npm installが遅い・失敗する典型的な原因
npm installが途中で止まる、数分待っても進まない、ETIMEDOUT、ECONNRESET、fetch failedが表示されるとき、原因をnpmレジストリだけに求めるのは早計です。Clashを起動している環境では、プロキシポートの不一致、ルールによる誤ったDIRECT判定、ノードの応答遅延、DNS解決の不整合が重なり、パッケージ取得だけが不安定になることがあります。
特にブラウザでWebサイトを開けるからといって、npmも同じ経路を使っているとは限りません。ChromeやEdgeはOSのシステムプロキシを自動的に利用できますが、Node.jsは環境変数、npm固有の設定、あるいは何も設定されていない直接接続を使う場合があります。つまり「Clashのプロキシはオンなのに、npmだけ失敗する」という状態は珍しくありません。
もう一つの落とし穴は、npm installが単一のURLだけに接続しているわけではない点です。通常はレジストリのメタデータを取得した後、tarball、依存パッケージ、スコープ付きパッケージ、Gitリポジトリ、GitHub Releasesなど複数のホストへ接続します。レジストリ本体だけをPROXYにしても、実際のアーカイブ配信先がDIRECTのままだと、解決は進むのにダウンロードで止まることがあります。
2. まずClashのポート・モード・ログを確認する
設定を大きく変更する前に、現在のClashがどの状態で動いているかを記録してください。Clash Verge RevやMihomo系クライアントでは、画面上の表示名がバージョンやプロファイルによって異なるため、実際のログとポート番号を基準に判断します。
| 確認項目 | 見る場所 | よくある問題 |
|---|---|---|
| Mixed Port | Clashの一般設定 | 想定した7890や7897と実際のポートが違う |
| 動作モード | Rule/Global/Direct | RuleのMATCHがDIRECTになっている |
| 接続ログ | LogsまたはConnections | registry.npmjs.orgが別経路へ出ている |
| DNS | DNS設定とログ | 名前解決だけ社内DNSやISP側へ流れている |
| 策略グループ | ProxyまたはProxies画面 | 選択中のノードが遅い、期限切れ、応答不能 |
最初に、ClashのMixed Portを確認します。以下では例として7890を使いますが、実際の環境では必ず自分の画面に表示された番号へ置き換えてください。HTTPプロキシとSOCKS5プロキシが別ポートになっている場合、npmでは一般的にHTTP形式のMixed Portを使うほうが確認しやすいです。
次に、Clashの接続ログを表示したまま、別のターミナルでnpm installを一度実行します。registry.npmjs.orgがログに現れるか、その接続が選択した策略グループへ送られているか、再試行が大量に発生していないかを見ます。ログに何も出ない場合は、npmがClashを経由していない可能性が高く、ルールを編集する前にプロキシ注入を確認すべきです。
3. npmへプロキシを設定して動作を切り分ける
npmの設定は、まず一時的なコマンドで試すのが安全です。設定ファイルをいきなり書き換えるのではなく、環境変数を使って一回だけ接続し、Clashのログに通信が現れるかを確かめます。LinuxやmacOSのシェルでは次のように実行します。
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
npm install
Windows PowerShellでは次の形式です。
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
npm install
この状態で成功するなら、npmまたはNode.jsのプロセスがClashを経由していなかったことが分かります。毎回設定するのが面倒な場合は、npmのユーザー設定に登録できます。
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
npm config get proxy
npm config get https-proxy
ただし、社内レジストリやローカル開発サーバーまでプロキシへ送ると、別の障害が起きることがあります。社内ドメイン、localhost、127.0.0.1、プライベートなGitサーバーを使う場合は、環境に応じてNO_PROXYも設定します。
export NO_PROXY=localhost,127.0.0.1,.local,registry.intra.example
設定を解除して比較したいときは、npmの設定値を確認してから削除します。
npm config delete proxy
npm config delete https-proxy
npm config get registry
ここで注意したいのは、認証付きプロキシのURLへパスワードをそのまま書かないことです。シェル履歴、npm設定ファイル、CIログに認証情報が残る場合があります。Clashをローカルで利用するだけなら、まずは認証なしの127.0.0.1ポートで確認し、会社の上流プロキシが必要な場合は、管理者が定めた安全なシークレット管理方法を使ってください。
4. ルール・DNS・ノードを順番に絞り込む
npmのプロキシ設定が正しくても、Clashのルールが期待と違えば通信は安定しません。基本は、実際にログへ現れたドメインだけを対象にし、最初から広いキーワード規則を追加しないことです。概念例としては次のようになります。
rules:
- DOMAIN,registry.npmjs.org,PROXY
- DOMAIN-SUFFIX,npmjs.org,PROXY
- DOMAIN-SUFFIX,npmjs.com,PROXY
- DOMAIN-SUFFIX,github.com,PROXY
- DOMAIN-SUFFIX,githubusercontent.com,PROXY
- DOMAIN,localhost,DIRECT
- GEOIP,JP,DIRECT
- MATCH,DIRECT
ここでPROXYは実際の策略グループ名に置き換えます。購読プロファイルによっては「自動選択」「Proxy」「海外高速」など、異なる名前が使われています。ルールの順番も重要です。GEOIP,JP,DIRECTをnpm関連ルールより上に置くと、国内IPとして判定された接続がプロキシへ行かない可能性があります。まず対象ドメインの行を上に置き、ログで判定結果を確認してください。
DNSも段階的に確認します。Clashのfake-ipを使っている場合、Node.jsが見ている名前、Clashがルール判定に使う名前、最終的なTLS接続のSNIが一致しないと、設定上はPROXYなのに実際の接続がDIRECTへ落ちることがあります。いったんDNS設定を大きく変更するのではなく、同じドメインについて「名前解決に成功するか」「接続ログに出るか」「TLS確立後にリセットされないか」を分けて観察します。
ノードの切り分けでは、速度テストの数値だけでなく、npmのような小さなHTTPS接続を連続して処理できるかを見ます。高速と表示されるノードでも、TLSハンドシェイクやCDNの長い接続で頻繁に切れることがあります。現在のノードを固定して再試行し、次に別ノードへ変更して同じコマンドを実行すると、設定問題と出口品質を分離しやすくなります。
5. エラーメッセージから追加確認する
ETIMEDOUTは接続先へ時間内に到達できない場合に出やすく、プロキシ未設定、ノードの応答遅延、DNSの失敗が候補になります。ECONNRESETは接続途中で相手または中継が切断した状態で、ノード交換、TLS検査、アイドルタイムアウトを疑います。EAI_AGAINは名前解決の一時的な失敗であることが多く、DNS経路を確認します。
一方、401や403はネットワーク到達後の認証・権限問題で、単にプロキシを強くすれば解決するとは限りません。プライベートパッケージを使う場合は、.npmrcのレジストリ設定とトークンの有効性を確認してください。404ならパッケージ名やバージョン、レジストリの向き先が間違っている可能性があります。
また、npmのキャッシュを最初から削除するのはおすすめしません。キャッシュ破損が疑われる場合は、まずnpm cache verifyを実行し、ネットワーク設定を直した後も同じパッケージだけ失敗するかを確認します。Node.jsやnpmのバージョン差、lockfileの状態、optional dependencyのプラットフォーム差も、ネットワーク障害に見えることがあります。
6. 再発を防ぐ実務的なチェック手順
今後同じ問題が起きたときは、次の順番に固定すると原因を追いやすくなります。第一にClashのプロファイルとMixed Portを確認し、第二にnpmのregistryとプロキシ設定を表示します。第三に環境変数を一時設定した小さなテストを行い、第四に接続ログで対象ドメインと策略グループを照合します。最後にノードを一つだけ変更し、結果を比較してください。
- Clashのアクティブプロファイル、モード、Mixed Portを記録する。
npm config get registryで利用中のレジストリを確認する。HTTP_PROXYとHTTPS_PROXYを一時設定して短いテストを実行する。- ログで
registry.npmjs.orgやtarball配信先の判定を確認する。 - ルールを一行ずつ追加し、ノード変更は最後に一つだけ行う。
この手順の利点は、設定を一度に変えないことです。ポート、ルール、DNS、ノードを同時に変更すると、成功しても何が効いたのか分からず、再発時に戻せません。チームやCIで使う場合は、使用するレジストリ、プロキシの注入方法、NO_PROXYの対象をREADMEに残し、開発者ごとの手作業を減らすと運用が安定します。
単純なVPNクライアントは全通信を一つの出口へ送るため、npmだけを直したい場面でも社内Gitやローカル開発環境まで巻き込み、原因を追いにくくなることがあります。ClashならMixed Port、ドメインルール、接続ログ、ノード切り替えを個別に確認でき、npmレジストリと社内サービスを分けたまま問題を切り分けられます。もし設定を細かく管理しながら、Windows、macOS、Linuxなど複数環境で同じ考え方を使いたいなら、今回の手順を試せるClashクライアントをダウンロードして、まずはローカルポートとログの対応関係から確認してみてください。
Clashクライアントを無料ダウンロードして、npmの接続を整える →
さっそく使ってみましょう
Clashでプロキシポート、ルール、DNS、ノードを確認し、npm installの不安定な通信を段階的に切り分けましょう。