Zdalne debugowanie ASP.NET Core na zdalnym komputerze z IIS w programie Visual Studio

Aby debugować aplikację ASP.NET Core, która została wdrożona w usługach IIS, zainstaluj i uruchom narzędzia zdalne na komputerze, na którym wdrożono aplikację, a następnie dołącz ją do uruchomionej aplikacji z programu Visual Studio.

W tym przewodniku wyjaśniono, jak ustawić i skonfigurować projekt ASP.NET Core w Visual Studio, wdrożyć go na IIS i dołączyć do niego zdalny debuger Visual Studio. Aby zdalnie debugować ASP.NET 4.8, zobacz Zdalne debugowanie ASP.NET na komputerze z usługą IIS. Możesz również wdrażać i debugować na serwerze IIS za pomocą platformy Azure. W przypadku usługi Azure App Service zobacz zdalne debugowanie ASP.NET Core na platformie Azure lub, w przypadku Visual Studio Enterprise, użyj Snapshot Debugger (wymagany jest .NET 4.6.1).

Warunki wstępne

Do wykonania kroków przedstawionych w tym artykule jest wymagany program Visual Studio 2019 lub nowsza wersja.

Te procedury zostały przetestowane w tych konfiguracjach serwera:

• Windows Server 2022 i IIS 10
• Windows Server 2019 i IIS 10
• Windows Server 2016 i IIS 10

Wymagania dotyczące sieci

Debugowanie między dwoma komputerami połączonymi za pośrednictwem serwera proxy nie jest obsługiwane. Debugowanie przez połączenie o dużym opóźnieniu lub niskiej przepustowości, takie jak dial-up do Internetu lub przez Internet pomiędzy różnymi krajami/regionami, nie jest zalecane i może zakończyć się niepowodzeniem lub być niedopuszczalnie wolne. Aby uzyskać pełną listę wymagań, zobacz wymagania .

Aplikacja już uruchomiona w usługach IIS?

Ten artykuł zawiera kroki konfigurowania podstawowej konfiguracji usług IIS na serwerze z systemem Windows i wdrażania aplikacji z poziomu programu Visual Studio. Te kroki są zawarte, aby upewnić się, że serwer ma zainstalowane wymagane składniki, że aplikacja może działać poprawnie i że wszystko jest gotowe do zdalnego debugowania.

• Jeśli aplikacja jest uruchomiona w usługach IIS i chcesz pobrać debuger zdalny i rozpocząć debugowanie, przejdź do Pobierz i Zainstaluj narzędzia zdalne w systemie Windows Server.

• Jeśli chcesz uzyskać pomoc, aby upewnić się, że aplikacja została skonfigurowana, wdrożona i uruchomiona poprawnie w usługach IIS, aby umożliwić debugowanie, wykonaj wszystkie kroki opisane w tym artykule.

Tworzenie aplikacji ASP.NET Core na komputerze programu Visual Studio

1. Utwórz nową aplikację internetową ASP.NET Core.

   W programie Visual Studio wybierz pozycję Plik>okno uruchamiania, aby otworzyć okno startowe, a następnie wybierz pozycję Utwórz nowy projekt. W polu wyszukiwania wpisz aplikacja internetowa, następnie wybierz C# jako język, wybierz ASP.NET Core Web Application (Model-View-Controller), a następnie wybierz Dalej. Na następnym ekranie nadaj projektowi nazwę MyASPApp, a następnie wybierz pozycję Dalej.

   Wybierz zalecaną strukturę docelową lub platformę .NET 8, a następnie wybierz pozycję Utwórz. Wersja musi być zgodna z wersją zainstalowaną na serwerze.

2. Otwórz plik HomeController.cs w folderze Controllers i ustaw punkt przerwania w instrukcji return View; w metodzie Privacy.

   W starszych szablonach otwórz plik Privacy.cshtml.cs i ustaw punkt przerwania w metodzie OnGet.

Instalowanie i konfigurowanie usług IIS w systemie Windows Server

Te kroki pokazują tylko podstawową konfigurację usług IIS. Aby uzyskać bardziej szczegółowe informacje lub zainstalować na komputerze z systemem Windows Desktop, zobacz publishing to IIS or IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

W przypadku systemów operacyjnych Windows Server użyj kreatora Dodaj role i funkcje za pośrednictwem linku Zarządzanie lub linku Pulpit nawigacyjny w Menedżerze serwera . Na etapie ról serwera zaznacz pole wyboru dla serwera sieci Web (IIS).

