Távoli hibakeresés

Hibakeresést végezhet egy másik számítógépen üzembe helyezett Visual Studio alkalmazásban. Ehhez használja a Visual Studio távoli hibakeresőt.

A távoli hibakereséssel kapcsolatos részletes útmutatásért tekintse meg ezeket a témaköröket.

Forgatókönyv	Link
C# vagy Visual Basic	C# vagy Visual Basic projekt távoli hibakeresése
C++	C++ projekt távoli hibakeresése
Azure App Service	Távoli hibakeresés ASP.NET Core az Azure-on vagy a Visual Studio Enterprise-hez a Snapshot Debugger
ASP.NET	Távoli hibakeresés ASP.NET Core vagy Távoli hibakeresés ASP.NET
Azure virtuális gép	Távoli hibakeresés ASP.NET egy Azure virtuális gépen
Linux	Debug .NET Core Linux rendszeren SSH használatával egy folyamathoz való csatlakozással
Kikötőmunkás	Csatolás Docker-tárolóban futó folyamathoz
Univerzális Windows-alkalmazások (UWP)	UWP-alkalmazások futtatása távoli gépen vagy Telepített alkalmazáscsomag hibakeresése

Ha csak le szeretné tölteni és telepíteni szeretné a távoli hibakeresőt, és nincs szüksége további utasításokra a forgatókönyvhöz, kövesse az ebben a cikkben ismertetett lépéseket.

A távoli eszközök letöltése és telepítése

A hibakeresésre használni kívánt távoli eszközön vagy kiszolgálón a Visual Studio gép helyett töltse le és telepítse a távoli eszközök megfelelő verzióját az alábbi táblázat hivatkozásaiból.

• Töltse le a távoli eszközök legújabb frissítését a Visual Studio verziójához. A 2022-es és 2026-os Visual Studio távoli eszközei a Visual Studio bármelyik verziójával használhatók. A 2022-Visual Studio-nél régebbi távoli eszközök verziói azonban nem kompatibilisek a későbbi Visual Studio verziókkal. (Ha például Visual Studio 2019-et használ, töltse le a 2019-Visual Studio távoli eszközeinek legújabb frissítését. Ebben a forgatókönyvben ne töltse le a 2022-Visual Studio távoli eszközeit.)

• Töltse le a távoli eszközöket ugyanazzal az architektúrával, mint a számítógépre, amelyre telepíti őket. Ha például x64 operációs rendszert futtató távoli számítógépen szeretné hibakeresésre használni az x86-alkalmazásokat, telepítse az x64 távoli eszközöket. Az x86-os, ARM- vagy x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez telepítse az ARM64 távoli eszközeit.

Verzió	Link	Jegyzetek
Visual Studio 2026	Távoli eszközök	Kompatibilis Visual Studio 2022-ben és újabb verziókban. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájl letöltésének tiltása.
Visual Studio 2022	Távoli eszközök	A 2022-Visual Studio távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be Visual Studio előfizetés-azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájl letöltésének tiltása.
Visual Studio 2019	Távoli eszközök	A 2019-Visual Studio távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be Visual Studio előfizetés-azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájl letöltésének tiltása.
Visual Studio 2017	Távoli eszközök	A Visual Studio 2017 távoli eszközei a My.VisualStudio.com weboldalon érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be Visual Studio előfizetés-azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért nézze meg a Fájl letöltésének feloldása-t.
Visual Studio 2015	Távoli eszközök	A 2015-ös Visual Studio távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be Visual Studio előfizetés-azonosítójával. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájl letöltésének feloldása.
2013 Visual Studio	Távoli eszközök	Lap letöltése a Visual Studio 2013 dokumentációjában
Visual Studio 2012	Távoli eszközök	Lap letöltése Visual Studio 2012 dokumentációjában

A távoli hibakeresőt úgy futtathatja, hogy a távoli eszközök telepítése helyett msvsmon.exe a távoli számítógépre másolja. A Távoli hibakereső konfigurációs varázslója (rdbgwiz.exe) azonban csak a távoli eszközök telepítésekor érhető el. Előfordulhat, hogy a varázslót kell használnia a konfigurációhoz, ha a távoli hibakeresőt szolgáltatásként szeretné futtatni. További információért lásd: (Nem kötelező) A távoli hibakereső szolgáltatásként történő konfigurálása.

Jegyzet

• Az ARM-eszközökön Windows 10 vagy újabb alkalmazások hibakereséséhez használja az ARM64-et, amely a távoli eszközök legújabb verziójával érhető el.
• Az Windows RT eszközökön található Windows 10 alkalmazások hibakereséséhez használja az ARM-t, amely csak a Visual Studio 2015-ös távoli eszközök letöltésében érhető el.
• Az x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez futtassa az ARM64 távoli eszközeivel telepített msvsmon.exe x64-verzióját.

Követelmények

Rendszerkövetelmények

A távoli eszközök bizonyos módosításokkal ugyanazokat a rendszerkövetelményeket támogatják, mint Visual Studio. További részletekért tekintse meg a Visual Studio verziójának rendszerkövetelményeit:

