Visual Studio 설치, 업데이트 또는 사용 시의 네트워크 관련 오류 문제 해결
적용 대상: Visual Studio
방화벽, 프록시 서버 또는 인터넷에 액세스할 수 없는 클라이언트 컴퓨터에서 Visual Studio를 설치, 업데이트 또는 사용할 때 네트워크 또는 프록시 관련 오류가 발생할 수 있습니다. 이 문서에서는 이러한 문제의 몇 가지 일반적인 시나리오에 대한 해결을 제공합니다.
오류 "프록시 권한 부여 필요"
이 오류는 일반적으로 사용자가 프록시 서버를 통해 인터넷에 연결할 때 발생합니다. 그러면 프록시 서버는 Visual Studio에서 일부 네트워크 리소스에 대해 호출하는 것을 차단합니다.
해결
이 문제를 해결하려면 다음 단계를 수행합니다.
Visual Studio를 다시 시작합니다. 프록시 인증 대화 상자가 나타납니다. 대화 상자에 메시지가 표시되면 자격 증명을 입력합니다.
Visual Studio를 다시 시작해도 문제가 해결되지 않는 경우 프록시 서버가 주소에 대한 자격 증명을
http://go.microsoft.com
묻는 메시지를 표시하지 않고 주소에 대한*.visualStudio.microsoft.com
자격 증명을 요청하지 않기 때문일 수 있습니다. 이러한 서버에 대해 다음 URL을 허용 목록에 포함하여 Visual Studio에서 모든 로그인 시나리오의 차단을 해제합니다.*.windows.net
*.microsoftonline.com
*.visualstudio.microsoft.com
*.microsoft.com
*.live.com
허용 목록에서
http://go.microsoft.com
주소를 제거하는 것이 좋습니다. 주소를 제거하면 Visual Studio를 다시 시작할 때http://go.microsoft.com
주소와 서버 엔드포인트 모두에 대해 프록시 인증 대화 상자가 표시되도록 할 수 있습니다.
프록시 서버 구성
Visual Studio는 Windows에서 프록시 설정을 선택해야 합니다. 그러나 다음과 같은 방법으로 특정 프록시 서버를 설정할 수 있습니다.
다음에서 devenv.exe.config(devenv.exe 구성 파일)를 찾습니다.
- Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE 또는 %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE.
- Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE 또는 %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE.
구성 파일에서
<system.net>
블록을 찾아 다음 코드를 추가합니다.<defaultProxy enabled="true"> <proxy bypassonlocal="True" proxyaddress="http://<yourproxy:port#>"/> </defaultProxy>
proxyaddress="<http://<yourproxy:port#>
에는 네트워크의 올바른 프록시 주소를 삽입해야 합니다.참고
자세한 내용은 <defaultProxy> 요소(네트워크 설정) 및 <프록시> 요소(네트워크 설정) 페이지를 참조하세요.
Visual Studio 2022의 경우 프록시 환경 변수를 설정합니다.
- http_proxy: 이 변수는 HTTP 요청에 사용됩니다. 일부 도구에서는 변수가 소문자로 예상되기 때문에 이 변수는 소문자입니다.
- HTTPS_PROXY: 이 변수는 HTTPS 요청에 사용됩니다.
- ALL_PROXY: 이 변수는 HTTP 또는 변수가 정의되지 않은 경우
HTTP_PROXY
HTTPS_PROXY
HTTP 또는 HTTPS 요청에 대한 프록시 서버를 지정하는 데 사용됩니다.
참고 항목
자세한 내용은 HttpClient.DefaultProxy를 참조 하세요.
기본 사용자 자격 증명
프록시와 함께 Visual Studio를 실행하는 사용자 계정에 대한 기본 자격 증명을 사용하려면 다음 단계를 수행합니다.
다음에서 devenv.exe.config(devenv.exe 구성 파일)를 찾습니다.
- Visual Studio 2019: %ProgramFiles%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE 또는 %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\Common7\IDE.
- Visual Studio 2022: %ProgramFiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE 또는 %ProgramFiles(x86)%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE.
구성 파일에서
<system.net>
블록을 찾아 다음 코드를 추가합니다.<defaultProxy enabled="true" useDefaultCredentials="true"> <proxy bypassonlocal="True" proxyaddress="http://<yourproxy:port#>"/> </defaultProxy>
proxyaddress="<http://<yourproxy:port#>
에는 네트워크의 올바른 프록시 주소를 삽입해야 합니다.참고
자세한 내용은 <defaultProxy> 요소(네트워크 설정) 및 <프록시> 요소(네트워크 설정) 페이지를 참조하세요.
Visual Studio 17.8 이후부터 웹 요청의 기본 프록시 자격 증명에 대한 구성 프로세스를 업데이트했습니다. 이 업데이트 후에 기본 프록시 자격 증명을 사용하도록 설정하려면 명명된
VS_USE_DEFAULTPROXY
새 환경 변수를 만들고 해당 값을 <a0/>로 설정한 다음 Visual Studio를 다시 시작합니다. 이 변수는 Visual Studio 및 관련 프로세스에 프로세스를 실행하는 사용자의 기본 자격 증명을 프록시 요청에 연결하도록 지시합니다. 이는 2단계의 exe 구성 파일에서 수행하는 것과 유사 useDefaultCredentials
합니다.
프록시 오류 디버깅
프록시 서버 뒤에서 네트워크 연결을 시도하는 경우 다양한 종류의 오류가 발생할 수 있습니다. 일부 오류에는 "송신 오류", "연결 거부됨" 및 "주소를 확인할 수 없음"이 포함됩니다. 다른 종류의 오류가 있을 수 있지만, 공통적으로 일부 구성이 로컬 컴퓨터 또는 네트워크에서 잘못되었다는 것입니다. 연결을 차단하는 항목을 진단하는 데 도움이 되도록 Visual Studio 외부의 도구를 사용하는 것이 도움이 될 수 있습니다.
연결 거부 또는 송신 오류와 같은 오류가 발생하는 경우 다음 명령줄을 시도합니다.
curl "https://resource" -v
이 명령을 실행하면 리소스에 대한 네트워크 연결이 수행되며 Visual Studio에서 볼 수 있는 것과 유사하게 실패할 수 있습니다. 이 시점에서 Visual Studio를 사용하여 연결을 시도하기 전에 이 오류를 진단해야 합니다. 여기서 오류는 Visual Studio의 제품 문제가 아닌 컴퓨터 또는 네트워크 구성 문제를 나타냅니다.
특정 주소가 있는 프록시 서버 뒤에 있는 경우 프록시 설정
http_proxy
에 해당 환경 변수를 사용하므로 명령을 실행curl
하기 전에 설정 및https_proxy
환경 변수가 필요합니다.curl의 스위치를
help
다른 옵션에 사용할 수도 있습니다. 이 명령은curl --help proxy
.을 사용하여 프록시curl
를 설정하고 구성하는 데 사용할 수 있는 옵션 및 스위치 목록을 표시합니다.디버그할 Visual Studio에 로그인 문제가 있는 경우 다음 명령을 실행합니다.
curl "https://login.microsoftonline.com/common/discovery/instance?api-version=1.1&authorization_endpoint=https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize" -v curl "https://management.azure.com" -v curl "https://graph.microsoft.com" -v
로그인에 필요한 URL은 방화벽 또는 프록시 서버 뒤에 Visual Studio 설치 및 사용을 참조하세요.
문제를 보고하려고 할 때 "Visual Studio에서 연결 끊김" 오류
이 오류는 일반적으로 사용자가 프록시 서버를 통해 인터넷에 연결할 때 발생합니다. 그러면 프록시 서버는 Visual Studio에서 일부 네트워크 리소스에 대해 호출하는 것을 차단합니다.
해결
이 문제를 해결하려면 다음 단계를 따릅니다.
%ProgramFiles(x86)%\Microsoft Visual Studio\Installer 또는 %ProgramFiles%\Microsoft Visual Studio\Installer에서 feedback.exe.config(feedback.exe 구성 파일)를 찾습니다.
구성 파일에서 다음 코드가 있는지 확인합니다. 코드가 없으면 마지막
</configuration>
줄 앞에 추가합니다.<system.net> <defaultProxy useDefaultCredentials="true" /> </system.net>
오류 "기본 연결이 닫혔습니다."
방화벽이 있는 프라이빗 네트워크에서 Visual Studio를 사용하는 경우 Visual Studio가 일부 네트워크 리소스에 연결하지 못할 수 있습니다. 이러한 리소스에는 로그인 및 라이선스용 Azure DevOps Services, NuGet 및 Azure 서비스가 포함될 수 있습니다. Visual Studio가 이러한 리소스 중 하나에 연결하지 못할 경우 다음과 같은 오류 메시지가 표시될 수 있습니다.
기본 연결이 닫혔습니다. 전송 중 예기치 않은 오류가 발생했습니다.
Visual Studio는 TLS(전송 계층 보안) 1.2 프로토콜을 사용하여 네트워크 리소스에 연결합니다. Visual Studio에서 TLS 1.2를 사용하는 경우 일부 개인 네트워크의 보안 어플라이언스는 특정 서버 연결을 차단합니다.
해결
허용 목록에 이러한 도메인 URL을 추가하여 연결을 사용하도록 설정합니다.
오류 "부모 프로세스에서 ID를 구문 분석하지 못했습니다."
네트워크 드라이브에서 Visual Studio 부트스트래퍼 및 response.json 파일을 사용할 때 이 오류 메시지가 표시될 수 있습니다. 오류의 소스는 Windows의 UAC(사용자 계정 컨트롤)입니다.
이 오류가 발생하는 이유는 다음과 같습니다. 매핑된 네트워크 드라이브 또는 UNC 공유는 사용자의 액세스 토큰에 연결됩니다. UAC를 사용하도록 설정하면 두 개의 사용자 액세스 토큰이 생성됩니다. 하나는 관리자 액세스 권한이 있고 다른 하나는 관리자 액세스 권한이 없는 토큰입니다. 네트워크 드라이브 또는 공유를 만든 경우 사용자의 현재 액세스 토큰이 연결됩니다. 부트스트래퍼는 관리자 권한으로 실행되어야 하므로 드라이브 또는 공유가 관리자 액세스 권한이 있는 사용자 액세스 토큰에 연결되지 않는 한 네트워크 드라이브에 액세스하거나 공유할 수 없습니다.
해결
이 문제를 해결하려면 명령을 사용 net use
하거나 UAC 그룹 정책 설정을 변경합니다. 이러한 해결 방법 및 구현 방법에 대한 자세한 내용은 다음을 참조하세요.
- Windows에서 UAC가 "자격 증명 확인"으로 구성된 경우 관리자 권한 프롬프트에서 매핑된 드라이브를 사용할 수 없습니다
- Windows 운영 체제에서 사용자 계정 컨트롤을 설정한 후 프로그램에서 일부 네트워크 위치에 액세스하지 못할 수 있습니다
네트워크 공유 권한이 올바르게 구성되지 않아 제품을 설치하거나 업데이트하지 못함
설치 또는 업데이트를 수행하는 계정에 네트워크 공유에 대한 충분한 액세스 권한이 있는지 확인합니다.
문제 | 해결 방법 |
---|---|
사용자 계정은 파일에 액세스할 수 없습니다. | 사용자에게 컴퓨터에 대한 관리자 권한이 있고 레이아웃에서 설치 또는 업데이트하려는 경우 네트워크 위치를 공유하기 전에 사용자에게 읽기 권한을 부여하도록 ACL(네트워크 공유 권한)이 구성되어 있는지 확인해야 합니다. |
시스템 계정은 파일에 액세스할 수 없습니다. | 경우에 따라 설치 또는 업데이트가 사용자 계정 대신 시스템 계정을 사용하여 실행됩니다. 이 상황은 일반적으로 관리자 업데이트를 사용하여 컴퓨터를 업데이트하고 안전하게 유지하는 경우에 발생합니다. 클라이언트 컴퓨터의 시스템 계정에 네트워크 파일 공유에 대한 읽기 권한이 있는지 확인해야 합니다. 이 작업은 공유에 액세스해야 하는 컴퓨터 계정이 포함된 Active Directory 그룹을 만든 다음 공유에 대한 AD 그룹 액세스 권한을 부여하여 수행할 수 있습니다. |
지원 또는 문제 해결
Visual Studio 설치에 실패하는 경우 단계별 지침은 Visual Studio 설치 및 업그레이드 문제 해결을 참조하세요.
추가 지원 옵션:
- 설치 관련 문제를 위한 설치 채팅(영어만 가능) 지원 옵션이 제공됩니다.
- Visual Studio 설치 관리자 및 Visual Studio IDE에 모두 표시되는 문제 보고 도구를 통해 Microsoft에 제품 문제를 보고하십시오. IT 관리자이고 Visual Studio가 설치되어 있지 않은 경우 여기에서 IT 관리자 피드백을(를) 제출할 수 있습니다.
- Visual Studio 개발자 커뮤니티에서 기능을 제안하고, 제품 문제를 추적하고, 답변을 찾습니다.