(Windows Server 2022) W wyświetlonym oknie dialogowym wybierz pozycję Dodaj funkcje, aby dodać konsolę zarządzania usługami IIS.

Na kroku Usługi ról wybierz usługi ról IIS, których potrzebujesz, lub zaakceptuj udostępniane domyślne usługi ról. Jeśli chcesz włączyć wdrożenie przy użyciu ustawień publikowania i narzędzia Web Deploy, upewnij się, że wybrano następujące funkcje:

• skrypty i narzędzia zarządzania usługami IIS
• usługa zarządzania
• Konsola zarządzania IIS

Wykonaj kroki potwierdzenia, aby zainstalować rolę i usługi serwera internetowego. Ponowne uruchomienie serwera/usług IIS nie jest wymagane po zainstalowaniu roli serwera sieci Web (IIS).

Aktualizowanie ustawień zabezpieczeń przeglądarki w systemie Windows Server

Jeśli używasz starszej wersji systemu Windows Server, może być konieczne dodanie niektórych domen jako zaufanych witryn, aby umożliwić pobranie niektórych składników serwera internetowego. Dodaj zaufane witryny, przechodząc do Opcje internetowe > Zabezpieczenia > Zaufane witryny > Witryny. Dodaj następujące domeny.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

Po pobraniu oprogramowania możesz otrzymywać żądania udzielenia uprawnień do ładowania różnych skryptów i zasobów witryny internetowej. Niektóre z tych zasobów nie są wymagane, ale aby uprościć proces, wybierz Dodaj, gdy pojawi się stosowna prośba.

Instalowanie ASP.NET Core w systemie Windows Server

1. Zainstaluj pakiet hostingu platformy .NET Core w systemie hostingu. Pakiet instaluje środowisko uruchomieniowe platformy .NET Core, bibliotekę .NET Core i moduł ASP.NET Core. Aby uzyskać bardziej szczegółowe instrukcje, zobacz Publikowanie do IIS.

   W przypadku bieżącego pakietu hostingowego platformy .NET Core zainstaluj pakiet hostingu ASP.NET Core.

   Notatka

   Jeśli wcześniej zainstalowano usługi IIS, moduł ASP.NET Core IIS zostanie zainstalowany równocześnie z ASP.NET Core. W przeciwnym razie zainstaluj ręcznie moduł ASP.NET Core IIS.

   W przypadku platformy .NET Core 2 zainstaluj .NET Core Windows Server Hosting.

   Notatka

   Jeśli system nie ma połączenia z Internetem, uzyskaj i zainstaluj pakiet redystrybucyjny Microsoft Visual C++ 2015 przed zainstalowaniem pakietu hostingowego Windows Server dla platformy .NET Core.

2. Uruchom ponownie system (lub wykonaj net stop was /y a następnie net start w3svc z wiersza polecenia, aby zastosować zmiany w systemowym PATH).

Wybieranie opcji wdrożenia

Jeśli potrzebujesz pomocy przy wdrażaniu aplikacji w usługach IIS, rozważ następujące opcje:

• Wdróż, tworząc plik ustawień publikowania w usługach IIS i importując ustawienia w programie Visual Studio. W niektórych scenariuszach jest to szybki sposób wdrażania aplikacji. Podczas tworzenia pliku ustawień publikowania uprawnienia są automatycznie konfigurowane w usługach IIS.

• Wdróż poprzez opublikowanie w folderze lokalnym i skopiowanie wyników preferowaną metodą do przygotowanego folderu aplikacji na IIS.

(Opcjonalnie) Wdrażanie przy użyciu pliku ustawień publikowania

Możesz użyć tej opcji, aby utworzyć plik ustawień publikowania i zaimportować go do programu Visual Studio.

Notatka

Jeśli chcesz ręcznie skonfigurować narzędzie Web Deploy zamiast importować ustawienia publikowania, upewnij się, że folder aplikacji na serwerze jest skonfigurowany z odpowiednimi wartościami i uprawnieniami (zobacz Konfigurowanie witryny sieci Web ASP.NET).

Konfigurowanie witryny sieci Web ASP.NET Core

1. W Menedżerze usług IIS w okienku po lewej stronie w obszarze Connectionswybierz pozycję Application Pools. Otwórz DefaultAppPool i ustaw wersję środowiska .NET CLR na Brak zarządzanego kodu. Jest to wymagane dla ASP.NET Core. Domyślna witryna sieci Web używa DefaultAppPool.

