Windows 방화벽으로 보호되는 네트워크에서는 원격 디버깅을 허용하도록 방화벽을 구성해야 합니다. Visual Studio 및 원격 디버깅 도구는 설치 또는 시작 중에 올바른 방화벽 포트를 열려고 하지만 포트를 열거나 앱을 수동으로 허용해야 할 수도 있습니다.
이 항목에서는 Windows 10, 8/8.1 및 7에서 원격 디버깅을 사용하도록 Windows 방화벽을 구성하는 방법에 대해 설명합니다. 및 Windows Server 2012 R2, 2012 및 2008 R2 컴퓨터 Visual Studio 및 원격 컴퓨터는 동일한 운영 체제를 실행할 필요가 없습니다. 예를 들어 Visual Studio 컴퓨터는 Windows 11을 실행할 수 있고 원격 컴퓨터는 Windows Server 2012 R2를 실행할 수 있습니다.
메모
Windows 방화벽을 구성하는 지침은 운영 체제 및 이전 버전의 Windows에서 약간 다릅니다. Windows 8/8.1, Windows 10 이상 버전 및 Windows Server 2012 설정에서는 앱단어를 사용하고 Windows 7 및 Windows Server 2008에서는 프로그램사용합니다.
원격 디버깅을 위한 포트 구성
Visual Studio 및 원격 디버거는 설치 또는 시작 중에 올바른 포트를 열려고 합니다. 그러나 타사 방화벽과 같은 일부 시나리오에서는 포트를 수동으로 열어야 할 수 있습니다.
포트를 열려면 다음을 수행합니다.
Windows 시작 메뉴에서 고급 보안 Windows 방화벽을 검색하고 엽니다. Windows 10부터 고급 보안 Windows Defender 방화벽을.
새 들어오는 포트의 경우 인바운드 규칙 선택한 다음 새 규칙선택합니다. 나가는 규칙의 경우 아웃바운드 규칙 선택합니다.
새 인바운드 규칙 마법사에서 포트를 선택한 다음 다음을 선택합니다.
다음 표의 포트 번호에 따라 TCP 또는 UDP 선택합니다.
특정 로컬 포트에서 아래의 테이블 중 하나에서 포트 번호를 입력하고 다음을(를) 선택합니다.
연결 허용을 선택하고, 다음을 선택합니다.
원격 연결에 대한 네트워크 유형을 포함하여 사용하도록 설정할 네트워크 유형을 하나 이상 선택한 다음 다음선택합니다.
규칙의 이름(예:
msvsmon,IIS또는Web Deploy)을 추가한 다음, 을(를) 선택하고마침을 클릭합니다.인바운드 규칙 또는 아웃바운드 규칙 목록에 새 규칙이 표시되고 선택되어야 합니다.
PowerShell을 사용하여 포트를 열려면 다음을 수행합니다.
Windows 방화벽의 경우 New-NetFirewallRule 같은 PowerShell 명령을 사용할 수 있습니다.
다음 예제에서는 원격 컴퓨터의 원격 디버거에 대한 포트 4026을 엽니다. 사용해야 하는 포트와 경로가 다를 수 있습니다.
New-NetFirewallRule -DisplayName "msvsmon" -Direction Inbound -Program "Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe" -LocalPort 4026 -Protocol TCP -Authentication Required -Action Allow
다음 예제에서는 원격 컴퓨터의 원격 디버거에 대한 포트 4024를 엽니다. 사용해야 하는 경로가 다를 수 있습니다.
New-NetFirewallRule -DisplayName "msvsmon" -Direction Inbound -Program "Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe" -LocalPort 4024 -Protocol TCP -Authentication Required -Action Allow
원격 디버깅을 사용하도록 설정하는 원격 컴퓨터의 포트
원격 디버깅의 경우 원격 컴퓨터에서 다음 포트를 열어야 합니다.
| 포트 | 들어오는/나가는 | 프로토콜 | 설명 |
|---|---|---|---|
| 4026 | 들어오는 | TCP | Visual Studio 2022의 경우 자세한 내용은 Visual Studio 원격 디버거 포트 할당 안내를 참조하세요. |
| 4025 | 들어오는 | TCP | Visual Studio 2022 및 Microsoft Azure App Service의 경우 이 포트는 64비트 버전의 원격 디버거에서 32비트 프로세스를 원격 디버그하는 데만 사용됩니다. 자세한 내용은 Visual Studio 원격 디버거 포트 할당 을 참조하세요. |
| 4024 | 수신 | TCP | Microsoft Azure App Service의 경우 자세한 내용은 Visual Studio 원격 디버거 포트 할당 을참조하세요. |
| 3702 | 나가는 | UDP | (선택 사항) 원격 디버거 검색에 필요합니다. |
| 포트 | 들어오는/나가는 | 프로토콜 | 설명 |
|---|---|---|---|
| 4024 | 들어오는 | TCP | Visual Studio 2019 및 Microsoft Azure App Service의 경우 각 Visual Studio 버전에 대해 포트 번호가 2씩 증가합니다. 자세한 내용은 Visual Studio 원격 디버거 포트 할당에 대한 정보는 를 참조하세요.. |
| 4025 | 들어오는 | TCP | Visual Studio 2019 및 Azure App Service의 경우 이 포트는 64비트 버전의 원격 디버거에서 32비트 프로세스를 원격 디버그하는 데만 사용됩니다. 자세한 내용은 Visual Studio 원격 디버거 포트 할당 을(를) 참조하세요. |
| 3702 | 외향적인 | UDP | (선택 사항) 원격 디버거 검색에 필요합니다. |
도구>옵션>디버깅에서 관리되는 호환성 모드을 선택한 경우 이러한 추가 원격 디버거 포트를 엽니다. 디버거 관리 호환 모드를 사용하면 레거시 Visual Studio 2010 버전의 디버거를 사용할 수 있습니다.
| 포트 | 들어오는/나가는 | 프로토콜 | 설명 |
|---|---|---|---|
| 135, 139, 445 | 나가는 | TCP | 필수. |
| 137, 138 | 나가는 | UDP | 필수. |
도메인 정책에서 IPsec(인터넷 프로토콜 보안)을 통해 네트워크 통신을 수행해야 하는 경우 Visual Studio 및 원격 컴퓨터 모두에서 추가 포트를 열어야 합니다. 원격 IIS(인터넷 정보 서비스) 웹 서버에서 디버그하려면 원격 컴퓨터에서 포트 80을 엽니다.
| 포트 | 들어오는/나가는 | 프로토콜 | 설명 |
|---|---|---|---|
| 500, 4500 | 외향적인 | UDP | 도메인 정책에서 IPsec을 통해 네트워크 통신을 수행해야 하는 경우 필요합니다. |
| 80 | 나가는 | TCP | 웹 서버 디버깅에 필요합니다. |
Windows 방화벽을 통해 특정 앱을 허용하려면 Windows 방화벽통해 원격 디버깅 구성을 참조하세요.
Windows 방화벽을 통해 원격 디버거 허용
원격 디버거 을(를)구성할 때, 구성 소프트웨어는 올바른 포트를 열어야 합니다. 그러나 일부 시나리오에서는 방화벽을 통해 원격 디버거를 수동으로 허용해야 할 수 있습니다.
Windows 방화벽을 통해 원격 디버거를 허용하려면 다음을 수행합니다.
Windows 시작 메뉴에서 윈도우 방화벽 을 검색하여 열거나 Windows Defender 방화벽 을 여세요.
Windows 방화벽을 통해 앱을 허용선택합니다.
원격 디버거 또는 Visual Studio 원격 디버거가 허용된 앱 및 기능목록에 표시되지 않는 경우, 설정 변경을 선택한 다음, 다른 앱 허용을 선택합니다.
원격 디버거 앱이 여전히 앱 추가 대화 상자에 나열되지 않은 경우, 찾아보기를 선택하고 앱의 적절한 아키텍처에 따라 <Visual Studio 설치 디렉터리>\Common7\IDE\Remote Debugger\<x86, x64또는 Appx>로 이동합니다. msvsmon.exe선택한 다음 추가를 선택합니다.
앱 목록에서 방금 추가한 원격 디버거 선택합니다. 네트워크 유형을 선택한 다음 원격 연결에 대한 네트워크 유형을 포함하여 하나 이상의 네트워크 유형을 선택합니다.
추가를 선택하고, 확인을 선택합니다.
원격 디버깅 연결 문제 해결
원격 디버거를 사용하여 앱에 연결할 수 없는 경우 원격 디버깅 방화벽 포트, 프로토콜, 네트워크 유형 및 앱 설정이 모두 올바른지 확인합니다.
Windows 시작 메뉴에서 windows 방화벽 검색하고 열고 Windows 방화벽 통해 앱 허용선택합니다. 네트워크 유형이 올바르게 선택되고, 선택된 확인란으로 원격 디버거 또는 Visual Studio 원격 디버거가 허용된 앱 및 기능 목록에 표시되어 있는지 확인하십시오. 그렇지 않은 경우 올바른 앱 및 설정을 추가할있습니다.
Windows 시작 메뉴에서 고급 보안 Windows 방화벽을 검색하고 엽니다. 원격 디버거 또는 Visual Studio 원격 디버거가 녹색 확인 표시 아이콘과 함께 인바운드 규칙(또는 필요 시 아웃바운드 규칙) 항목 아래에 표시되고, 모든 설정이 올바른지 확인합니다.
- 규칙 설정을 보거나 변경하려면 목록에서 원격 디버거 앱을 마우스 오른쪽 단추로 클릭하고 속성선택합니다. 속성 탭을 사용하여 규칙을 사용하거나 사용하지 않도록 설정하거나 포트 번호, 프로토콜 또는 네트워크 유형을 변경합니다.
- 원격 디버거 앱이 규칙 목록에 표시되지 않으면 올바른 포트를 추가하고구성하세요.
관련 콘텐츠
- 원격 디버깅
- Visual Studio 원격 디버거 포트 할당