--- title: "Macでnpm error code ETIMEDOUT：npmのネットワークタイムアウトを解決する · Kilobatガイド" url: "https://kilobat.app/ja/guides/npm-etimedout.html" description: "Macでのnpm installがnpm error code ETIMEDOUTで止まる。レジストリ、プロキシ、接続を確認し、npmの設定を変更します。" --- エラーメッセージ # Macで「npm error code ETIMEDOUT」と表示される ETIMEDOUTは、相手側が時間内に応答しなかったことを意味します。Node.jsのドキュメントには「the connected party did not properly respond after a period of time.」（接続先が一定時間後も適切に応答しなかった）とあります。 対象：npm 10以降は「npm error」、それより前のバージョンは「npm ERR!」と表示します。現行のすべてのmacOS。 · 確認日：2026年10月29日 ## 症状 - `npm install`が`npm error code ETIMEDOUT`で止まる。 - npmが、ネットワーク接続に関する問題だと付け加える。 - 会社のネットワークやテザリングなど、特定のネットワークで失敗する。 ## 考えられる原因 - **npmが知らないプロキシ。**プロキシが必要なネットワークでは、npmに`proxy`と`https-proxy`の設定が必要です。 - **到達できないレジストリ。**古い`registry`の設定が、プライベートサーバを指していることがあります。 - **遅い、またはパケットロスの多い接続。**弱いWi-Fiやテザリングでは、大きなパッケージがタイムアウトします。 - **壊れたIPv6の経路。**レジストリにはIPv6アドレスがありますが、使っているネットワークではIPv6が機能していません。 ## 確認方法 1. npmのレジストリとプロキシの設定を表示します。 ``` npm config get registry npm config get proxy npm config get https-proxy ``` 2. レジストリに応答を求めます。 ``` npm ping ``` 3. IPv4のみで、curlを使ってレジストリをテストします。 ``` curl -4 -I https://registry.npmjs.org/ ``` 4. 接続を測定します。 ``` networkQuality ``` ## 解決方法 1. ネットワークでプロキシが必要な場合は、npmに設定します。 ``` npm config set https-proxy http://proxy.example.com:8080 ``` 2. 古いレジストリ設定を削除して、npmがデフォルトを使うようにします。 ``` npm config delete registry ``` 3. 遅い接続では、npmの再試行回数を増やします。 ``` npm config set fetch-retries 5 ``` 4. 可能であれば、より速いネットワークでもう一度インストールします。 ## Kilobatを使う場合 1. Kilobatの接続ドクターは、レジストリへの接続をネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの層ごとにテストし、失敗した層を特定します。 ``` kilobat why https://registry.npmjs.org/ ``` 2. 大きなインストールの前に、ネットワークが従量制か、VPN経由か、遅いかを確認します。 ``` kilobat conditions ``` 3. これらのKilobatのチェックは無料です。AIエージェントはMCPを通じて`diagnose_connection`と`diagnose_network`で実行します。[1つのサイトやAPIに接続できない原因を見つける](https://kilobat.app/ja/guides/recipes/why-cant-it-connect.html)を参照してください。 ## よくある質問 **npmはどれくらい待ちますか？** npmのドキュメントによると、`fetch-timeout`のデフォルトは300000 ms（5分）、`fetch-retries`は2回です。 ## 出典 - [Node.jsドキュメント：一般的なシステムエラー](https://nodejs.org/api/errors.html#common-system-errors) - [npmドキュメント：config](https://docs.npmjs.com/cli/v11/using-npm/config) - curl(1)とnetworkQuality(8)、macOS 27.2に付属のmanページ 出典は2026年10月29日に確認しました。manページはmacOSに付属のものです。「ターミナル」で`man `を実行すると開けます。 ## 関連ガイド - [Macで「npm error code ECONNRESET」と表示される](https://kilobat.app/ja/guides/npm-econnreset.html): ECONNRESETは、相手側が接続を強制的に閉じたことを示します。 - [MacでHomebrewやnpmのダウンロードが失敗する](https://kilobat.app/ja/guides/homebrew-npm-download-fails.html): Homebrewはcurlとgitでダウンロードします。 - [Macでプロキシ設定のせいでアプリが接続できない](https://kilobat.app/ja/guides/proxy-settings-breaking-apps.html): プロキシ設定は、通信を別のサーバ経由で送ります。 - [Macで会社のプロキシ証明書がターミナルのツールを妨げる](https://kilobat.app/ja/guides/corporate-proxy-certificates.html): 会社のネットワークの中には、HTTPSの通信を検査するものがあります。 - [エージェントで大きなダウンロードの前にネットワークを確認する](https://kilobat.app/ja/guides/recipes/check-network-before-download.html): エージェントは、今が大きな転送に向いたタイミングかどうかをKilobatに確認できます。