2. Zatrzymaj i uruchom ponownie domyślną pulę aplikacji DefaultAppPool.

Instalowanie i konfigurowanie narzędzia Web Deploy w systemie Windows Server

Narzędzie Web Deploy udostępnia dodatkowe funkcje konfiguracji, które umożliwiają tworzenie pliku ustawień publikowania z poziomu interfejsu użytkownika.

Notatka

Instalator platformy internetowej osiągnął koniec życia w dniu 7/1/22. Aby uzyskać więcej informacji, zobacz Instalator platformy internetowej — zakończenie pomocy technicznej i wycofanie kanału dystrybucji produktu/aplikacji. Możesz bezpośrednio zainstalować narzędzie Web Deploy 4.0, aby utworzyć plik ustawień publikowania.

1. Jeśli nie zainstalowano jeszcze skryptów zarządzania usługami IIS i narzędzi, zainstaluj je teraz.

   Przejdź do Wybierz role serwera>serwera sieci Web (IIS)>Narzędzia do zarządzania, a następnie wybierz rolę Skrypty i narzędzia zarządzania usługami IIS, kliknij Dalej, a następnie zainstaluj rolę.

   

   Skrypty i narzędzia są wymagane do włączenia generowania pliku ustawień publikowania.

   Upewnij się również, że zainstalowano usługę zarządzania oraz konsolę zarządzania IIS (mogą one być już zainstalowane).

2. W systemie Windows Server pobrać narzędzie Web Deploy 4.0.

3. Uruchom program instalacyjny Web Deploy i upewnij się, że wybrano opcję Pełna instalacja zamiast typowej instalacji.

   Po zakończeniu instalacji uzyskasz składniki potrzebne do wygenerowania pliku ustawień publikowania. (Jeśli zamiast tego wybierzesz Niestandardowy, możesz zobaczyć listę składników, jak pokazano na poniższej ilustracji).

   zrzut ekranu

4. (Opcjonalnie) Sprawdź, czy narzędzie Web Deploy działa prawidłowo, otwierając Panel sterowania > System i Zabezpieczenia > Narzędzia administracyjne > Services, a następnie upewnij się, że:

   • jest uruchomiona usługa agenta wdrażania sieci Web (nazwa usługi różni się w starszych wersjach).

   • Usługa Web Management Service jest uruchomiona.

   Jeśli jedna z usług agenta nie jest uruchomiona, uruchom ponownie usługę Web Deployment Agent Service.

   Jeśli usługa agenta wdrażania sieci Web nie jest w ogóle obecna, przejdź do Panel sterowania > Programy > Odinstaluj program, znajdź Microsoft Web Deploy <w wersji>. Wybierz opcję Zmień instalację i upewnij się, że wybierzesz Będzie zainstalowane na lokalnym dysku twardym dla składników Web Deploy. Wykonaj kroki instalacji zmiany.

Tworzenie pliku ustawień publikowania w usługach IIS w systemie Windows Server

1. Zamknij i otwórz ponownie konsolę zarządzania usługami IIS, aby wyświetlić zaktualizowane opcje konfiguracji w interfejsie użytkownika.

2. W usługach IIS kliknij prawym przyciskiem myszy domyślną witrynę sieci Web, wybierz pozycję Wdróż>Konfiguruj publikowanie w usłudze Web Deploy.

   

   Jeśli nie widzisz menu Wdróż, zobacz poprzednią sekcję, aby sprawdzić, czy narzędzie Web Deploy jest uruchomione.

3. W oknie dialogowym Konfigurowanie publikowania Web Deploy sprawdź ustawienia.

