Удаленная отладка

Вы можете выполнить отладку Visual Studio приложения, развернутого на другом компьютере. Чтобы это сделать, используйте удаленную отладку в Visual Studio.

Подробные инструкции по удаленной отладке см. в следующих разделах.

Сценарий	Связь
C# или Visual Basic	Отладка на удаленном компьютере проекта C# или Visual Basic
C++	Удаленная отладка проекта на C++
Azure App Service	Удалённая отладка ASP.NET Core на Azure или для Visual Studio Enterprise Snapshot Debugger
ASP.NET	Remote debug ASP.NET Core или Remote Debug ASP.NET
виртуальная машина Azure	Удаленная отладка ASP.NET на виртуальной машине Azure
Линукс	Debug .NET Core в Linux с помощью SSH путем подключения к процессу
Докер	Присоединение к процессу, работающему в контейнере Docker
Универсальные приложения Windows (UWP)	Запуск приложений UWP на удаленном компьютере или отладка установленного пакета приложений

Если вы просто хотите скачать и установить удаленный отладчик и не нуждаетесь в дополнительных инструкциях по вашему сценарию, выполните действия, описанные в этой статье.

Скачивание и установка удаленных средств

На удаленном устройстве или сервере, на котором требуется выполнить отладку, а не на компьютере Visual Studio, скачайте и установите правильную версию удаленных средств из ссылок в следующей таблице.

• Скачайте последнее обновление средств удаленного доступа для вашей версии Visual Studio. Средства удаленного доступа для Visual Studio 2022 и 2026 можно использовать с любой версией Visual Studio. Однако версии удаленных средств, предшествующие Visual Studio 2022, несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2019, скачайте последнее обновление средств удаленного доступа для Visual Studio 2019 года. В этом сценарии не скачивайте средства удаленного доступа для Visual Studio 2022.)

• Скачайте удаленные средства с той же архитектурой, что и компьютер, на котором вы устанавливаете их. Например, если вы хотите отлаживать приложения x86 на удаленном компьютере под управлением операционной системы x64, установите средства удаленного управления x64. Чтобы выполнить отладку приложений x86, ARM или x64 в операционной системе ARM64, установите удаленные средства ARM64.

Версия	Связь	Примечания
Visual Studio 2026 г.	удаленные инструменты	Совместим с Visual Studio 2022 и более поздними версиями. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. раздел о разблокировке скачивания файлов для получения помощи по скачиванию средств удаленного доступа.
Visual Studio 2022	удаленные инструменты	Удаленные средства для Visual Studio 2022 доступны в My.VisualStudio.com. При появлении запроса присоединитесь к бесплатной программе Visual Studio Dev Essentials или войдите с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. раздел о разблокировке скачивания файлов для получения помощи по скачиванию средств удаленного доступа.
Visual Studio 2019 г.	удаленные инструменты	Средства удаленного доступа для Visual Studio 2019 доступны в My.VisualStudio.com. При появлении запроса присоединитесь к бесплатной программе Visual Studio Dev Essentials или войдите с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. раздел о разблокировке скачивания файлов для получения помощи по скачиванию средств удаленного доступа.
Visual Studio 2017 г.	удаленные инструменты	Средства удаленного доступа для Visual Studio 2017 доступны в My.VisualStudio.com. При появлении запроса присоединитесь к бесплатной программе Visual Studio Dev Essentials или войдите с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2015 г.	удаленные инструменты	Удаленные средства для Visual Studio 2015 доступны в My.VisualStudio.com. При появлении запроса присоединитесь к бесплатной программе Visual Studio Dev Essentials или войдите с помощью идентификатора подписки Visual Studio. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2013 г.	удаленные инструменты	Страница загрузки в документации по Visual Studio 2013
Visual Studio 2012 г.	удаленные инструменты	Страница скачивания в документации по Visual Studio 2012 г.

Вы можете запустить удаленный отладчик, скопировав msvsmon.exe на удаленный компьютер, а не установив удаленные средства. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только при установке удаленных средств. Если вы хотите запустить удаленный отладчик в качестве службы, может потребоваться использовать мастер настройки. Дополнительные сведения см. в разделе (необязательно) Настройка удаленного отладчика в качестве службы.

Заметка

• Для отладки Windows 10 или более поздних версий приложений на устройствах ARM используйте ARM64, которая доступна с последней версией удаленных средств.
• Для отладки приложений Windows 10 на устройствах Windows RT используйте ARM, который доступен только в составе средств удаленного доступа Visual Studio 2015, доступных для скачивания.
• Чтобы выполнить отладку приложений x64 в операционной системе ARM64, запустите x64 msvsmon.exe, установленный вместе с удаленными средствами ARM64.

