Vzdálené ladění

Můžete ladit Visual Studio aplikaci, která byla nasazena na jiném počítači. Tak to provedete pomocí vzdáleného ladicího programu Visual Studio.

Podrobné pokyny ke vzdálenému ladění najdete v těchto tématech.

Scénář	Odkaz
C# nebo Visual Basic	Vzdálené ladění projektu C# nebo Visual Basic
C++	Vzdálené ladění C++ projektu
Azure App Service	Vzdálené ladění ASP.NET Core na Azure nebo pro Visual Studio Enterprise Snapshot Debugger
ASP.NET	Remote debug ASP.NET Core nebo Remote Debug ASP.NET
virtuální počítač Azure	Odstraňování chyb na dálku v ASP.NET na virtuálním počítači Azure
Linux	Debug .NET Core v Linuxu pomocí SSH připojením k procesu
Docker	Připojení k procesu spuštěného v kontejneru Dockeru
Univerzální aplikace pro Windows (UPW)	Spuštění aplikací pro UPW na vzdáleném počítači nebo Ladění nainstalovaného balíčku aplikace

Pokud chcete jenom stáhnout a nainstalovat vzdálený ladicí program a nepotřebujete žádné další pokyny pro váš scénář, postupujte podle kroků v tomto článku.

Stažení a instalace vzdálených nástrojů

Na vzdáleném zařízení nebo serveru, na které chcete ladit, místo Visual Studio počítače stáhněte a nainstalujte správnou verzi vzdálených nástrojů z odkazů v následující tabulce.

• Stáhněte si nejnovější aktualizaci vzdálených nástrojů pro vaši verzi Visual Studio. Vzdálené nástroje pro Visual Studio 2022 a 2026 je možné použít s některou verzí Visual Studio. Verze vzdálených nástrojů starší než Visual Studio 2022 ale nejsou kompatibilní s novějšími verzemi Visual Studio. (Pokud například používáte Visual Studio 2019, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2019. V tomto scénáři nestahujte vzdálené nástroje pro Visual Studio 2022.)

• Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit aplikace x86 na vzdáleném počítači s operačním systémem x64, nainstalujte vzdálené nástroje x64. Pokud chcete ladit aplikace x86, ARM nebo x64 v operačním systému ARM64, nainstalujte vzdálené nástroje ARM64.

Verze	Odkaz	Poznámky
Visual Studio 2026	Vzdálené nástroje	Kompatibilní s Visual Studio 2022 a novějšími verzemi. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2022	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2022 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2019	Vzdálené nástroje	Nástroje pro vzdálenou práci pro Visual Studio 2019 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2017	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2017 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na Windows Serveru najdete informace Odblokování stahování souboru nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2015	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Na Windows Serveru najdete informace Odblokování stahování souboru nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2013	Vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače, nikoli instalací vzdálených nástrojů. Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe) je však k dispozici pouze při instalaci vzdálených nástrojů. Pokud chcete spustit vzdálený ladicí program jako službu, možná budete muset použít průvodce pro konfiguraci. Další informace naleznete v tématu (volitelné) Konfigurace vzdáleného ladění jako služby.

Poznámka

• K ladění Windows 10 nebo novějších aplikací na zařízeních ARM použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit Windows 10 aplikace na zařízeních Windows RT, použijte ARM, který je k dispozici pouze ve stažení vzdálených nástrojů Visual Studio 2015.
• Pokud chcete ladit aplikace x64 v operačním systému ARM64, spusťte msvsmon.exe x64 nainstalované se vzdálenými nástroji ARM64.

Požadavky

Podporované operační systémy

Na vzdáleném počítači musí být spuštěný jeden z následujících operačních systémů:

• Windows 11

• Windows 10 (ne telefon)

• Windows 8 nebo 8.1 (ne telefon)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 nebo Windows Server 2012 R2

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

Podporované konfigurace hardwaru

• Procesor 1,6 GHz nebo rychlejší

• 1 GB paměti RAM (1,5 GB, pokud běží na virtuálním počítači)

• 1 GB volného místa na pevném disku

• Pevný disk s 5400 RPM

• Grafická karta s rozhraním DirectX 9 běžící na rozlišení 1024 x 768 nebo vyšší

Konfigurace sítě

Vzdálený počítač a počítač Visual Studio musí být připojené přes síť, pracovní skupinu nebo domácí skupinu nebo musí být připojené přímo přes ethernetový kabel. Odlaďování mezi dvěma počítači připojenými přes proxy server není podporováno. Ladění přes připojení s vysokou latencí nebo nízkou šířkou pásma, jako je například vytáčené připojení k Internetu, nebo přes Internet mezi různými zeměmi či regiony, se nedoporučuje a může selhat nebo být nepřijatelně pomalé.

