Visual Studio에서 프록시 및 방화벽 문제 해결

회사 프록시 또는 방화벽 뒤에 Visual Studio를 사용하는 경우 NuGet 패키지 복원, 확장 설치 및 AI 기반 기능과 같이 네트워크 액세스가 필요한 기능에 영향을 주는 연결 문제가 발생할 수 있습니다. 프록시 문제는 일반적으로 다음 두 가지 범주로 구분됩니다.

• 구성 문제: 프록시 서버 설정, 인증서 또는 네트워크 구성과 관련된 문제입니다. 이러한 문제는 IT 관리자가 해결합니다.

• 설정 필요: Visual Studio에는 네트워크 구성에 대한 추가 정보가 필요합니다. IDE에서 직접 프록시 설정을 구성할 수 있습니다. 설치 지침 은 Visual Studio에서 프록시 설정 구성 을 참조하세요.

  비고

  프록시 구성 환경은 아직 모든 Visual Studio 2026 설치에서 사용할 수 없습니다. 설치에 표시되지 않는 경우 Visual Studio 인사이더를 설치하여 시도해 볼 수 있습니다. 또는 지침을 위해 이 페이지의 Visual Studio 2022 버전을 참조하세요.

• 제품 문제: 문제가 구성 문제가 아니거나 제공된 설정이 표시되는 문제를 해결하지 않는 경우 제품 문제가 될 수 있습니다. 티켓을 제출하기 전에 진단 정보 수집 의 단계를 수행합니다.

이 문서는 문제가 속하는 범주를 식별하고 일반적인 문제에 대한 솔루션을 제공하는 데 도움이 됩니다.

필수 조건

프록시 문제를 해결하기 전에 다음이 있는지 확인합니다.

• Visual Studio가 설치되고 최신 버전으로 업데이트되었습니다.
• 방화벽을 통해 허용되는 필수 URL입니다. 방화벽 또는 프록시 서버 뒤에 Visual Studio 설치 및 사용을 참조하세요.

알려진 문제 및 해결 방법

다음 섹션에서는 일반적인 프록시 관련 문제 및 해당 솔루션에 대해 설명합니다.

SSL 연결 오류(인증 기관을 신뢰할 수 없음)

증상: 내부 예외System.Net.Http.HttpRequestException: The SSL connection could not be established와 같은 IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host 오류가 표시됩니다.

범주: 구성 문제

해결 방법: 프록시 서버는 설치 및 신뢰할 수 있어야 하는 CA(인증 기관)를 사용합니다. 다음 단계를 모두 완료합니다.

1. Windows 신뢰할 수 있는 루트 인증 기관 저장소에 모든 프록시 관련 인증서(루트 및 중간)"를 설치하십시오. 자세한 내용은 신뢰할 수 있는 루트 인증 기관 인증서 저장소를 참조하세요.
2. 환경 변수를 NODE_EXTRA_CA_CERTS CA 인증서 파일의 경로로 설정합니다. 이 단계는 Node.js 프로세스를 사용하는 기능에 필요합니다.

비고

방화벽이 프록시 문제가 아닌 연결을 차단하는 경우에도 이 오류가 발생할 수 있습니다.

투명한 프록시 오류

증상: 다양한 오류 메시지와 함께 투명 프록시를 사용할 때 네트워크 호출이 실패합니다.

범주: 구성 문제

해결 방법: 투명한 프록시는 명시적 구성 없이 트래픽을 가로채기 때문에 광범위한 문제를 일으킬 수 있습니다. 프록시 서버는 특정 프로세스 및 애플리케이션에 허용 또는 차단 목록을 사용할 수 있습니다. 네트워크 관리자와 협력하여 다음을 수행합니다.

• Visual Studio 프로세스가 프록시를 통해 허용되는지 확인
• 특정 엔드포인트가 차단되었는지 확인
• SSL 검사 설정 검토

Copilot Chat이 작동하지 않는 동안 Copilot 인증이 작동합니다.

증상: GitHub에 로그인할 수 있으며 Copilot는 인증되었음을 나타내며, 그러나 Copilot 채팅을 사용하면 오류가 발생합니다.

범주: 구성 문제

해결 방법: 이러한 증상은 Visual Studio의 자체 .NET 요청이 실패하지만 .NET Framework 요청이 작동한다는 것을 의미합니다. 특정 엔드포인트를 차단하는 프록시 또는 일반 IPv6 트래픽이 차단되는 프록시를 포함하여 여러 가지 가능한 원인이 있습니다. IPv6 트래픽이 프록시 또는 방화벽에 의해 차단되지 않는지 확인합니다. 다음 솔루션 중 하나를 사용하세요.

