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 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 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 do Visual Studio pode executar o Windows 11 e o computador remoto pode executar o Windows Server 2012 R2.

Nota

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

Configurar portas para debugging remoto

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, pesquise e abra o Firewall do Windows com Segurança Avançada. Começando no Windows 10, esse é o Microsoft Defender Firewall com Segurança Avançada.

2. Para uma nova porta de entrada, selecione Regras de Entrada e selecione 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 Próximo.

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

   A nova regra deve aparecer e ser selecionada na lista Regras de entrada, ou na lista 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

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

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

Portas	Entrada/Saída	Protocolo	Descrição
4026	Recebendo	TCP	Para 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 Microsoft Azure. Essa porta é usada apenas 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 Azure. Para obter mais informações, consulte Atribuições de porta do depurador remoto do Visual Studio.
3702	Extrovertido	UDP	(Opcional) Necessário para a descoberta do depurador remoto.

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

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

Para permitir aplicativos específicos por meio do Firewall do Windows, confira Configurar a depuração remota por meio do Firewall do Windows.

Permitir o depurador remoto por meio do 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 manualmente o depurador remoto através do firewall.

Para permitir o depurador remoto por meio do 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 por meio do Firewall do Windows.

3. Caso Depurador Remoto ou Depurador Remoto do Visual Studio não apareça em Aplicativos e recursos permitidos, selecione Alterar configuraçõese depois selecione 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.exee selecione Adicionar.

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

6. Selecione Adicionare selecione OK.

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

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

• No menu Iniciar do Windows, pesquise e abra o Firewall do Windows e selecione Permitir um aplicativo por meio do Firewall do Windows. Certifique-se de que Depurador Remoto ou Depurador Remoto do Visual Studio aparece na lista Aplicativos e recursos permitidos com a caixa de seleção marcada e que os tipos de rede corretos estão selecionados. Caso contrário, 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 sob Regras de Entrada (e, opcionalmente, Regras de Saída) com um ícone de marca de seleção verde e que 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.

Conteúdo relacionado

• Depuração remota
• Atribuições de porta do depurador remoto do Visual Studio