Требования

Поддерживаемые операционные системы

Удаленный компьютер должен работать под управлением одной из следующих операционных систем:

• Windows 11

• Windows 10 (не телефон)

• Windows 8 или 8.1 (не телефон)

• Windows 7 с пакетом обновления 1 (SP1)

• Windows Server 2016

• Windows Server 2012 или Windows Server 2012 R2

• Windows Server 2008 с пакетом обновления 2 (SP2), Windows Server 2008 R2 с пакетом обновления 1 (SP1)

Поддерживаемые конфигурации оборудования

• 1,6 ГГц или более быстрый процессор

• 1 ГБ ОЗУ (1,5 ГБ при выполнении на виртуальной машине)

• 1 ГБ доступного места на жестком диске

• Жесткий диск 54000-RPM

• Видеоадаптер с поддержкой DirectX 9 с разрешением 1024 x 768 или более поздней версии

Конфигурация сети

Удаленный компьютер и компьютер Visual Studio должны быть подключены через сеть, рабочую группу или домашнюю группу или подключиться напрямую через кабель Ethernet. Отладка между двумя компьютерами, подключенными через прокси-сервер, не поддерживается. Отладка при высокой задержке и низкой пропускной способности, например, при дозвоне через Интернет или в Интернете между разными странами/регионами, не рекомендуется, так как это может не сработать или быть недопустимо медленным.

(Необязательно) Запуск удаленного отладчика из общей папки

Удаленный отладчик (msvsmon.exe) можно найти на компьютере с уже установленным Visual Studio Community, Professional или Enterprise. В некоторых сценариях самый простой способ настройки удаленной отладки — запустить удаленный отладчик (msvsmon.exe) из общей папки. Сведения об ограничениях использования см. в разделе справки удаленного отладчика (Справка Использование в удаленном отладчике).

1. Найдите msvsmon.exe в каталоге, соответствующий вашей версии 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. Поделитесь папкой Remote Debugger на компьютере Visual Studio.

3. На удаленном компьютере запустите msvsmon.exe из общей папки. Следуйте инструкциям по настройке .

Совет

Справочник по установке через командную строку и справочник командной строки см. на странице справки msvsmon.exe, введя msvsmon.exe /? в командной строке на компьютере с установленной Visual Studio (или перейдите к Справка > Использование в удаленном отладчике).

Настройка удаленного отладчика

1. На удаленном компьютере найдите и запустите Удаленный отладчик из меню "Пуск".

   Если у вас нет административных разрешений на удаленном компьютере, щелкните правой кнопкой мыши приложение удаленного отладчика и выберите запустить от имени администратора. В противном случае просто запустите его нормально.

   Если вы планируете подключиться к процессу, запущенному с правами администратора или под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши на приложении Удаленный отладчик и выберите Запуск от имени администратора. Дополнительные сведения см. в статье Запуск удаленного отладчика в качестве администратора.

2. При первом запуске удаленного отладчика (или до его настройки) появится мастер конфигурации для удаленной отладки .

   В большинстве сценариев выберите "Настроить удаленную отладку".

   Снимок экрана конфигурации удаленного отладчика.Конфигурация удаленного отладчика.

3. Выберите хотя бы один тип сети, в который вы хотите использовать удаленные средства. Если компьютеры подключены через домен, необходимо выбрать первый элемент. Если компьютеры подключены через рабочую или домашнюю группу, выберите второй или третий элемент соответствующим образом.

   Затем нажмите кнопку Готово, чтобы запустить удаленный отладчик.

4. После завершения настройки появится окно удаленного отладчика.

   снимок экрана: окно удаленного отладчикаокно удаленного отладчика

   Теперь удаленный отладчик ожидает подключения. Используйте имя сервера и номер порта, показанные для установки конфигурации удаленного подключения в Visual Studio.

Чтобы остановить удаленный отладчик, выберите ФайлВыйти. Его можно перезапустить из меню "Пуск" или из командной строки:

<Remote debugger installation directory>\msvsmon.exe

Настройка удаленного отладчика

После первого запуска можно изменить некоторые аспекты конфигурации удаленного отладчика.

• Если вам нужно добавить разрешения для подключения других пользователей к удаленному отладчику, выберите Инструменты Разрешения. У вас должны быть права администратора, чтобы предоставить или запретить разрешения.

  Важный

  Вы можете запустить удаленный отладчик под учетной записью пользователя, которая отличается от учетной записи пользователя, используемой на компьютере Visual Studio, но необходимо добавить другую учетную запись пользователя в разрешения удаленного отладчика.

  Кроме того, можно запустить удаленный отладчик из командной строки с параметром /allow имени пользователя: msvsmon /allow username@computer.

