Depuração remota

Você pode depurar um aplicativo do Visual Studio que foi implantado em um computador diferente. Para fazer isso, use o depurador remoto do Visual Studio.

Para obter instruções detalhadas sobre depuração remota, consulte estes tópicos.

Se você quiser apenas baixar e instalar o depurador remoto e não precisar de instruções adicionais para seu cenário, siga as etapas neste artigo.

Baixar e instalar as ferramentas remotas

No dispositivo ou servidor remoto no qual você deseja depurar, em vez do computador Visual Studio, baixe e instale a versão correta das ferramentas remotas dos links na tabela a seguir.

• Baixe as ferramentas remotas com a mesma arquitetura do computador em que você as está instalando. Por exemplo, se você quiser depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas ARM64.

Você pode executar o depurador remoto copiando msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas. No entanto, o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe) só está disponível quando você instala as ferramentas remotas. Talvez seja necessário usar o assistente para a configuração se você quiser executar o depurador remoto como um serviço. Para obter mais informações, veja (Opcional) Configurar o depurador remoto como um serviço.

Requisitos

Sistemas operacionais com suporte

O computador remoto deve estar executando um dos seguintes sistemas operacionais:

• Windows 11

• Windows 10 (não telefone)

• Windows 8 ou 8.1 (não telefone)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 ou Windows Server 2012 R2

• Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Configurações de hardware com suporte

• Processador de 1,6 GHz ou mais rápido

• 1 GB de RAM (1,5 GB se estiver em execução em uma máquina virtual)

• 1 GB de espaço em disco rígido disponível

• Disco rígido de 5400 RPM

• Placa de vídeo compatível com DirectX 9 em execução em resolução de exibição 1024 x 768 ou superior

Configuração de rede

O computador remoto e o computador Visual Studio devem ser conectados por uma rede, grupo de trabalho ou homegroup ou então conectado diretamente por meio de um cabo Ethernet. Não há suporte para a depuração entre dois computadores conectados por meio de um proxy. A depuração por uma conexão de alta latência ou pouca largura de banda, como Internet discada ou pela Internet entre países/regiões, não é recomendada e pode falhar ou ser inaceitavelmente lenta.

(Opcional) Para executar o depurador remoto de um compartilhamento de arquivos

Você pode encontrar o depurador remoto (msvsmon.exe) em um computador com Visual Studio Community, Professional ou Enterprise já instalado. Para alguns cenários, a maneira mais fácil de configurar a depuração remota é executar o depurador remoto (msvsmon.exe) de um compartilhamento de arquivos. Para obter limitações de uso, consulte a página de Ajuda do depurador remoto (Ajuda Uso no depurador remoto).

1. Localize msvsmon.exe no diretório que corresponde à sua versão do Visual Studio:

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Compartilhe a pasta Depurador Remoto no computador do Visual Studio.

3. No computador remoto, execute msvsmon.exe da pasta compartilhada. Siga as instruções de instalação .

Configurar o depurador remoto

1. No computador remoto, localize e inicie o Depurador Remoto no menu Iniciar.

   Se você não tiver permissões administrativas no computador remoto, clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Caso contrário, basta iniciá-lo normalmente.

   Se você estiver planejando se conectar a um processo em execução como administrador ou em execução em uma conta de usuário diferente (como o IIS), clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Para obter mais informações, confira Executar o depurador remoto como administrador.

2. Na primeira vez que você iniciar o depurador remoto (ou antes de configurá-lo), o assistente de Configuração de Depuração Remota é exibido.

   Na maioria dos cenários, selecione Configurar depuração remota.

   Captura de tela da configuração do depurador remoto.Configuração do Depurador Remoto

   Na maioria dos cenários, escolha Avançar até chegar à página do assistente Configurar o Firewall do Windows.

   Captura de tela da configuração do depurador remoto.Configuração do Depurador Remoto

3. Selecione pelo menos um tipo de rede em que você deseja usar as ferramentas remotas. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou homegroup, escolha o segundo ou terceiro item conforme apropriado.

   Depois, selecione Concluir para iniciar o depurador remoto.

4. Quando a configuração for concluída, a janela Depurador Remoto será exibida.

   Captura de tela da janela do depurador remotoJanela Depurador Remoto

   Captura de tela da janela do depurador remotoJanela Depurador Remoto

   Agora o depurador remoto está aguardando uma conexão. Use o nome do servidor e o número da porta mostrados para definir a configuração de conexão remota em Visual Studio.

Para interromper o depurador remoto, selecioneArquivoSair. Você pode reiniciá-lo no menu Iniciar ou na linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Configurar o depurador remoto

Você pode alterar alguns aspectos da configuração do depurador remoto depois de iniciá-lo pela primeira vez.