4. Kliknij pozycję Setup.

   W panelu Wyniki dane wyjściowe pokazują, że prawa dostępu są przyznawane określonemu użytkownikowi i że plik z rozszerzeniem .publishsettings został wygenerowany w lokalizacji wyświetlanej w oknie dialogowym.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   W zależności od konfiguracji systemu Windows Server i usług IIS w pliku XML są widoczne różne wartości. Poniżej przedstawiono kilka szczegółów dotyczących widocznych wartości:

   • Plik msdeploy.axd, do których odwołuje się atrybut publishUrl, jest dynamicznie generowanym plikiem programu obsługi HTTP dla narzędzia Web Deploy. (Do celów testowych http://myhostname:8172 zazwyczaj także działa).

   • Port publishUrl jest ustawiony na port 8172, który jest domyślnym portem web deploy.

   • Port destinationAppUrl jest ustawiony na port 80, który jest domyślny dla usług IIS.

   • Jeśli w kolejnych krokach nie możesz nawiązać połączenia z hostem zdalnym z programu Visual Studio przy użyciu nazwy hosta, przetestuj adres IP serwera zamiast nazwy hosta.

     Notatka

     Jeśli publikujesz w IIS uruchomionym na maszynie wirtualnej platformy Azure, musisz otworzyć port przychodzący dla narzędzia Web Deploy i IIS w grupie zabezpieczeń sieci. Aby uzyskać szczegółowe informacje, zapoznaj się z Otwieranie portów na maszynie wirtualnej.

5. Skopiuj ten plik na komputer, na którym jest uruchomiony program Visual Studio.

Importowanie ustawień publikowania w programie Visual Studio i wdrażanie

1. Na komputerze, na którym jest otwarty projekt ASP.NET w programie Visual Studio, kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań i wybierz Opublikuj.

   Jeśli wcześniej skonfigurowano jakiekolwiek profile publikowania, zostanie wyświetlone okienko Publikuj. Kliknij pozycję Nowy lub Utwórz nowy profil.

2. Wybierz opcję importowania profilu.

   W oknie dialogowym Publikowanie kliknij pozycję Importuj profil.

   

3. Przejdź do lokalizacji pliku ustawień publikowania utworzonego w poprzedniej sekcji.

4. W oknie dialogowym importowania plików ustawień publikowania przejdź do profilu utworzonego w poprzedniej części i wybierz go, a następnie kliknij przycisk Otwórz.

   Kliknij Zakończ, aby zapisać profil publikowania, a następnie kliknij Opublikuj.

   Program Visual Studio rozpoczyna proces wdrażania, a okno Dane wyjściowe zawiera postęp i wyniki.

   Jeśli wystąpią jakiekolwiek błędy wdrażania, kliknij Więcej akcji>Edytuj, aby edytować ustawienia. Zmodyfikuj ustawienia i kliknij pozycję Zweryfikuj, aby przetestować nowe ustawienia. Jeśli nazwa hosta nie zostanie znaleziona, spróbuj użyć adresu IP zamiast nazwy hosta w polach serwera i docelowego adresu URL .

   

Po pomyślnym wdrożeniu aplikacji powinna zostać uruchomiona automatycznie.

• Jeśli aplikacja nie zostanie uruchomiona po wdrożeniu, uruchom aplikację w usługach IIS, aby sprawdzić, czy działa poprawnie.
• W przypadku ASP.NET Core upewnij się, że w polu Pula aplikacji dla DefaultAppPool ustawiona jest wartość Brak zarządzanego kodu.

Gdy wszystko będzie gotowe, przejdź do konfiguracji debugowania.

Ważny

Jeśli zdecydujesz się debugować konfigurację wydania, podczas publikowania wyłączysz debugowanie w pliku web.config.

1. Wybierz pozycję Więcej opcji>Edytuj, aby edytować profil, a następnie wybierz pozycję Ustawienia.
2. Wybierz pozycję Zapisz, a następnie ponownie opublikuj aplikację.
3. Wybierz konfigurację Debug, a następnie wybierz pozycję Usuń dodatkowe pliki w lokalizacji docelowej w opcjach publikowania plików .

Ostrzeżenie

Użycie poświadczeń nazwy użytkownika i hasła (uwierzytelnianie podstawowe) nie jest najbezpieczniejszą metodą uwierzytelniania. Jeśli to możliwe, użyj metod alternatywnych. Rozważ na przykład publikowanie w pakiecie z programu Visual Studio, a następnie użyj WebDeploy.exe z wiersza polecenia, aby wdrożyć pakiet. Za pomocą tej metody można użyć Menedżera usług IIS, aby skonfigurować autoryzowanych użytkowników systemu Windows, którzy mogą publikować na serwerze sieci Web, i uruchomić WebDeploy.exe w ramach tego konta użytkownika systemu Windows. Zobacz Instalowanie i konfigurowanie narzędzia Web Deploy na serwerze IIS 8.0 lub nowszym. Jeśli używasz poświadczeń hasła, pamiętaj, aby użyć silnego hasła i zabezpieczyć hasło przed wyciekiem lub udostępnieniem.

(Opcjonalnie) Wdrażanie przez publikowanie w folderze lokalnym

Możesz użyć tej opcji, aby wdrożyć aplikację, jeśli chcesz skopiować aplikację do usług IIS przy użyciu programu PowerShell, narzędzia RoboCopy lub ręcznie skopiować pliki.

Konfigurowanie witryny sieci Web ASP.NET Core na komputerze z systemem Windows Server

1. Otwórz Eksploratora Windows i utwórz nowy folder, C:\Publish, do użycia podczas wdrażania projektu ASP.NET Core.

2. Jeśli jeszcze nie jest otwarty, otwórz menedżera Internet Information Services (IIS). (W lewym okienku Menedżera serwera wybierz IIS. Kliknij prawym przyciskiem myszy serwer i wybierz pozycję Internet Information Services (IIS) Manager.)

3. W sekcji Connections w okienku po lewej stronie przejdź do Sites.

4. Wybierz Domyślną witrynę sieci Web, wybierz Podstawowe ustawieniai ustaw ścieżkę fizyczną na C:\Publish.

5. Kliknij prawym przyciskiem myszy węzeł domyślnej witryny sieci Web i wybierz pozycję Dodaj aplikację.

6. Ustaw pole aliasu na MyASPApp, zaakceptuj domyślną pulę aplikacji (DefaultAppPool) i ustaw ścieżkę fizyczną na C:\Publish.

7. W obszarze Connectionswybierz pozycję Application Pools. Otwórz DefaultAppPool i ustaw pole Pula aplikacji na wartość Brak zarządzanego kodu.

8. Kliknij prawym przyciskiem myszy nową witrynę w Menedżerze usług IIS, wybierz pozycję Edytuj uprawnieniai upewnij się, że IUSR, IIS_IUSRS lub użytkownik skonfigurowany do dostępu do aplikacji sieciowej jest autoryzowanym użytkownikiem z uprawnieniami do odczytu & uruchamiania.

   Jeśli nie widzisz jednego z tych użytkowników z dostępem, wykonaj kroki dodawania IUSR jako użytkownika z uprawnieniami Odczyt & Wykonywanie.

Ważny

Aby uzyskać informacje o zabezpieczeniach w kontekście wbudowanych kont, zobacz Understanding Built-In User and Group Accounts in IIS 7.

Publikowanie i wdrażanie aplikacji przez publikowanie w folderze lokalnym z poziomu programu Visual Studio

Aplikację można również opublikować i wdrożyć przy użyciu systemu plików lub innych narzędzi.

1. W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Publikuj (w przypadku formularzy internetowych Publikuj aplikację internetową).

   Jeśli wcześniej skonfigurowano jakiekolwiek profile publikowania, pojawi się panel Publikowanie. Kliknij pozycję Nowy profil.

2. W oknie dialogowym Publikowanie wybierz pozycję Folder, kliknij przycisk Przeglądaji utwórz nowy folder, C:\Publish.

   

   Kliknij zakończ, aby zapisać profil publikowania.

3. Przejdź do konfiguracji debugowania.

   Wybierz pozycję Edytuj, aby edytować profil, a następnie wybierz pozycję Ustawienia. Wybierz konfigurację Debug, a następnie wybierz pozycję Usuń dodatkowe pliki w lokalizacji docelowej w opcjach Publikowania pliku.

   

   Notatka

   Jeśli używasz kompilacji wydania, podczas publikowania wyłączysz debugowanie w pliku web.config.

4. Kliknij Publikuj.

   Aplikacja publikuje konfigurację Debug projektu do folderu lokalnego. Postęp jest wyświetlany w oknie wyjściowym.

5. Skopiuj katalog projektu ASP.NET z komputera programu Visual Studio do katalogu lokalnego skonfigurowanego dla aplikacji ASP.NET (w tym przykładzie C:\Publish) na komputerze z systemem Windows Server. W tym samouczku założono, że kopiujesz ręcznie, ale możesz użyć innych narzędzi, takich jak PowerShell, Xcopy lub Robocopy.

   Ostrożność

   Jeśli musisz wprowadzić zmiany w kodzie lub ponownie skompilować, musisz ponownie opublikować i powtórzyć ten krok. Plik wykonywalny skopiowany na maszynę zdalną musi dokładnie odpowiadać lokalnemu źródle i symbolom. Jeśli tego nie zrobisz, podczas próby debugowania procesu otrzymasz ostrzeżenie cannot find or open the PDB file w programie Visual Studio.

6. W systemie Windows Server sprawdź, czy aplikację można uruchomić poprawnie, otwierając aplikację w przeglądarce.

   Jeśli aplikacja nie działa poprawnie, może wystąpić niezgodność między wersją ASP.NET zainstalowaną na serwerze a maszyną programu Visual Studio lub może wystąpić problem z konfiguracją usług IIS lub witryny sieci Web. Sprawdź ponownie wcześniejsze kroki.

Pobieranie i instalowanie narzędzi zdalnych w systemie Windows Server

Pobierz wersję narzędzi zdalnych, które są zgodne z wersją programu Visual Studio.

Na urządzeniu zdalnym lub serwerze, na którym chcesz debugować, a nie na maszynie programu Visual Studio, pobierz i zainstaluj poprawną wersję narzędzi zdalnych z linków w poniższej tabeli.

• Pobierz najnowszą aktualizację narzędzi zdalnych dla używanej wersji programu Visual Studio. Starsze wersje narzędzi zdalnych nie są zgodne z nowszymi wersjami programu Visual Studio. (Jeśli na przykład używasz programu Visual Studio 2019, pobierz najnowszą aktualizację narzędzi zdalnych dla programu Visual Studio 2019. W tym scenariuszu nie pobieraj narzędzi zdalnych dla programu Visual Studio 2022).
• Pobierz narzędzia zdalne z tą samą architekturą co maszyna, na której je instalujesz. Jeśli na przykład chcesz debugować aplikacje x86 na komputerze zdalnym z systemem operacyjnym x64, zainstaluj narzędzia zdalne x64. Aby debugować aplikacje x86, ARM lub x64 w systemie operacyjnym ARM64, zainstaluj narzędzia zdalne ARM64.

Wersja	Łącze	Notatki
Visual Studio 2022	narzędzia zdalne	Zgodność ze wszystkimi wersjami programu Visual Studio 2022. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. W starszych wersjach systemu Windows Server, zobacz Odblokuj pobieranie plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2019	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2019 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. Aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych w starszych wersjach systemu Windows Server, zobacz Odblokowywanie pobierania plików.
Visual Studio 2017	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2017 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. Na serwerze Windows sprawdź Odblokuj pobieranie pliku, aby uzyskać pomoc w pobieraniu narzędzi zdalnych.
Visual Studio 2015	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2015 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. W systemie Windows Server zobacz Odblokowywanie pobierania pliku, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2013	narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2013
Visual Studio 2012	narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2012

Debuger zdalny można uruchomić, kopiując msvsmon.exe na komputer zdalny, zamiast instalować narzędzia zdalne. Jednak Kreator konfiguracji debugera zdalnego (rdbgwiz.exe) jest dostępny tylko podczas instalowania narzędzi zdalnych. Może być konieczne użycie kreatora do konfiguracji, jeśli chcesz uruchomić zdalny debuger jako usługę. Aby uzyskać więcej informacji, zobacz (opcjonalnie) Konfigurowanie zdalnego debugera jako usługi.

Notatka

• Aby debugować aplikacje systemu Windows 10 lub nowsze na urządzeniach ARM, użyj usługi ARM64, która jest dostępna z najnowszą wersją narzędzi zdalnych.
• Aby debugować aplikacje systemu Windows 10 na urządzeniach z systemem Windows RT, użyj usługi ARM, która jest dostępna tylko w pobraniu narzędzi zdalnych programu Visual Studio 2015.
• Aby debugować aplikacje x64 w systemie operacyjnym ARM64, uruchom komponent x64 msvsmon.exe, który jest zainstalowany przy użyciu narzędzi zdalnych ARM64.

Konfigurowanie zdalnego debugera w systemie Windows Server

1. Na komputerze zdalnym znajdź i uruchom Remote Debugger z menu Start.

   Jeśli nie masz uprawnień administracyjnych na komputerze zdalnym, kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz pozycję Uruchom jako administrator. W przeciwnym razie po prostu uruchom go normalnie.

   Jeśli planujesz dołączyć do procesu, który jest uruchomiony jako administrator lub działa w ramach innego konta użytkownika (takiego jak usługi IIS), kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz Uruchom jako administrator. Żeby uzyskać więcej informacji, zobacz Uruchom zdalny debuger jako administrator.

2. Przy pierwszym uruchomieniu zdalnego debugera (lub zanim zostanie skonfigurowany) pojawi się kreator Remote Debugging Configuration.

   W większości scenariuszy wybierz pozycję Dalej, dopóki nie dotrzesz do strony Skonfiguruj zaporę systemu Windows kreatora.

   

3. Wybierz co najmniej jeden typ sieci, w którym chcesz używać narzędzi zdalnych. Jeśli komputery są połączone za pośrednictwem domeny, musisz wybrać pierwszy element. Jeśli komputery są połączone za pośrednictwem grupy roboczej lub grupy domowej, wybierz odpowiedni drugi lub trzeci element.

   Następnie wybierz pozycję Zakończ, aby uruchomić debuger zdalny.

4. Po zakończeniu konfiguracji zostanie wyświetlone okno Remote Debugger.

   

   Zdalny debuger czeka teraz na połączenie. Użyj nazwy serwera i podanego numeru portu, aby ustawić konfigurację połączenia zdalnego w programie Visual Studio.

Aby zatrzymać zdalny debuger, wybierz Plik>Zakończ. Można go ponownie uruchomić z menu Start lub z poziomu wiersza polecenia:

<Remote debugger installation directory>\msvsmon.exe

Notatka

Jeśli musisz dodać uprawnienia dla dodatkowych użytkowników, zmienić tryb uwierzytelniania lub numer portu debugera zdalnego, zobacz Konfigurowanie zdalnego debugera.

Aby uzyskać informacje na temat uruchamiania zdalnego debugera jako usługi, zobacz Uruchamianie zdalnego debugera jako usługi.

Dołączanie do aplikacji ASP.NET Core z komputera programu Visual Studio

Począwszy od programu Visual Studio 2022 w wersji 17.10 (wersja zapoznawcza 2), okno dialogowe Dołączanie do procesu zostało zmienione. Jeśli potrzebujesz instrukcji pasujących do starszego okna dialogowego, przejdź do widoku programu Visual Studio 2019 (selektor wersji w lewym górnym rogu w artykule).

1. Na komputerze programu Visual Studio otwórz rozwiązanie, które próbujesz debugować (MyASPApp, jeśli wykonasz wszystkie kroki opisane w tym artykule).

2. W programie Visual Studio wybierz pozycję Debug > Dołącz do procesu (Ctrl + Alt + P).

   Napiwek

   W programie Visual Studio 2017 i nowszych wersjach można ponownie przyłączyć się do tego samego procesu, do którego wcześniej przyłączono się, przy użyciu Debug > Ponownie dołącz do procesu... (Shift + Alt + P).

3. Ustaw typ połączenia na zdalny (Windows).

   Pojawi się opcja celu połączenia.

   Ustaw docelową połączenia<nazwę komputera zdalnego> i naciśnij Enter.

   Sprawdź, czy program Visual Studio dodaje wymagany port do nazwy komputera, która jest wyświetlana w formacie: <nazwa komputera zdalnego>:port

   W programie Visual Studio 2022 powinna zostać wyświetlona <nazwa komputera zdalnego>:4026

   Port jest wymagany. Jeśli nie widzisz numeru portu, dodaj go ręcznie.

4. Wybierz Odśwież.

   Powinny pojawić się niektóre procesy w oknie Dostępne Procesy.

   Jeśli nie widzisz żadnych procesów, spróbuj użyć adresu IP zamiast nazwy komputera zdalnego (wymagany jest port). Aby uzyskać adres IPv4, możesz użyć ipconfig w wierszu polecenia.

   Jeśli chcesz użyć przycisku Znajdź, może być konieczne otworzyć wychodzący port UDP 3702 na serwerze.

5. Sprawdź Pokaż procesy wszystkich użytkowników.

6. Wpisz pierwszą literę nazwy procesu, aby szybko znaleźć aplikację.

   • Jeśli używasz modelu hostingu przetwarzania na serwerze IIS, wybierz prawidłowy proces w3wp.exe. Począwszy od platformy .NET Core 3, ten proces jest domyślny.

   • W przeciwnym razie wybierz proces dotnet.exe. (Jest to model hostingu poza procesem).

   Jeśli masz wiele procesów pokazujących w3wp.exe lub dotnet.exe, sprawdź kolumnę Nazwa Użytkownika. W niektórych scenariuszach kolumna User Name zawiera nazwę puli aplikacji, taką jak IIS APPPOOL\DefaultAppPool. Jeśli widzisz pulę aplikacji, ale nie jest ona unikatowa, utwórz nową pulę aplikacji o nazwie dla wystąpienia aplikacji, które chcesz debugować, a następnie możesz ją łatwo znaleźć w kolumnie nazwa użytkownika.

   

7. Wybierz pozycję Dołącz.

8. Otwórz witrynę internetową komputera zdalnego. W przeglądarce przejdź do http://<nazwa komputera zdalnego>.

   Powinna zostać wyświetlona strona internetowa ASP.NET.

9. W uruchomionej aplikacji ASP.NET wybierz link do strony Prywatność.

   Punkt przerwania powinien wystąpić w programie Visual Studio.

   Jeśli nie możesz dołączyć ani osiągnąć punktu przerwania, zobacz Rozwiązywanie problemów z debugowaniem zdalnym.

Rozwiązywanie problemów z wdrażaniem usług IIS

• Jeśli nie możesz nawiązać połączenia z hostem przy użyciu nazwy hosta, spróbuj zamiast tego użyć adresu IP.
• Upewnij się, że wymagane porty są otwarte na serwerze zdalnym.
• W przypadku ASP.NET Core należy upewnić się, że pole puli aplikacji dla DefaultAppPool ma ustawioną wartość Brak zarządzanego kodu.
• Sprawdź, czy wersja ASP.NET używana w aplikacji jest taka sama jak wersja zainstalowana na serwerze. Dla aplikacji możesz wyświetlić i ustawić wersję na stronie właściwości . Aby ustawić aplikację na inną wersję, należy ją zainstalować.
• Jeśli aplikacja próbowała się otworzyć, ale zobaczysz ostrzeżenie o certyfikacie, wybierz opcję polegającą na zaufaniu do witryny. Jeśli ostrzeżenie zostało już zamknięte, możesz edytować profil publikowania, plik *.pubxml, w projekcie i dodać następujący element (tylko do testowania): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Po wdrożeniu uruchom aplikację w usługach IIS, aby sprawdzić, czy została wdrożona prawidłowo.
• Sprawdź okno Dane wyjściowe w programie Visual Studio, aby uzyskać informacje o stanie, i sprawdź komunikaty o błędach.

Otwieranie wymaganych portów w systemie Windows Server

W większości konfiguracji wymagane porty są otwierane przez instalację ASP.NET i debugera zdalnego. Może jednak być konieczne sprawdzenie, czy porty są otwarte.

Notatka

Na maszynie wirtualnej platformy Azure należy otworzyć porty za pośrednictwem sieciowej grupy zabezpieczeń.

Wymagane porty:

• 80: Wymagane dla usług IIS (HTTP).

• 4026: Wymagane do zdalnego debugowania z programu Visual Studio 2022 (zobacz Przypisania portów zdalnego debugera, aby uzyskać więcej informacji).

• UDP 3702: (Opcjonalnie) Port odnajdywania umożliwia użycie przycisku Znajdź podczas dołączania do zdalnego debugera w programie Visual Studio.

Ponadto te porty powinny być już otwarte przez instalację ASP.NET:

• 8172: (Opcjonalnie) Wymagane do wdrożenia aplikacji z programu Visual Studio za pomocą funkcji Web Deploy

Otwieranie portu

1. Aby otworzyć port w systemie Windows Server, otwórz menu Start , wyszukaj Zaporę Windows Defender lub zaporę systemu Windows z zabezpieczeniami zaawansowanymi.

   W przypadku zapory Windows Defenderwybierz ustawienia zaawansowane.

2. Następnie wybierz reguły ruchu przychodzącego > nowa reguła > Port, a następnie wybierz Dalej. (W przypadku protokołu UDP 3702 wybierz Reguły ruchu wychodzącego.)

3. W obszarze Określone porty lokalnewprowadź numer portu, a następnie wybierz pozycję Dalej.

4. Wybierz pozycję Zezwalaj na połączenie, a następnie wybierz pozycję Dalej.

5. Wybierz co najmniej jeden typ sieci do włączenia dla portu, a następnie wybierz pozycję Dalej.

   Wybrany typ musi zawierać sieć, z którą jest połączony komputer zdalny.

6. Dodaj nazwę (na przykład IIS, Web Deploylub msvsmon) dla reguły ruchu przychodzącego i wybierz opcję Zakończ.

   Nowa reguła powinna być widoczna na liście Reguły ruchu przychodzącego lub Reguły ruchu wychodzącego.

   Jeśli chcesz uzyskać więcej informacji na temat konfigurowania Zapory systemu Windows, zobacz Konfigurowanie zapory systemu Windows na potrzeby zdalnego debugowania.

7. Utwórz więcej reguł dla innych wymaganych portów.