npm は現在ダウンしていますか？

npm の可用性が意味すること

npm には複数のアクセス経路があり、それぞれが独立して失敗する可能性があります。npm の Web サイトは npmjs.com を使用します。一方、パッケージのインストール、依存関係の解決、公開では、通常 registry.npmjs.org が関係します。Web サイトは読み込めても Registry へのリクエストが失敗する場合や、Web サイトが完全にオフラインに見えなくても、Registry の障害によってパッケージコマンドが影響を受ける場合があります。

サービス全体の状況を最も広く確認するには、npm の公式ステータスページを確認してください。インシデントが、パッケージの取得、認証、公開、Registry/API アクセス、Web サイトへのアクセスなど、失敗している操作と一致するか確認しましょう。npm のすべての機能が影響を受けていると決めつけないことが重要です。

ステータスページでは報告済みのプラットフォーム障害を確認できますが、プロジェクト固有の失敗を診断することはできません。正確な npm エラー、設定されている Registry、影響を受けるパッケージ、同じリクエストが別のネットワークから成功するかどうかは、npm の障害とローカル、アカウント、接続の問題を切り分けるうえで、より有用な情報になることがよくあります。

npm の問題をトラブルシューティングする

1. 該当する npm のインシデントを確認する

npm の公式ステータスページを開き、Registry、パッケージのダウンロード、認証、公開、Web サイトに影響する進行中または最近解決したインシデントを探します。報告された問題が失敗している操作と一致する場合は、影響の大きいプロジェクト変更を避け、インシデントの解決後に再試行してください。一致するインシデントが表示されない場合でも、地域、ネットワーク、アカウント、プロジェクト固有の問題である可能性は残ります。

2. 失敗の範囲を確認する

複数のプロジェクトでインストールまたはパッケージ解決が失敗する場合は、Registry へのアクセス、DNS、プロキシ、ファイアウォール、npm 設定の確認を優先します。1 つのプロジェクトまたはパッケージだけが失敗する場合は、問題を npm の障害と判断する前に、依存関係の宣言、lockfile、パッケージ名、設定されている Registry を調べてください。

公開やログインの失敗は、公開パッケージのダウンロードとは分けて分析する必要があります。完全なエラー、使用しているアカウントまたはトークン、対象の Registry、そして失敗が 1 つのパッケージ、組織、アカウント操作のどれに影響しているかを確認してください。

3. ネットワークと DNS の症状を切り分ける

• Connection timed out: リクエストがブロックされている、誤った経路にルーティングされている、または応答を受信できない可能性があります。同じ操作を別のネットワークから実行し、該当する企業のファイアウォールやプロキシのルールを確認してください。
• Connection refused: 設定されたエンドポイント、プロキシ、またはローカルネットワーク経路が接続を拒否している可能性があります。npm が、古い社内エンドポイントやサードパーティのエンドポイントではなく、想定した Registry を対象にしていることを確認してください。
• NXDOMAIN などの DNS エラー: リゾルバーが要求されたホストを見つけられていません。別のネットワークで DNS の動作を比較し、VPN、フィルタリング、ローカルリゾルバーの設定を確認してください。
• TLS または証明書エラー: 証明書の検証設定を変更する前に、HTTPS インターセプション、プロキシ証明書、システム時刻、セキュリティソフトを調べてください。

4. npm の設定と認証を確認する

特にネットワークを切り替えた後、VPN を有効にした後、またはプライベート Registry を使用している場合は、設定されている Registry とプロキシの設定を確認してください。ログイン、公開、プライベートパッケージへのアクセスでは、使用するアカウントに必要な権限があり、認証情報やトークンが期限切れになっていないことを確認します。ターミナルの出力、 issue report、サポートへの問い合わせにトークンを決して含めないでください。

5. ブラウザーだけで発生する失敗を確認する

Web ブラウザーでは npm の Web サイトにアクセスできない一方、パッケージコマンドは動作する場合は、プライベートウィンドウまたは別のブラウザーを試し、スクリプトや Cookie をブロックする拡張機能を一時的に無効にします。ブラウザーと npm コマンドの両方が失敗する場合は、ブラウザー固有の対処ではなく、ステータスページとネットワークの確認を優先してください。

6. Registry と API のレスポンスを解釈する

Web サイトは動作しているのに registry.npmjs.org に到達できない場合は、Registry 経路を個別に確認し、正確な HTTP ステータスまたは npm エラーを記録してください。5xx レスポンスはサーバー側または上流の問題を示す可能性があります。4xx レスポンスは、無効なリクエスト、権限不足、認証の問題、レート制限、利用できないパッケージを示すことが多くなります。エスカレーション時にはパッケージ名、コマンド、時刻、完全なエラーを保持しますが、認証情報とトークンは削除してください。