(Volitelné) Spuštění vzdáleného ladicího programu ze sdílené složky

Vzdálený ladicí program (msvsmon.exe) najdete na počítači s již nainstalovaným nástrojem Visual Studio Community, Professional nebo Enterprise. V některých scénářích je nejjednodušším způsobem, jak nastavit vzdálené ladění, spustit vzdálený ladicí program (msvsmon.exe) ze sdílené složky. Informace o omezeních použití najdete na stránce nápovědy vzdáleného ladicího programu (nápověda využití vzdáleného ladicího programu).

1. Vyhledejte v adresáři msvsmon.exe odpovídající vaší verzi 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. Na počítači Visual Studio nasdílejte složku Remote Debugger.

3. Na vzdáleném počítači spusťte msvsmon.exe ze sdílené složky. Postupujte podle pokynů k nastavení .

Spropitné

Informace o instalaci příkazového řádku a odkazu na příkazový řádek najdete na stránce nápovědy pro msvsmon.exe zadáním msvsmon.exe /? na příkazovém řádku v počítači s nainstalovaným Visual Studio (nebo přejděte na Použít > Usage ve vzdáleném ladicím programu).

Nastavte vzdálený ladicí program

1. Na vzdáleném počítači vyhledejte a spusťte vzdálený ladicí program z nabídky Start.

   Pokud nemáte oprávnění správce na vzdáleném počítači, klikněte pravým tlačítkem myši na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. V opačném případě ho jednoduše zahajte normálně.

   Pokud se chystáte připojit k procesu, který běží jako správce nebo běží pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci Remote Debugger a vyberte Spustit jako správce. Další informace naleznete v tématu Spusťte vzdálený ladicí nástroj jako správce.

2. Při prvním spuštění vzdáleného ladicího programu (nebo před jeho nakonfigurováním) se zobrazí průvodce konfigurace vzdáleného ladění.

   Ve většině scénářů vyberte Konfigurovat vzdálené ladění.

   snímek obrazovky s konfigurací vzdáleného ladicího programu.Konfigurace vzdáleného ladicího programu

3. Vyberte aspoň jeden typ sítě, na který chcete používat vzdálené nástroje. Pokud jsou počítače připojené přes doménu, musíte zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, podle potřeby zvolte druhou nebo třetí položku.

   Dále vyberte možnost Dokončit pro spuštění vzdáleného debuggeru.

4. Po dokončení konfigurace se zobrazí okno vzdáleného ladicího programu.

   snímek obrazovky okna vzdáleného ladicího programuokno vzdáleného ladicího programu

   Vzdálený ladicí program nyní čeká na připojení. K nastavení konfigurace vzdáleného připojení v Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte SouborUkončit. Můžete ho restartovat z nabídky Start nebo z příkazového řádku:

<Remote debugger installation directory>\msvsmon.exe

Nakonfigurujte vzdálený ladicí program

Po prvním spuštění můžete změnit některé aspekty konfigurace vzdáleného ladicího programu.

• Pokud potřebujete přidat oprávnění pro připojení jiných uživatelů ke vzdálenému ladicímu programu, zvolte Nástroje Oprávnění. Abyste mohli udělit nebo odepřít oprávnění, musíte mít oprávnění správce.

  Důležitý

  Vzdálený ladicí program můžete spustit pod uživatelským účtem, který se liší od uživatelského účtu, který používáte v počítači Visual Studio, ale musíte přidat jiný uživatelský účet do oprávnění vzdáleného ladicího programu.

  Případně můžete spustit vzdálený ladicí program z příkazového řádku pomocí parametru /allow uživatelské jméno: msvsmon /allow username@computer.

• Pokud potřebujete změnit režim ověřování nebo číslo portu nebo zadat hodnotu časového limitu pro vzdálené nástroje: zvolte Nástroje Možnosti.

  Seznam čísel portů používaných ve výchozím nastavení najdete v tématu Přiřazení portů vzdáleného ladicího programu.

  Varování

  Vzdálené nástroje můžete spouštět v režimu bez ověřování, ale tento režim se důrazně nedoporučuje. V tomto režimu není k dispozici žádné zabezpečení sítě, když jej používáte. Režim Bez ověřování zvolte jenom v případě, že máte jistotu, že síť není ohrožená škodlivým nebo nepřátelským provozem.