• 기본 설정: IPv6 트래픽을 허용하도록 프록시를 구성합니다.
• 대안: IPv4를 강제로 적용하도록 DOTNET_SYSTEM_NET_DISABLEIPV6 환경 변수 1 를 설정합니다.
• 프로세스 허용 목록을 사용하는 경우: 방화벽 또는 프록시 허용 목록에 추가 DevHub.exe 합니다.

부분 인증서 체인 오류

증상: 스택 추적이 표시됩니다 The remote certificate is invalid because of errors in the certificate chain: PartialChain.

범주: 구성 문제

해결 방법: 하나 이상의 중간 인증서가 인증서 체인에서 누락되었습니다. 누락된 인증서를 식별한 다음 IT 관리자와 협력하여 설치하는 단계는 부분 인증서 체인 문제 진단을 참조하세요.

프록시 인증 필요(기본 인증의 경우 407 오류)

증상: 기본 인증과 함께 프록시를 사용할 때 스택 추적이 표시됩니다 (407) Proxy Authentication Required .

범주: 설정 필요

해결 방법: Visual Studio는 기본 인증을 사용하여 인증 프록시 뒤에 있는 GitHub 및 Microsoft Entra 계정에 로그인하는 것을 지원하지만 대부분의 Visual Studio 버전에서는 기본 인증을 사용하는 인증 프록시 뒤에 코필로트가 지원되지 않습니다.

시작 시 자격 증명을 캡처하라는 프롬프트가 나타납니다. 자격 증명은 Windows Credential Manager에서 Windows 자격 증명으로 저장되며, VSCredentials_<proxyAddress> 인터넷 또는 네트워크 주소, 그런 다음 프록시에서 요구하는 사용자 이름 및 암호가 저장됩니다.

Visual Studio에서 직접 프록시 자격 증명을 구성할 수도 있습니다. Visual Studio에서 프록시 설정 구성을 참조하세요.

프록시 인증 필요(NTLM 또는 Kerberos)

증상: NTLM 또는 Kerberos 인증과 함께 프록시 서버를 사용하는 경우 네트워크 종속 기능이 작동하지 않습니다.

범주: 설정 필요

해결 방법: 기본 프록시 자격 증명을 사용하도록 Visual Studio를 구성합니다.

1. 도구>옵션>프록시 설정으로 이동합니다.
2. 로그인한 Windows 계정 사용을 선택하여 현재 Windows 자격 증명을 사용합니다.
3. 변경 내용을 적용하려면 Visual Studio를 다시 시작합니다.

자세한 내용은 Visual Studio에서 프록시 설정 구성을 참조하세요.

비고

나중에 이 해결 방법을 사용하지 않도록 설정하려면 환경 변수를 완전히 삭제합니다. false으로 설정해도 기능이 비활성화되지 않습니다.

명시적 프록시 구성 필요

증상: 프록시에 인증이 필요하지 않더라도 네트워크 종속 기능이 작동하지 않습니다.

범주: 설정 필요

해결 방법: 프록시 서버 주소를 명시적으로 구성합니다.

1. 도구>옵션>프록시 설정으로 이동합니다.
2. 사용자 지정 프록시 설정 사용을 선택합니다.
3. 프록시 서버 URL 및 포트를 입력합니다.
4. 변경 내용을 적용하려면 Visual Studio를 다시 시작합니다.

자세한 내용은 Visual Studio에서 프록시 설정 구성을 참조하세요.

자세한 프록시 구성 단계는 Visual Studio에서 프록시 설정 구성을 참조하세요.

SSL 인증서 문제 해결

SSL 인증서 오류는 일반적으로 프록시 서버가 SSL 검사를 수행하고 필요한 인증서가 제대로 설치되거나 신뢰할 수 없는 경우에 발생합니다. 다음 단계를 사용하여 근본 원인을 진단합니다.

진단 질문에 답변

다음 질문을 통해 문제를 좁힐 수 있습니다.

1. 인증서를 신뢰할 수 있나요? 프록시의 CA 인증서가 현재 사용자의 인증서 저장소 또는 로컬 컴퓨터 저장소에 설치되어 있는지 확인합니다.
2. Visual Studio가 다른 사용자로 실행되고 있나요? Visual Studio가 Windows에 로그인한 사용자와 다른 사용자로 실행되는 경우 현재 사용자의 저장소에 있는 인증서에 액세스하지 못할 수 있습니다.
3. 온라인 서비스에 인증되었나요? Visual Studio에서 Microsoft 또는 GitHub 계정에 로그인할 수 있는지 확인합니다.
4. 기능이 이전에 작동했나요? 기능이 이전에 작동하고 작동을 중지한 경우 업스트림 네트워크 구성 변경이 발생했을 수 있습니다. Visual Studio 제품 문제가 아닙니다.
5. 다른 네트워크 리소스에 액세스할 수 있나요? 웹을 탐색할 수 있지만 Visual Studio 기능이 실패하면 특히 Visual Studio의 네트워크 연결에 문제가 있습니다.

