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

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

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

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

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

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

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

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

Версия	Ссылка	Примечания
Visual Studio 2022	удаленные инструменты	Совместима со всеми версиями Visual Studio 2022. Скачайте версию, соответствующую операционной системе устройства (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 или войдите с помощью ID подписки 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. Сделайте общий доступ к папке удаленного отладчика на компьютере с Visual Studio.

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

Совет

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

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

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

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

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

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

   В большинстве сценариев выбирайте Далее, пока не дойдете до страницы Настройка брандмауэра Windows мастера.

   

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, настроив свойства проекта и запуская отладчик. Дополнительные сведения см. в статье Удаленная отладка проекта C# или Visual Basic или удаленная отладка проекта C++.

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

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

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

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

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

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

3. Отметьте флажок Запустить удаленный отладчик Visual Studio как службу.

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

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

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

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

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

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

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

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

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

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

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

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

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