• Se você precisar adicionar permissões para que outros usuários se conectem ao depurador remoto, escolha Ferramentas Permissões. Você deve ter privilégios de administrador para conceder ou negar permissões.

  Importante

  Você pode executar o depurador remoto em uma conta de usuário diferente da conta de usuário que você está usando no computador Visual Studio, mas deve adicionar a conta de usuário diferente às permissões do depurador remoto.

  Como alternativa, você pode iniciar o depurador remoto na linha de comando com o parâmetro /allow nome de usuário: msvsmon /allow username@computer.

• Se você precisar alterar o modo de Autenticação ou o número da porta ou especificar um valor de tempo limite para as ferramentas remotas: escolha Ferramentas Opções.

  Para obter uma listagem dos números de porta usados por padrão, consulte Atribuições de porta do depurador remoto.

  Aviso

  Você pode optar por executar as ferramentas remotas no modo Sem Autenticação, mas esse modo é altamente desencorajado. Não há segurança de rede ao executar nesse modo. Escolha o modo Sem Autenticação somente se você tiver certeza de que a rede não está em risco de tráfego mal-intencionado ou hostil.

Configurar Visual Studio para depuração remota

Para obter instruções detalhadas para se conectar ao aplicativo de Visual Studio, use os links relacionados ao seu cenário específico no início deste artigo.

Alguns cenários exigem o uso de Anexar ao Processo para se conectar a um aplicativo remoto que já foi iniciado. No entanto, para aplicativos .NET Core, .NET 5+, .NET Framework e C++, você pode iniciar o aplicativo remoto a partir do Visual Studio configurando as propriedades do projeto e iniciando o depurador. Para obter mais informações, consulte Depurar remotamente um projeto C# ou Visual Basic ou Depurar remotamente um projeto C++.

Você também pode depurar remotamente um executável que não faz parte de um projeto do Visual Studio, embora os recursos de depuração com suporte dependam da configuração, como a disponibilidade de símbolos. Para obter mais informações, consulte Depurar um aplicativo que não faz parte de uma solução Visual Studio.

(Opcional) Configurar o depurador remoto como um serviço

Para depuração no ASP.NET e em outros ambientes de servidor, você deve executar o depurador remoto como administrador ou, se desejar que ele esteja sempre em execução, execute o depurador remoto como um serviço.

Se você quiser configurar o depurador remoto como um serviço, siga estas etapas.

1. Localize o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe). (Este é um aplicativo separado do Depurador Remoto.) Ele só está disponível quando você instala as ferramentas remotas. Ele não está instalado com Visual Studio.

2. Comece a executar o assistente de configuração. Quando a primeira página aparecer, clique em Avançar.

3. Marque a caixa de seleção Execute o depurador remoto do Visual Studio como um serviço.

4. Adicione o nome da conta de usuário e da senha.

   Talvez seja necessário adicionar o direito fazer logon como um usuário de serviço nessa conta (Localizar Política de Segurança Local (secpol.msc) na página ou janela Iniciar (ou digitar secpol em um prompt de comando). Quando a janela for exibida, clique duas vezes em Atribuição de Direitos de Usuário e, em seguida, localize Logon como um serviço no painel direito. Clique duas vezes nele. Adicione a conta de usuário à janela Propriedades e clique em OK). Clique em Avançar.

5. Selecione o tipo de rede com o qual você deseja que as ferramentas remotas se comuniquem. Pelo menos um tipo de rede deve ser selecionado. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupo doméstico, você deve escolher o segundo ou o terceiro itens. Clique em Avançar.

6. Se o serviço puder ser iniciado, você verá Você concluiu com êxito o Assistente de Configuração do Depurador Remoto do Visual Studio. Se o serviço não puder ser iniciado, você verá Falha ao concluir o Assistente de Configuração do Depurador Remoto Visual Studio. A página também fornece algumas dicas a seguir para que o serviço seja iniciado.

7. Clique em Finalizar.

   Neste ponto, o depurador remoto está em execução como um serviço. Você pode verificar isso acessando Control Panel > Services e procurando Visual Studio Depurador Remoto.

   Você pode parar e iniciar o serviço de depurador remoto do Painel de Controle > Serviços.

Configurar a depuração com símbolos remotos

Você deve ser capaz de depurar seu código com os símbolos gerados no computador Visual Studio. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais. Caso seja necessário usar símbolos remotos, você precisará instruir o monitor de depuração remota a procurar símbolos no computador remoto.

Você pode usar a seguinte opção de linha de comando msvsmon para usar símbolos remotos para código gerenciado:

Para obter mais informações, consulte a ajuda de depuração remota (pressione F1 na janela do depurador remoto ou clique em Ajuda Como usar).

Conteúdo relacionado

• Introdução ao depurador
• Configurar o Firewall do Windows para Depuração Remota
• Atribuições de porta do depurador remoto
• Depuração Remota de ASP.NET Core em um Computador IIS Remoto
• Erros e solução de problemas de depuração remota