GitHub Copilot의 네트워크 오류 문제 해결하기

프록시 및 사용자 지정 인증서와 관련된 일반적인 오류를 해결하세요.

누가 이 기능을 사용할 수 있는 있나요?

GitHub Copilot은 GitHub Copilot Individual을 통해 개인 계정으로 관리할 수 있고 또는 GitHub Copilot Business조직 계정으로 관리하거나 GitHub Copilot Enterprise를 통해 엔터프라이즈 계정으로 관리할 수 있습니다.

GitHub Copilot은 인기 있는 오픈 소스 프로젝트의 검증된 학생, 교사 및 유지 관리자가 무료로 사용할 수 있습니다. 인기 있는 오픈 소스 프로젝트의 학생, 교사나 유지 관리자가 아닌 경우 GitHub Copilot을 1회에 한해 무료로 30일 동안 사용해 볼 수 있습니다. 평가판이 끝난 후에 계속 사용하려면 유료로 구독해야 합니다. 자세한 내용은 "GitHub Copilot 청구 정보"을 참조하세요.

이 문서의 내용

회사 장비에서 작업하고 회사 네트워크에 연결하는 경우 VPN 또는 HTTP 프록시 서버를 통해 인터넷에 연결하고 있을 수 있습니다. 경우에 따라 이러한 유형의 네트워크 설정으로 인해 GitHub Copilot이(가) 의 서버에 연결하지 못할 수 있습니다. 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이(가) 성공적으로 연결됨을 나타낼 수 있습니다. 자세한 내용은 “인증서 관련 오류 문제 해결”을 참조하세요.

편집기에서 Copilot Chat 관련 문제가 발생하는 경우, 위의 curl 명령을 실행하되 https://copilot-proxy.githubusercontent.com/_ping 대신 https://api.githubcopilot.com/_ping을 사용합니다.

참고: 2024년 2월 1일부터 https://copilot-proxy.githubusercontent.com을 통해 라우팅되는 Copilot Chat API 엔드포인트가 사용 중단되었습니다. 이러한 요청은 대신 https://api.githubcopilot.com/을 통과합니다. Copilot 확장 프로그램의 최신 버전을 사용하고 있고 방화벽 및 네트워크 설정이 https://api.githubcopilot.com과(와)의 통신을 허용하는지 확인하세요.

연결할 수 없고 요청이 curl 오류를 식별하는 데 도움이 되지 않는 경우 편집기에서 자세한 진단 로그를 수집하는 데 도움이 될 수 있습니다. 회사 IT 부서 또는 GitHub 지원과(와) 협력하는 경우 이러한 진단을 공유하면 오류를 해결하는 데 도움이 될 수 있습니다. 편집기에서 디버그 로깅을 활성화하면 보다 구체적인 정보를 공유하는 데 도움이 됩니다. 자세한 내용은 "사용자 환경에서 GitHub Copilot에 대한 로그 보기"을(를) 참조하세요.

프록시 오류 문제 해결

프록시 설정에 문제가 있는 경우 다음 오류가 GitHub Copilot could not connect to server. Extension activation failed: "read ETIMEDOUT" or "read ECONNRESET"표시 될 수 있습니다. 이 오류는 다양한 네트워크 문제로 인해 발생할 수 있습니다.

프록시를 통해 연결하고 있는 경우 프록시가 사용 중인 환경에서 올바르게 구성되어 있는지 확인하세요. 자세한 내용은 "GitHub 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에서 프록시 Strict SSL의 선택을 취소하거나 JetBrains IDE에서 자동으로** 신뢰할 수 없는 인증서 허용을 선택할 **수 있습니다. 자세한 내용은 "GitHub Copilot의 네트워크 설정 구성하기"을(를) 참조하세요.

    경고: 인증서 오류를 무시하면 보안 문제가 발생할 수 있으므로 권장하지 않습니다.