GitHub Copilot에 대한 네트워크 오류 문제 해결

프록시 및 사용자 지정 인증서와 관련된 일반적인 오류 해결 방법입니다.

이 기사에서

회사 장비로 작업하며 회사 네트워크에 연결하는 경우, VPN이나 HTTP 프록시 서버를 통해 인터넷에 접속하고 있을 수 있습니다. 경우에 따라 이러한 유형의 네트워크 구성으로 인해 GitHub Copilot가 GitHub의 서버에 연결하지 못할 수 있습니다. 프록시 GitHub Copilot를 설정하는 옵션에 대한 자세한 내용은 GitHub Copilot에 대한 네트워크 설정 구성을 참조하세요.

이 문서는 HTTP 프록시 및 사용자 지정 인증서와 관련된 일반적인 문제에 대한 해결 방법을 안내합니다. 방화벽을 사용하는 경우, 이로 인해 GitHub Copilot의 연결이 방해될 수도 있습니다. 자세한 내용은 GitHub Copilot에 대한 방화벽 설정 문제 해결 참조하세요.

네트워크 문제 진단하기

네트워크 문제를 해결할 때 연결 상태를 점검하도록 curl 에게 요청하면 도움이 될 수 있습니다. 플래그를 --verbose 추가하는 경우 이러한 요청은 문제를 진단하거나 회사의 IT 부서 또는 GitHub 지원공유에 대한 자세한 정보를 제공합니다. GitHub 지원를 통해 GitHub 지원 포털에 연락할 수 있습니다.

사용자 환경에서 적어도 일부 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 Copilotwin-ca 패키지를 사용합니다.
    • macOS에서 Copilotmac-ca 패키지를 사용합니다.
    • Linux에서 Copilot는 OpenSSL 표준 파일 /etc/ssl/certs/ca-certificates.crt 및 /etc/ssl/certs/ca-bundle.crt를 확인합니다.

  • GitHub Copilot가 인증서 오류를 무시하도록 구성합니다. 프록시 설정에서 프록시 Strict SSL의 선택을 취소하거나 JetBrains IDE에서 Visual Studio Code자동으로 신뢰할 수 없는 인증서 수락을 선택할 수 있습니다. 자세한 내용은 GitHub Copilot에 대한 네트워크 설정 구성 참조하세요.

    경고

    보안 문제를 야기할 수 있으므로 인증서 오류를 무시하는 것은 권장되지 않습니다.

사용자나 조직에서 보안 웹 트래픽 모니터링 소프트웨어를 사용할 때 ‘첫 번째 인증서를 확인할 수 없음’이라는 오류가 발생한다면, IDE 또는 Copilot 확장을 보안 예외 항목으로 설정해야 합니다.

보안 소프트웨어 공급업체에 문의하여 예외 구성 방법에 대한 자세한 정보를 얻으세요.