Konfigurace Visual Studio pro vzdálené ladění

Podrobné pokyny pro připojení k aplikaci z Visual Studio najdete v odkazech souvisejících s vaším konkrétním scénářem na začátku tohoto článku.

Některé scénáře vyžadují použití funkce Připojit k procesu pro připojení ke vzdálené aplikaci, která je už spuštěná. Pro aplikace .NET Core, .NET 5 nebo novější, .NET Framework a C++ ale můžete spustit vzdálenou aplikaci z Visual Studio tak, že nakonfigurujete project vlastnosti a spustíte ladicí program. Další informace najdete v tématu Vzdálené ladění C# nebo Visual Basic projektu nebo Vzdálené ladění projektu v jazyce C++.

Můžete také vzdáleně ladit spustitelný soubor, který není součástí Visual Studio project, i když podporované funkce ladění závisí na konfiguraci, jako je dostupnost symbolů. Další informace najdete v tématu Debug aplikace, která není součástí řešení Visual Studio.

(Volitelné) Konfigurujte vzdálený ladicí program jako službu

Pro ladění v PROSTŘEDÍ ASP.NET a jiných serverových prostředích musíte buď spustit vzdálený ladicí program jako správce, nebo pokud chcete, aby byl vždy spuštěný, spusťte vzdálený ladicí program jako službu.

Pokud chcete nakonfigurovat vzdálený ladicí nástroj jako službu, postupujte takto.

1. Vyhledejte průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe). (Toto je samostatná aplikace od vzdáleného ladicího programu.) Je k dispozici pouze při instalaci vzdálených nástrojů. Není nainstalovaný s Visual Studio.

2. Spusťte průvodce konfigurací. Až se zobrazí první stránka, klikněte na Další.

3. Zaškrtněte políčko Spusťte Visual Studio vzdálený ladicí program jako službu.

4. Přidejte jméno uživatelského účtu a hesla.

   K tomuto účtu možná budete muset přidat uživatelské oprávnění Přihlásit se jako službu (Najděte Místní zásady zabezpečení (secpol.msc) na stránce nebo v okně Start, nebo zadejte secpol na příkazovém řádku). Po zobrazení okna poklepte na Přiřazení uživatelských práva v pravém podokně vyhledejte Přihlásit jako službu. Poklikejte na něj. Přidejte uživatelský účet do okna vlastnosti a klikněte na OK). Klikněte na Další.

5. Vyberte typ sítě, se kterou mají vzdálené nástroje komunikovat. Musí být vybrán alespoň jeden typ sítě. Pokud jsou počítače připojené přes doménu, měli byste zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, měli byste zvolit druhou nebo třetí položku. Klikněte na Další.

6. Pokud je možné službu spustit, zobrazí se Úspěšně jste dokončili Průvodce konfigurací vzdáleného ladicího programu pro sadu Visual Studio. Pokud službu nejde spustit, zobrazí se Nepodařilo se dokončit Průvodce konfigurací vzdáleného ladicího programu Visual Studio. Na stránce najdete také několik tipů, jak službu spustit.

7. Klikněte na Dokončit.

   V tuto chvíli běží vzdálený ladicí program jako služba. Můžete to ověřit tak, že přejdete na Control Panel > Services a vyhledáte Visual Studio vzdálený ladicí program.

   Službu vzdáleného ladicího programu můžete zastavit a spustit z Control Panel > Services.

Nastavení ladění pomocí vzdálených symbolů

Kód byste měli být schopni ladit pomocí symbolů, které vygenerujete v počítači Visual Studio. Výkon vzdáleného ladicího programu je mnohem lepší, když používáte lokální symboly. Pokud potřebujete použít vzdálené symboly, je třeba informovat monitor vzdáleného ladění, aby symboly hledal na vzdáleném počítači.

K použití vzdálených symbolů pro spravovaný kód můžete použít následující přepínač příkazového řádku msvsmon:

Další informace naleznete v nápovědě pro vzdálené ladění (stiskněte F1 v okně vzdáleného ladicího programu nebo klikněte na tlačítko Nápověda Využití).

Související obsah

• Nejprve se podívejte na ladicí program
• Konfigurace brány Windows Firewall pro vzdálené ladění
• Přiřazení Portů Vzdáleného Ladicího Programu
• Vzdálené ladění ASP.NET Core na vzdáleném počítači s IIS
• Chyby při vzdáleném odstraňování chyb a řešení potíží