Partilhar via


Configurar o Firewall do Windows para depuração remota

Em uma rede protegida pelo Firewall do Windows, o firewall precisa ser configurado para permitir a depuração remota. O Visual Studio e as ferramentas de depuração remota tentam abrir as portas de firewall corretas durante a instalação ou a inicialização, mas talvez você também precise abrir portas ou permitir aplicativos manualmente.

Este tópico descreve como configurar o firewall do Windows para habilitar a depuração remota em computadores Windows 10, 8/8.1 e 7; e em computadores com Windows Server 2012 R2, 2012 e 2008 R2. O Visual Studio e o computador remoto não precisam estar executando o mesmo sistema operacional. Por exemplo, o computador do Visual Studio pode executar o Windows 11 e o computador remoto pode executar o Windows Server 2012 R2.

Observação

As instruções para configurar o Firewall do Windows variam ligeiramente em sistemas operacionais diferentes e em versões mais antigas do Windows. O Windows 8/8.1, o Windows 10 e versões mais recentes, bem como configurações do Windows Server 2012, usam a palavra aplicativo, enquanto o Windows 7 e o Windows Server 2008 usam a palavra programa.

Configurar portas para depuração remota

O Visual Studio e o depurador remoto tentam abrir as portas corretas durante a instalação ou a inicialização. No entanto, em alguns cenários, como um firewall de terceiros, talvez seja necessário abrir portas manualmente.

Para abrir uma porta:

  1. No menu Iniciar do Windows, pesquise e abra o Firewall do Windows com Segurança Avançada. Começando no Windows 10, esse é o Windows Defender Firewall com Segurança Avançada.

  2. Para uma nova porta de entrada, selecione Regras de Entrada e, em seguida, Nova Regra. Para uma regra de saída, selecione Regras de Saída.

  3. No Assistente de Nova Regra de Entrada, selecione Porta e, em seguida, Avançar.

  4. Selecione TCP ou UDP, dependendo do número da porta das tabelas a seguir.

  5. Em Portas locais específicas insira um número de porta nas tabelas a seguir e selecione Avançar.

  6. Selecione Permitir a Conexão e, em seguida, Avançar.

  7. Selecione um ou mais tipos de rede para habilitar, incluindo o tipo de rede para a conexão remota, e selecione Avançar.

  8. Adicione um nome para a regra (por exemplo, msvsmon, IIS, ou Web Deploy), e então selecione Concluir.

    A nova regra deve aparecer e ser selecionada na lista Regras de Entrada ou Regras de Saída.

Para abrir uma porta usando o PowerShell:

Para o Firewall do Windows, você pode usar comandos do PowerShell, como New-NetFirewallRule.

O exemplo a seguir abre a porta 4026 para o depurador remoto no computador remoto. A porta e o caminho que você precisa usar podem ser diferentes.

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

O exemplo a seguir abre a porta 4024 para o depurador remoto no computador remoto. O caminho que você precisa usar pode ser diferente.

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

Portas no computador remoto que habilitam a depuração remota

Para depuração remota, as seguintes portas precisam estar abertas no computador remoto:

Portas Incoming/Outgoing Protocolo Descrição
4026 Entrada TCP Para o Visual Studio 2022. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
4025 Entrada TCP Para o Visual Studio 2022 e o Serviço de Aplicativo do Azure da Microsoft. Essa porta só é usada para depurar remotamente um processo de 32 bits de uma versão de 64 bits do depurador remoto. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
4024 Entrada TCP Para o Serviço de Aplicativo do Microsoft Azure. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
3702 Saída UDP (Opcional) Necessário para a descoberta do depurador remoto.
Portas Incoming/Outgoing Protocolo Descrição
4024 Entrada TCP Para o Visual Studio 2019 e o Serviço de Aplicativo do Azure da Microsoft. O número da porta incrementa em 2 para cada versão do Visual Studio. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
4025 Entrada TCP Para Visual Studio 2019 e Serviço de Aplicativo do Azure. Essa porta só é usada para depurar remotamente um processo de 32 bits de uma versão de 64 bits do depurador remoto. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
3702 Saída UDP (Opcional) Necessário para a descoberta do depurador remoto.