증상에 따라 문제 식별

다음 패턴을 사용하여 특정 문제를 식별합니다.

• 사용자 저장소의 인증서, 다른 사용자로 실행되는 VS: Visual Studio에서 인증서에 액세스하지 못할 수 있습니다. 대신 로컬 컴퓨터 저장소에 인증서를 설치합니다.
• 일부 기능은 작동하지만 다른 기능은 실패합니다. 이는 일반적으로 IPv6 문제 또는 .NET Framework와 .NET Core 네트워킹 간의 차이를 나타냅니다. 코필로트 채팅이 작동하지 않는 동안에는 코필로트 인증이 작동합니다.
• 어제는 잘 동작했는데, 오늘은 문제 발생: 상위 네트워크 구성 변경이 있었습니다. 변경된 내용을 확인하려면 IT 관리자에게 문의하세요.

부분 인증서 체인 문제 진단

오류가 표시 PartialChain 되면 다음 단계를 사용하여 누락된 인증서를 식별합니다. 이러한 단계에는 OpenSSL 명령줄 도구가 필요합니다.

1. 다음 명령을 실행하여 PROXY_HOST:PORT을(를) 프록시 주소로, target.host.com을(를) 도달하려는 엔드포인트로 대체하여 인증서 체인을 확인합니다.

   openssl s_client -proxy PROXY_HOST:PORT -connect target.host.com:443 -showcerts -verify 5 </dev/null
   

2. 출력의 각 인증서에 대해 체인을 확인하기 위해 다음 명령을 실행합니다(각 인증서를 cert1.pem, cert2.pem 등의 별도 파일로 저장한 후).

   openssl x509 -in cert1.pem -noout -subject -issuer -ski -aki
   

3. 다음을 확인하여 인증서 체인을 확인합니다.

   • 인증서 N의 AKI(기관 키 식별자) 는 인증서 N+1의 SKI(주체 키 식별자) 와 일치해야 합니다.
   • 인증서 N의 발급자 DN 은 인증서 N+1의 주체 DN 과 일치해야 합니다.

체인에서 중단이 발견되면 IT 관리자에게 문의하여 누락된 중간 인증서를 가져오고 설치합니다.

비고

.NET은 웹 브라우저가 성공하더라도 한 인증서의 AKI가 체인에 있는 다음 인증서의 SKI와 일치하지 않는 경우 요청을 거부합니다. 이는 대부분의 브라우저에서 수행하는 것보다 더 엄격한 유효성 검사입니다.

제품 문제: 지원을 위한 진단 정보 수집

Visual Studio에서 필요한 설정을 제공한 후 문제가 구성 문제가 아니라고 판단한 경우 피드백 티켓을 제출하세요. Visual Studio에서 문제를 보고하는 방법을 참조하세요. 프록시 문제에 대한 피드백 티켓을 제출할 때 조사에 도움이 되는 다음 정보를 포함합니다. 제공하는 세부 정보가 많을수록 문제가 제품 버그인지 구성 문제인지를 더 빠르게 식별할 수 있습니다.

인증 상태 확인

다음 인증 상태를 확인합니다.

1. GitHub 인증:

   • Windows>자격 증명 관리자>Windows 자격 증명을 엽니다.
   • 접두사가 git:인 자격 증명을 찾습니다.
   • GitHub 계정 메타데이터를 %LocalAppData%/.IdentityService/GitHubV3AccountStore.json 확인합니다.

2. 기능 상태: 어떤 기능이 작동하고 어떤 기능이 실패하는지 확인합니다(예: NuGet 복원, 확장 설치, AI 기능).

로그 및 구성 세부 정보 수집

다음 정보를 수집합니다.

1. Visual Studio 로그: %temp%/Vslogs의 zip 파일을 만듭니다.

2. 네트워크 추적: 가능하면 실패한 요청을 보여 주는 Fiddler 추적을 수집합니다.

3. 프록시 구성 세부 정보:

   • 명시적 또는 투명한 프록시인가요?
   • 프록시에 인증이 필요한가요? 그렇다면 어떤 종류(기본, NTLM, Kerberos)?
   • 프록시가 특정 애플리케이션을 차단하거나 허용하고 있나요?
   • 필요한 인증서가 설치되고 신뢰할 수 있나요? 인증서가 해지되었거나 만료되었나요?
   • 방화벽도 구성되었나요?
   • SSL 검사를 사용하도록 설정되었나요?
   • IPv6 트래픽이 프록시를 통해 라우팅되나요?

4. 다른 도구와의 비교: Visual Studio Code 또는 다른 애플리케이션이 이 프록시를 통해 작동하나요?

관련 콘텐츠

• Visual Studio에서 프록시 설정 구성

• 방화벽 또는 프록시 서버 뒤에 Visual Studio 설치 및 사용
• Visual Studio 연결 문제 해결