• Если необходимо изменить режим аутентификации или номер порта, или указать значение времени ожидания для удаленных средств: выберите Инструменты Параметры.

  Список номеров портов, используемых по умолчанию, см. в разделе назначения портов удаленного отладчика.

  Предупреждение

  Вы можете запустить удаленные средства в режиме без проверки подлинности, но этот режим настоятельно не рекомендуется. При выполнении в этом режиме сетевой безопасности нет. Выберите режим "Нет проверки подлинности", только если вы уверены, что сеть не подвержена риску от вредоносного или враждебного трафика.

Настройка Visual Studio для удаленной отладки

Подробные инструкции по подключению к приложению из Visual Studio можно найти, используя ссылки, связанные с вашим конкретным сценарием, в начале этой статьи.

Для некоторых сценариев требуется использование 'Attach to Process' для подключения к удаленному приложению, которое уже запущено. Однако для приложений .NET Core .NET 5+, .NET Framework и C++ можно запустить удаленное приложение из Visual Studio, настроив свойства project и запуская отладчик. Дополнительные сведения см. в статьях Удаленная отладка проекта на C# или Visual Basic или Удаленная отладка проекта на C++.

Вы также можете удаленно отлаживать исполняемый файл, который не является частью Visual Studio project, хотя поддерживаемые функции отладки зависят от конфигурации, например доступности символов. Дополнительные сведения см. в разделе Отладка приложения, которое не входит в решение Visual Studio.

(Необязательно) Настройка удаленного отладчика в качестве службы

Для отладки в ASP.NET и других серверных средах необходимо запустить удаленный отладчик в качестве администратора или, если требуется, чтобы он всегда выполнялся, запустите удаленный отладчик в качестве службы.

Если вы хотите настроить удаленный отладчик в качестве службы, выполните следующие действия.

1. Найдите мастер настройки удаленного отладчика (rdbgwiz.exe). (Это отдельное приложение от удаленного отладчика.) Он доступен только при установке удаленных средств. Он не установлен с Visual Studio.

2. Запустите мастер настройки. Когда появится первая страница, нажмите кнопку Далее.

3. Установите флажок Run the Visual Studio Remote Debugger as a service.

4. Добавьте имя учетной записи пользователя и пароля.

   Возможно, потребуется добавить право входа в качестве службы для этой учетной записи. Найдите локальную политику безопасности (secpol.msc) на странице или в окне Пуск (или введите secpol в командной строке). Когда появится окно, дважды щелкните назначение пользовательских прав, а затем найдите вход в качестве службы в правой области. Дважды щелкните его. Добавьте учетную запись пользователя в окно свойств и нажмите кнопку ОК). Нажмите кнопку Далее.

5. Выберите тип сети, с которой нужно взаимодействовать с удаленными средствами. Необходимо выбрать по крайней мере один тип сети. Если компьютеры подключены через домен, следует выбрать первый элемент. Если компьютеры подключены через рабочую группу или домашнюю группу, следует выбрать второй или третий элементы. Нажмите кнопку Далее.

6. Если служба может быть запущена, вы увидите сообщение: Вы успешно завершили мастер настройки удалённого отладчика Visual Studio. Если служба не может быть запущена, вы увидите Не удалось завершить работу мастера настройки удаленного отладчика Visual Studio. На странице также приводятся некоторые советы для запуска службы.

7. Нажмите кнопку Готово.

   На этом этапе удаленный отладчик работает в качестве службы. Это можно проверить, перейдя в Control Panel > Services и найдите удаленный отладчик Visual Studio.

   Вы можете остановить и запустить службу удаленного отладчика из Control Panel > Services.

Настройка отладки с помощью удаленных символов

Вы должны иметь возможность отлаживать код с помощью символов, которые вы создаете на компьютере Visual Studio. Производительность удаленного отладчика гораздо лучше при использовании локальных символов. Если необходимо использовать удаленные символы, нужно указать удаленному монитору отладки, чтобы он искал символы на удаленном компьютере.

Чтобы использовать удаленные символы для управляемого кода, можно использовать следующий параметр командной строки msvsmon:

Дополнительные сведения см. в справке по удаленной отладке (нажмите F1 в окне удаленного отладчика или щелкните Справка Использование).

Связанное содержимое

• Первый взгляд на отладчик
• настройка брандмауэра Windows для удаленной отладки
• Назначения портов удалённого отладчика
• Удаленная отладка ASP.NET Core на удаленном компьютере IIS
• ошибки удаленной отладки и устранение неполадок