Se você selecionar Usar Modo de Compatibilidade Gerenciada em Ferramentas>Opções>Depuração, abra essas portas adicionais do depurador remoto. O Modo de Compatibilidade Gerenciada do Depurador habilita uma versão herdada, do Visual Studio 2010, do depurador.

Portas Incoming/Outgoing Protocolo Descrição
135, 139, 445 Saída TCP Obrigatórios.
137, 138 Saída UDP Obrigatória.

Se a política de domínio exigir que a comunicação de rede seja executada por meio do protocolo IPsec, você precisará abrir portas adicionais nos computadores remotos e do Visual Studio. Para depurar em um servidor web remoto do Internet Information Services (IIS), abra a porta 80 no computador remoto.

Portas Incoming/Outgoing Protocolo Descrição
500, 4500 Saída UDP Obrigatório se a política de domínio exigir que a comunicação de rede seja executada por meio do IPSec.
80 Saída TCP Necessário para depuração de servidor Web.

Para permitir aplicativos específicos no Firewall do Windows, veja Configurar a depuração remota no Firewall do Windows.

Permitir o depurador remoto no Firewall do Windows

Quando você configura o depurador remoto, o software de configuração deve abrir as portas corretas. No entanto, em alguns cenários, talvez seja necessário permitir o depurador remoto manualmente pelo firewall.

Para permitir o depurador remoto no Firewall do Windows:

  1. No menu Iniciar do Windows, pesquise e abra o Firewall do Windows ou o Windows Defender Firewall.

  2. Selecione Permitir um aplicativo pelo Firewall do Windows.

  3. Se o Depurador Remoto ou o Depurador Remoto do Visual Studio não aparecer em Aplicativos e recursos permitidos, selecione Alterar configurações e, em seguida, Permitir outro aplicativo.

  4. Se o aplicativo de depurador remoto ainda não estiver listado na caixa de diálogo Adicionar um aplicativo, selecione Procurar e navegue até o <diretório de instalação do Visual Studio>\Common7\IDE\Remote Debugger\<x86, x64 ou Appx>, dependendo da arquitetura apropriada para o aplicativo. Selecione msvsmon.exe e Adicionar.

  5. Na lista Aplicativos, selecione o Depurador Remoto que você acabou de adicionar. Selecione Tipos de rede e selecione um ou mais tipos de rede, incluindo o tipo de rede para a conexão remota.

  6. Selecione Adicionar e, em seguida, selecione OK.

Solucionar problemas de conexão da depuração remota

Se não conseguir anexar ao aplicativo com o depurador remoto, verifique se as portas do firewall de depuração remota, os protocolos, os tipos de rede e as configurações do aplicativo estão corretos.

  • No menu Iniciar do Windows, pesquise e abra o Firewall do Windows e selecione Permitir um aplicativo por meio do Firewall do Windows. Verifique se o Depurador Remoto ou o Depurador Remoto do Visual Studio aparece na lista Aplicativos e recursos permitidos com uma caixa de seleção marcada e se os tipos de rede corretos estão selecionados. Se não estiverem, adicione os aplicativos e as configurações corretas.

  • No menu Iniciar do Windows, pesquise e abra o Firewall do Windows com Segurança Avançada. Verifique se o Depurador Remoto ou o Depurador Remoto do Visual Studio aparece em Regras de Entrada (e, opcionalmente, em Regras de Saída) com um ícone de marca de seleção verde e se todas as configurações estão corretas.

    • Para exibir ou alterar as configurações da regra, clique com o botão direito do mouse no aplicativo Depurador Remoto na lista e selecione Propriedades. Use as guias Propriedades para habilitar ou desabilitar a regra ou alterar números de porta, protocolos ou tipos de rede.
    • Se o aplicativo de depurador remoto não aparecer na lista de regras, adicione e configure as portas corretas.