配置 Windows 防火墙以便进行远程调试

在受 Windows 防火墙保护的网络上，必须将防火墙配置为允许远程调试。 Visual Studio 和远程调试工具会尝试在安装或启动期间打开正确的防火墙端口，但可能还需要手动打开端口或允许应用。

本主题介绍了如何在 Windows 10、8/8.1 和 7 以及 Windows Server 2012 R2、2012 和 2008 R2 计算机上配置 Windows 防火墙，以进行远程调试。 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 和远程调试器会尝试在安装或启动期间打开正确的端口。 但在某些情况下（例如第三方防火墙），可能需要手动打开端口。

打开端口：

1. 在 Windows“开始”菜单中，搜索并打开“高级安全 Windows 防火墙”。 从 Windows 10 开始，则是“高级安全性 Windows Defender 防火墙”。

2. 对于新的传入端口，选择“入站规则”，然后选择“新建规则”。 对于传出端口，则选择“出站规则”。

3. 在“新建入站规则向导”中，选择“端口”，然后选择“下一步”。

4. 根据后面的表中的端口号，选择“TCP”或“UDP”。

5. 在“特定本地端口”下，输入后面的表中的一个端口号，然后选择“下一步”。

6. 选择“允许连接”，然后选择“下一步”。

7. 选择要启用的一种或多种网络类型，包括远程连接的网络类型，然后选择“下一步”。

8. 为规则添加一个名称（例如， msvsmon、IIS 或 Web Deploy），然后选择“完成”。

   新规则应出现在“入站规则”或“出站规则”列表中，且处于选中状态。

使用 PowerShell 打开端口：

对于 Windows 防火墙，你可以使用 PowerShell 命令（如 New-NetFirewallRule）。

以下示例为远程计算机上的远程调试器打开端口 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

远程计算机上支持远程调试的端口

为进行远程调试，必须在远程计算机上打开以下端口：

端口	传入/传出	协议	说明
4026	传入	TCP	对于 Visual Studio 2022。 有关详细信息，请参阅 Visual Studio 远程调试器端口分配。
4025	传入	TCP	适用于 Visual Studio 2022 和 Microsoft Azure 应用服务。 此端口仅用于从 64 位版本的远程调试器中远程调试 32 位进程。 有关详细信息，请参阅 Visual Studio 远程调试器端口分配。
4024	传入	TCP	适用于 Microsoft Azure 应用服务。 有关详细信息，请参阅 Visual Studio 远程调试器端口分配。
3702	传出	UDP	（可选）进行远程调试器发现的必需项。

如果域策略要求通过 Internet 协议安全性 (IPSec) 执行网络通信，则必须在 Visual Studio 和远程计算机上都打开其他端口。 若要在远程 IIS Web 服务器上进行调试，请打开远程计算机上的端口 80。

端口	传入/传出	协议	说明
500, 4500	传出	UDP	如果你的域策略需要通过 IPSec 进行网络通信，则需要。
80	传出	TCP	Web 服务器调试所必需。

若要允许特定应用通过 Windows 防火墙，请参阅配置 Windows 防火墙以进行远程调试。

允许远程调试器通过 Windows 防火墙

配置远程调试器时，配置软件应打开正确的端口。 然而，在某些情况下，可能需要手动允许远程调试器通过防火墙。

若要允许远程调试器通过 Windows 防火墙，请执行以下操作：

1. 在 Windows“开始”菜单中，搜索并打开“Windows 防火墙”或“Windows Defender 防火墙”。

2. 选择“允许应用通过 Windows 防火墙”。

3. 如果远程调试器或Visual Studio 远程调试器未显示在允许的应用程序和功能，选择更改设置，然后选择允许另一个应用。

4. 如果远程调试器应用仍未在“添加应用”对话框中列出，请选择“浏览”，然后导航到 <Visual Studio 安装目录>\Common7\IDE\Remote Debugger\<x86、x64 或 Appx>，具体取决于适用于应用的相应架构。 选择“msvsmon.exe”，然后选择“添加”。

5. 在“应用”列表中，选择刚才添加的远程调试器 。 选择“网络类型”，然后选择一种或多种网络类型，包括远程连接的网络类型。

6. 依次选择“添加”、“确定” 。

远程调试连接故障排除

如果无法使用远程调试器附加到您的应用，请确保远程调试的防火墙端口、协议、网络类型和应用设置均正确无误。

• 在 Windows“开始”菜单中，搜索并打开“Windows 防火墙”，然后选择“允许应用通过 Windows 防火墙”。 请确保“远程调试器”或“Visual Studio 远程调试器”出现在“允许的应用和功能”列表中并且其复选框已选中，同时选择了网络类型。 如果不是这样，请添加正确的应用和设置。

• 在 Windows“开始”菜单中，搜索并打开“高级安全 Windows 防火墙”。 请确保“远程调试器”或“Visual Studio 远程调试器”在“入站规则”和“出站规则”（可选）下显示并带有绿色的复选标记图标，以及确保所有设置正确。

  • 若要查看或更改规则设置，请右键单击列表中的“远程调试器”应用，然后选择“属性” 。 使用“属性”选项卡以启用或禁用规则，或更改端口号、协议或网络类型。
  • 如果远程调试器应用未出现在规则列表中，请添加并配置正确的端口。

相关内容

• 远程调试
• Visual Studio 远程调试器端口分配