• Remote Tools for Visual Studio 2026 rendszerkövetelmények
• Remote Tools for Visual Studio 2022 rendszerkövetelmények
• Remote Tools for Visual Studio 2019 rendszerkövetelmények

Hálózati konfiguráció

A távoli számítógépnek és a Visual Studio számítógépnek hálózaton, munkacsoporton vagy otthoni csoporton keresztül kell csatlakoznia, vagy közvetlenül Ethernet-kábelen keresztül kell csatlakoznia. A proxyn keresztül csatlakoztatott két számítógép közötti hibakeresés nem támogatott. A magas késésű vagy alacsony sávszélességű kapcsolaton, például a betárcsázós interneten vagy az országok/régiók közötti internetkapcsolaton keresztüli hibakeresés nem ajánlott, és sikertelen vagy elfogadhatatlanul lassú lehet.

(Nem kötelező) A távoli hibakereső futtatása fájlmegosztásból

A távoli hibakeresőt (msvsmon.exe) olyan számítógépen találja, amelyen már telepítve van Visual Studio Community, Professional vagy Enterprise. Bizonyos esetekben a távoli hibakeresés beállításának legegyszerűbb módja a távoli hibakereső (msvsmon.exe) futtatása egy fájlmegosztásból. A használati korlátozásokért tekintse meg a távoli hibakereső súgóoldalát (Súgó > Használat a távoli hibakeresőben).

1. Keresse meg msvsmon.exe a Visual Studio verziójának megfelelő könyvtárban:

   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. Ossza meg a Remote Debugger mappát a Visual Studio számítógépen.

3. A távoli számítógépen futtassa a msvsmon.exe a megosztott mappából. Kövesse a beállítási utasításokat.

Borravaló

A parancssori telepítéssel és a parancssori hivatkozással kapcsolatos információkért tekintse meg a msvsmon.exe súgóoldalt, ha beírja a parancssorba a Visual Studio telepített gépén (vagy lépjen a Help > Usage menüpontra a távoli hibakeresőben).

A távoli hibakereső beállítása

1. A távoli számítógépen keresse meg és indítsa el a Távoli hibakereső a Start menüből.

   Ha nem rendelkezik rendszergazdai engedélyekkel a távoli számítógépen, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdailehetőséget. Ellenkező esetben csak indítsa el a szokásos módon.

   Ha rendszergazdaként futó vagy másik felhasználói fiók (például IIS) alatt futó folyamathoz szeretne csatolni, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdakéntlehetőséget. További információért lásd: A távoli hibakereső futtatása rendszergazdai jogosultsággal.

2. A távoli hibakereső első indításakor (vagy a konfigurálás előtt) megjelenik a Távoli hibakeresési konfiguráció varázsló.

   A legtöbb esetben válassza a Távoli hibakeresés konfigurálása lehetőséget.

   

3. Válasszon ki legalább egy hálózati típust, amelyen a távoli eszközöket használni szeretné. Ha a számítógépek tartományon keresztül csatlakoznak, ki kell választania az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, szükség szerint válassza a második vagy a harmadik elemet.

   Ezután válassza a Befejezés gombot a távoli hibakereső indításához.

4. Ha a konfiguráció befejeződött, megjelenik a Távoli hibakereső ablak.

   

   A távoli hibakereső most egy kapcsolatra vár. A megjelenített kiszolgáló nevét és portszámát használja a távoli kapcsolat konfigurációjának beállításához a Visual Studio-ban.

A távoli hibakereső leállításához válassza a Fájl>Kilépésparancsot. Újraindíthatja a Start menüből vagy a parancssorból:

<Remote debugger installation directory>\msvsmon.exe

A távoli hibakereső konfigurálása

A távoli hibakereső konfigurációjának néhány aspektusát az első indítás után módosíthatja.

• Ha más felhasználók engedélyeit kell hozzáadnia a távoli hibakeresőhöz való csatlakozáshoz, válassza az Eszközök > Engedélyeklehetőséget. Az engedélyek megadásához vagy megtagadásához rendszergazdai jogosultságokkal kell rendelkeznie.

  Fontos

  A távoli hibakeresőt olyan felhasználói fiók alatt futtathatja, amely eltér a Visual Studio számítógépen használt felhasználói fióktól, de hozzá kell adnia a másik felhasználói fiókot a távoli hibakereső engedélyeihez.

  Másik lehetőségként elindíthatja a távoli hibakeresőt a parancssorból a /allow <felhasználónév> paraméterrel: msvsmon /allow <username@computer>.

• Ha módosítania kell a hitelesítési módot vagy a portszámot, vagy időtúllépési értéket kell megadnia a távoli eszközökhöz: válassza az Eszközök > Beállításoklehetőséget.

  Az alapértelmezés szerint használt portszámok listáját Távoli hibakereső porthozzárendelésekcímű témakörben talál.

  Figyelmeztetés

  Dönthet úgy, hogy a távoli eszközöket hitelesítés nélküli módban futtatja, de ezt a módot erősen nem ajánljuk. Ebben a módban való futtatáskor nincs hálózati biztonság. Csak akkor válassza a Nem hitelesítési módot, ha biztos benne, hogy a hálózat nem áll veszélyben a rosszindulatú vagy ellenséges forgalom miatt.

