Partilhar via


Configurar o Firewall do Windows para depuração remota

Em uma rede protegida pelo Firewall do Windows, o firewall deve 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 inicialização, mas você também pode precisar abrir portas ou permitir aplicativos manualmente.

Este tópico descreve como configurar o Firewall do Windows para habilitar a depuração remota no Windows 10, 8/8.1 e 7; e computadores 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 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 diferem ligeiramente em sistemas operacionais diferentes e para versões mais antigas do Windows. O Windows 8/8.1, o Windows 10 e versões mais recentes e as 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 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, procure e abra Firewall do Windows com Segurança Avançada. A partir do Windows 10, este é Firewall do Windows Defender com proteção avançada.

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

  3. No Assistente de Nova Regra de Entrada , selecione a opção Portae, em seguida, clique em 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 das seguintes tabelas e selecione Avançar.

  6. Selecione Permitir a Ligaçãoe, em seguida, selecione Seguinte.

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

  8. Adicione um nome para a regra (por exemplo, msvsmon, IISou Web Deploy) e, em seguida, selecione Concluir.

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

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\18\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe" -LocalPort 4026 -Protocol TCP -Authentication Required -Action Allow

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

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

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

Portos Entrada/Saída Protocolo Descrição
4026 Entrada TCP Para Visual Studio 2022 e versões posteriores. Para mais informações, consulte mapeamento de portas do depurador remoto do Visual Studio.
4025 Entrada TCP Para Visual Studio 2022 e versões posteriores e Serviço de Aplicativo do Microsoft Azure. Esta porta é usada apenas para depurar remotamente um processo de 32 bits de uma versão de 64 bits do depurador remoto. Para mais informações, consulte mapeamento de portas do depurador remoto do Visual Studio.
4024 Entrada TCP Para o Serviço de Aplicações do Microsoft Azure. Para mais informações, consulte mapeamento de portas do depurador remoto do Visual Studio.
3702 Saída UDP (Opcional) Necessário para a descoberta do depurador remoto.

Portas para IPsec e IIS

Se sua diretiva de domínio exigir que a comunicação de rede seja executada por meio de IPsec (Internet Protocol Security), você deverá abrir portas adicionais no Visual Studio e em computadores remotos. Para depurar num Servidor Web remoto do IIS (Serviços de Informações da Internet), abra a porta 80 no computador remoto.

Portos Entrada/Saída Protocolo Descrição
500, 4500 Saída UDP Necessário se a sua política de domínio exigir que a comunicação de rede seja executada através de IPsec.
80 Saída TCP Necessário no computador remoto para depuração do servidor Web.

Para permitir aplicações específicas através da Firewall do Windows, consulte Configurar a depuração remota através da Firewall do Windows.

Permitir o depurador remoto através do Firewall do Windows

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

Para permitir o depurador remoto através do Firewall do Windows:

  1. No menu Iniciar do Windows, procure e abra Firewall do Windowsou Firewall do Windows Defender.

  2. Selecione Permitir uma aplicação através da Firewall do Windows.

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

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

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

  6. Selecione Adicionare, em seguida, selecione OK.

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

Se não conseguir anexar à sua aplicação com o depurador remoto, certifique-se de que as portas, protocolos, tipos de rede e definições da aplicação da firewall de depuração remota estão corretas.

  • No menu Iniciar do Windows, procure e abra Firewall do Windows e selecione Permitir uma aplicação através da Firewall do Windows. Verifique se o Depurador Remoto ou o Depurador Remoto do Visual Studio aparece na lista Aplicações e características permitidas com uma caixa de seleção assinalada e se os tipos de rede corretos estão selecionados. Caso contrário, adicione as aplicações e definições corretas.

  • No menu Iniciar do Windows, procure e abra Firewall do Windows com Segurança Avançada. Verifique se o Depurador Remoto ou o Depurador Remoto do Visual Studio aparece sob Regras de Entrada (e, opcionalmente, Regras de Saída ) com um ícone de marca de verificaçã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. Utilize as guias de Propriedades para habilitar ou desabilitar a regra, ou alterar números de porta, protocolos ou tipos de rede.
    • Se o aplicativo depurador remoto não aparecer na lista de regras, adicionar e configurar as portas corretas.