GitHub Copilot のネットワーク エラーのトラブルシューティング

プロキシとカスタム認証に関連する一般的なエラーを解決します。

この記事で

会社支給のデバイスを使用して会社のネットワークに接続している場合、VPN または HTTP プロキシ サーバーを介してインターネットに接続している可能性があります。 場合によっては、これらの種類のネットワークセットアップによって、 GitHub Copilot が GitHubのサーバーに接続できなくなる場合があります。 GitHub Copilotを使用してプロキシを設定するためのオプションの詳細については、「GitHub Copilot のネットワーク設定の構成」を参照してください。

この記事では、HTTP プロキシとカスタム認証に関連するよくある問題に対処するためのガイダンスを提供しています。 ファイアウォールを使用すると、 GitHub Copilotの接続に干渉する可能性もあります。 詳細については、「GitHub Copilot のファイアウォール設定のトラブルシューティング」を参照してください。

ネットワークの問題を診断する

ネットワークに関する問題のトラブルシューティングを行っている場合は、接続をテストするために curl 要求を実行することが役立つ場合があります。 --verbose フラグを追加すると、これらの要求により、問題を診断したり、会社の IT 部門やGitHub のサポートと共有したりするための詳細情報が提供されます。 GitHub のサポートを介してGitHub Support ポータルに連絡できます。

環境から少なくとも一部の GitHubのエンドポイントにアクセスできるかどうかを確認するには、コマンド ラインから次のコマンドを実行します。

Shell
curl --verbose https://copilot-proxy.githubusercontent.com/_ping

接続できる場合は、HTTP 200 応答を受け取ります。

HTTP プロキシ経由で接続していることがわかっている場合は、プロキシ経由で要求が成功したかどうかを確認できます。 次の例を使用する場合は、YOUR-PROXY-URL:PORT をプロシキの詳細に置き換えてください。

Shell
curl --verbose -x http://YOUR-PROXY-URL:PORT -i -L https://copilot-proxy.githubusercontent.com/_ping

「認証の失効」に関連するエラーを受け取った場合は、--insecure フラグを指定して要求を再試行できます。 --insecure フラグが追加されたときにのみ要求が成功する場合は、証明書エラーを無視した場合にのみGitHub Copilotが正常に接続することを示している可能性があります。 詳細については、「証明書に関連するエラーのトラブルシューティング」を参照してください。

エディターでコパイロットチャットが難しい場合は、上記のcurlコマンドを実行しますが、https://copilot-proxy.githubusercontent.com/_pingではなくhttps://api.githubcopilot.com/_pingを使用してください。

接続できず、curl 要求でエラーを特定することができない場合は、エディターで詳細な診断ログを収集することが有効な場合があります。 会社の IT 部門または GitHub のサポートと連携している場合は、これらの診断を共有すると、エラーの解決に役立つ場合があります。 エディターでデバッグ ログを有効にすると、より具体的な情報を共有することができます。 詳細については、「環境内の GitHub Copilot のログの表示」を参照してください。

プロキシ エラーのトラブルシューティング

プロキシのセットアップに問題がある場合は、エラー GitHub Copilot could not connect to server. Extension activation failed: "read ETIMEDOUT" or "read ECONNRESET" が表示されることがあります。 このエラーは、さまざまなネットワークの問題点によって発生する可能性があります。

プロキシ経由で接続していることがわかっている場合は、環境内でプロキシが正しく構成されていることを確認してください。 詳細については、「GitHub Copilot のネットワーク設定の構成」を参照してください。

メモ

プロキシ サーバーを持つ会社の従業員である場合は、会社レベルで Copilot のプロキシ設定も構成する必要があります。 「Copilot 許可リスト リファレンス を参照してください。

GitHub Copilot では、カスタム コードを使用してプロキシに接続します。 つまり、エディターでサポートされているプロキシセットアップは、必ずしも GitHub Copilotでサポートされるとは限りません。 プロキシに関連するエラーのよくある原因を、以下にいくつか挙げています。

  • プロキシの URL が https://開始される場合、現在 GitHub Copilotではサポートされていません。
  • プロキシに対する認証が必要な場合があります。 GitHub Copilot では、Kerberos を使用した基本認証または認証がサポートされます。 Kerberos を使用している場合は、プロキシ サービスの有効なチケットがあり、サービスに正しいサービス プリンシパル名を使用していることを確認してください。 詳細については、「GitHub Copilot のネットワーク設定の構成」を参照してください。
  • GitHub Copilot カスタム証明書を拒否する場合があります。 詳細については、「証明書に関連するエラーのトラブルシューティング」を参照してください。

プロキシのセットアップによっては、"証明書署名エラー"、"カスタム証明書"、"最初の証明書を確認できない" などのエラーが発生する場合があります。 これらのエラーは通常、カスタム証明書を使用してセキュリティ保護接続をインターセプトし検査する企業向けプロキシの設定が原因で発生します。

証明書に関連するエラーを解決する可能性のある方法を、以下にいくつか示しています。

  • セキュリティで保護された接続をインターセプトしない別のプロキシを構成します。

  • 企業プロキシを使っている場合は、IT 部署に連絡し、セキュリティで保護された接続をインターセプトしないようにプロキシを構成できるかどうかを確認してください。

  • カスタム証明書がオペレーティング システムの信頼ストアに正しくインストールされていることを確認してください。 詳細については、「GitHub Copilot のネットワーク設定の構成」を参照してください。 証明書がコンピューターにインストールされていても、 GitHub Copilot が検出されない場合は、証明書の検索に使用 GitHub Copilot メカニズムを把握するのに役立つ場合があります。

    • Windowsでは、Copilotは win-ca パッケージを使用します。
    • macOS では、 Copilot は mac-ca パッケージを使用します。
    • Linux では、 Copilot は標準の OpenSSL ファイルの /etc/ssl/certs/ca-certificates.crt と /etc/ssl/certs/ca-bundle.crtを確認します。

  • 証明書エラーを無視するように GitHub Copilot を構成します。 プロキシ設定で、Visual Studio Codeで Proxy Strict SSL の選択を解除するか、JetBrains IDE で [信頼されていない証明書を自動的に受け入れる] を選択できます。 詳細については、「GitHub Copilot のネットワーク設定の構成」を参照してください。

    警告

    セキュリティの問題が発生する可能性があるため、認証エラーを無視することはお勧めしません。

セキュリティで保護された Web トラフィックを監視するセキュリティ ソフトウェアを使用していて、「最初の証明書を確認できません」というエラーが表示される場合は、IDE と Copilot のどちらか、または両方の拡張機能に対する例外の構成を行う必要がある可能性があります。

例外を構成する方法の詳細については、セキュリティ ソフトウェア ベンダーにお問い合わせください。