Visual Studio konfigurálása távoli hibakereséshez

Ha részletes útmutatást szeretne az alkalmazáshoz való csatlakozáshoz Visual Studio, használja a cikk elején az adott forgatókönyvhöz kapcsolódó hivatkozásokat.

Egyes helyzetekben az Csatolás folyamathoz funkció használata szükséges egy már elindított távoli alkalmazáshoz való csatlakozáshoz. A .NET Core, .NET 5+, .NET Framework és C++ alkalmazások esetében azonban a távoli alkalmazást a Visual Studio a projekt tulajdonságainak konfigurálásával és a hibakereső elindításával indíthatja el. További információ: A C# vagy Visual Basic projekt hibakeresése vagy A C++ projekt hibakeresése.

Távoli hibakeresést is végezhet olyan végrehajtható fájlokban, amelyek nem Visual Studio projekt részei, bár a támogatott hibakeresési funkciók a konfigurációtól, például a szimbólumok elérhetőségétől függnek. További információ: A Visual Studio megoldás részét nem képező alkalmazások hibakeresése.

(Nem kötelező) A távoli hibakereső konfigurálása szolgáltatásként

A ASP.NET és más kiszolgálói környezetekben végzett hibakereséshez rendszergazdaként kell futtatnia a távoli hibakeresőt, vagy ha azt szeretné, hogy mindig futtassa, futtassa a távoli hibakeresőt szolgáltatásként.

Ha szolgáltatásként szeretné konfigurálni a távoli hibakeresőt, kövesse az alábbi lépéseket.

1. Keresse meg a Távoli Hibakereső Konfigurációs Varázsló (rdbgwiz.exe). (Ez egy külön alkalmazás a távoli hibakeresőtől.) Ez csak a távoli eszközök telepítésekor érhető el. Nincs telepítve a Visual Studio.

2. Indítsa el a konfigurációs varázsló futtatását. Amikor megjelenik az első oldal, kattintson a Továbbgombra.

3. Jelölje be a Visual Studio távoli hibakereső futtatása szolgáltatásként jelölőnégyzetet.

4. Adja hozzá a felhasználói fiók nevét és jelszavát.

   Előfordulhat, hogy hozzá kell adnia a Bejelentkezés szolgáltatásként felhasználót ehhez a fiókhoz (Helyi biztonsági házirend (secpol.msc) keresése a Start lapon vagy ablakban (vagy írja be secpol parancssorba). Amikor megjelenik az ablak, kattintson duplán Felhasználói jogok hozzárendeléseelemre, majd keresse meg Bejelentkezés szolgáltatásként a jobb oldali panelen. Kattintson rá duplán. Adja hozzá a felhasználói fiókot a Tulajdonságok ablakhoz, majd kattintson OKgombra. Kattintson a Tovább feliratra.

5. Válassza ki azt a hálózattípust, amellyel a távoli eszközök kommunikálni szeretnének. Legalább egy hálózati típust ki kell jelölni. Ha a számítógépek tartományon keresztül csatlakoznak, válassza ki az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, a második vagy a harmadik elemet kell választania. Kattintson a Tovább feliratra.

6. Ha a szolgáltatás elindítható, megjelenik Sikeresen elvégezte a Visual Studio Távoli hibakereső konfigurációs varázslóját. Ha a szolgáltatás nem indítható el, a következőt fogja látni: A Visual Studio Távoli hibakereső konfigurációs varázsló befejezése sikertelen. Az oldal néhány követendő tippet is ad a szolgáltatás elindításához.

7. Kattintson a Finish (Befejezés) gombra.

   Ezen a ponton a távoli hibakereső szolgáltatásként fut. Ezt a Vezérlőpult > Services webhelyen ellenőrizheti, és Visual Studio távoli hibakeresőt kereshet.

   A távoli hibakereső szolgáltatást a Vezérlőpult > Services helyről állíthatja le és indíthatja el.

Hibakeresés beállítása távoli szimbólumokkal

Képesnek kell lennie a kód hibakeresésére a Visual Studio számítógépen létrehozott szimbólumokkal. A távoli hibakereső teljesítménye sokkal jobb, ha helyi szimbólumokat használ. Ha távoli szimbólumokat kell használnia, meg kell adnia a távoli hibakereső monitornak, hogy keressen szimbólumokat a távoli gépen.

Az alábbi msvsmon parancssori kapcsolóval használhat távoli szimbólumokat felügyelt kód esetén: Msvsmon /FallbackLoadRemoteManagedPdbs

További információt a távoli hibakeresési súgóban talál (nyomja le F1 a távoli hibakereső ablakban, vagy kattintson Súgó > Használati).

Kapcsolódó tartalom

• Első pillantás a hibakeresőre
• Konfigurálja a Windows tűzfalat a távoli hibakereséshez
• Távoli hibakereső portok kiosztása
• ASP.NET Core távoli hibakeresése egy távoli IIS-számítógépen
• Távoli hibakeresési problémák és hibaelhárítás