Zdalne debugowanie ASP.NET Core na zdalnym komputerze usług 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 skonfigurować i skonfigurować program Visual Studio ASP.NET Core, wdrożyć go w usługach IIS i dołączyć zdalny debuger z programu Visual Studio. Aby przeprowadzić zdalne debugowanie ASP.NET 4.8, zobacz Remote Debug ASP.NET na komputerze usług IIS. Możesz również wdrażać i debugować w usługach IIS przy użyciu platformy Azure. Aby uzyskać aplikacja systemu Azure Service, zobacz Remote debug ASP.NET Core on Azure (Zdalne debugowanie ASP.NET Core na platformie Azure) lub w przypadku programu Visual Studio Enterprise użyj narzędzia Snapshot Debugger (wymagana jest wersja 4.6.1).

Wymagania 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 duże opóźnienie lub połączenie o niskiej przepustowości, takie jak połączenie telefoniczne z Internetem lub przez Internet w różnych krajach/regionach, nie jest zalecane i może zakończyć się niepowodzeniem lub być niedopuszczalnie powolne. 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 pozycji 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ę Okno uruchamiania pliku>, aby otworzyć okno uruchamiania, a następnie wybierz pozycję Utwórz nowy projekt. W polu wyszukiwania wpisz aplikacja internetowa, a następnie wybierz pozycję C# jako język, a następnie wybierz pozycję ASP.NET Core Web Application (Model-View-Controller), a następnie wybierz przycisk 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 return View; instrukcji 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 Publikowanie w usługach IIS lub IIS 8.0 przy użyciu ASP.NET 3.5 i ASP.NET 4.5.

W przypadku systemów operacyjnych Windows Server użyj kreatora Dodawanie ról i funkcji za pośrednictwem linku Zarządzaj lub linku Pulpit nawigacyjny w Menedżer serwera. W kroku Role serwera zaznacz pole wyboru Web Server (IIS).

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

W kroku Usługi ról wybierz wybrane usługi ról USŁUG IIS 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
• Management Service
• Konsola zarządzania usługami 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 pozycji Witryny zaufane witryny >zabezpieczeń > opcji > internetowych. 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 pozycję Dodaj po wyświetleniu monitu.

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 Module. Aby uzyskać bardziej szczegółowe instrukcje, zobacz Publikowanie w usługach IIS.

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

   Uwaga

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

   W przypadku platformy .NET Core 2 zainstaluj hosting systemu Windows Server platformy .NET Core.

   Uwaga

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

2. Uruchom ponownie system (lub wykonaj polecenie net stop był /y , a następnie net start w3svc z wiersza polecenia, aby pobrać zmianę ścieżki systemowej).

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óż przez opublikowanie w folderze lokalnym i skopiowanie danych wyjściowych przez preferowaną metodę do przygotowanego folderu aplikacji w usługach 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.

Uwaga

Jeśli chcesz ręcznie skonfigurować narzędzie Web Deploy zamiast importować ustawienia publikowania, należy upewnić 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 Połączenia wybierz pozycję Pule aplikacji. Otwórz pulę DefaultAppPool i ustaw wersję środowiska .NET CLR na Wartość Brak kodu zarządzanego. Jest to wymagane dla ASP.NET Core. Domyślna witryna sieci Web używa puli DefaultAppPool.

2. Zatrzymaj i uruchom ponownie pulę 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.

Uwaga

Instalator platformy internetowej osiągnął koniec życia w dniu 7/1/22. Aby uzyskać więcej informacji, zobacz Instalator platformy internetowej — koniec pomocy technicznej i zakończenie kanału informacyjnego 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 go teraz.

   Przejdź do pozycji Wybierz role>serwera sieci Web (IIS)>Narzędzia do zarządzania, a następnie wybierz rolę Skrypty zarządzania usługami IIS i narzędzia, kliknij przycisk 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 i konsolę zarządzania usługami IIS (mogą one być już zainstalowane).

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

3. Uruchom program instalacyjny Web Deploy i upewnij się, że wybrano opcję Ukończ instalację zamiast typowej instalacji.

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

   

4. (Opcjonalnie) Sprawdź, czy narzędzie Web Deploy działa prawidłowo, otwierając Panel sterowania usługę System and Security > Administrative Tools > Services, a następnie upewnij się, > że:

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

   • Usługa zarządzania siecią Web jest uruchomiona.

   Jeśli jedna z usług agenta nie jest uruchomiona, uruchom ponownie usługę agenta wdrażania sieci Web.

   Jeśli usługa agenta wdrażania sieci Web nie jest w ogóle obecna, przejdź do Panel sterowania Programy Odinstaluj program, znajdź wersję> programu Microsoft Web Deploy<.> > Wybierz opcję Zmień instalację i upewnij się, że wybierzesz pozycję Zostanie zainstalowana na lokalnym dysku twardym 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 polecenie Wdróż>konfigurowanie publikowania w sieci Web.

   

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

3. W oknie dialogowym Konfigurowanie publikowania w narzędziu Web Deploy sprawdź ustawienia.

4. Kliknij przycisk Ustawienia.

   W panelu Wyniki dane wyjściowe pokazują, że prawa dostępu są przyznawane określonemu użytkownikowi, a 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. (W celach http://myhostname:8172 testowych zazwyczaj działa również).

   • Port publishUrl jest ustawiony na port 8172, który jest domyślny dla narzędzia 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.

     Uwaga

     Jeśli publikujesz w usługach IIS uruchomionych na maszynie wirtualnej platformy Azure, musisz otworzyć port przychodzący dla programu Web Deploy i usług IIS w sieciowej grupie zabezpieczeń. Aby uzyskać szczegółowe informacje, zobacz 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 Eksplorator rozwiązań, a następnie wybierz polecenie Publikuj.

   Jeśli wcześniej skonfigurowano wszystkie profile publikowania, zostanie wyświetlone okienko Publikowanie . 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 Importowanie pliku ustawień publikowania przejdź do i wybierz profil utworzony w poprzedniej sekcji, a następnie kliknij przycisk Otwórz.

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

   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 pozycję Więcej akcji>Edytuj, aby edytować ustawienia. Zmodyfikuj ustawienia i kliknij pozycję Weryfikuj , aby przetestować nowe ustawienia. Jeśli nazwa hosta nie zostanie znaleziona, spróbuj użyć adresu IP zamiast nazwy hosta w polach Serwer i Docelowy adres 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 pole Pula aplikacji dla puli DefaultAppPool ma ustawioną wartość Brak kodu zarządzanego.

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

Ważne

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ę debugowania , a następnie wybierz pozycję Usuń dodatkowe pliki w miejscu docelowym w obszarze Opcje publikowania pliku.

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 w usługach IIS 8.0 lub nowszych. 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, aby użyć go do wdrożenia projektu ASP.NET Core.

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

3. W obszarze Połączenia w okienku po lewej stronie przejdź do pozycji Witryny.

4. Wybierz domyślną witrynę sieci Web, wybierz pozycję Ustawienia podstawowe i ustaw ścieżkę fizyczną na C:\Publish.

5. Kliknij prawym przyciskiem myszy węzeł Domyślna witryna sieci Web i wybierz polecenie Dodaj aplikację.

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

7. W obszarze Połączenia wybierz pozycję Pule aplikacji. Otwórz wartość DefaultAppPool i ustaw pole Pula aplikacji na Wartość Brak kodu zarządzanego.

8. Kliknij prawym przyciskiem myszy nową witrynę w Menedżerze usług IIS, wybierz polecenie Edytuj uprawnienia i upewnij się, że usługa IUSR, IIS_IUSRS lub użytkownik skonfigurowany pod kątem dostępu do aplikacji internetowej jest autoryzowanym użytkownikiem z uprawnieniami do odczytu i wykonywania.

   Jeśli nie widzisz jednego z tych użytkowników z dostępem, wykonaj kroki dodawania IUSR jako użytkownika z prawami do odczytu i wykonywania.

Ważne

Aby uzyskać informacje o zabezpieczeniach związane z wbudowanymi kontami, zobacz Understanding Built-In User and Group Accounts in IIS 7 (Opis wbudowanych kont użytkowników i grup w usługach 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 Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Publikuj (w obszarze Formularze internetowe, Publikuj aplikację internetową).

   Jeśli wcześniej skonfigurowano wszystkie profile publikowania, zostanie wyświetlone okienko Publikowanie . Kliknij pozycję Nowy profil.

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

   

   Kliknij przycisk 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ę debugowania , a następnie wybierz pozycję Usuń dodatkowe pliki w miejscu docelowym w obszarze Opcje publikowania pliku.

   

   Uwaga

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

4. Kliknij przycisk Publikuj.

   Aplikacja publikuje konfigurację debugowania projektu w folderze lokalnym. Postęp jest wyświetlany w oknie Dane wyjściowe.

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.

   Uwaga

   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 zostanie wyświetlone cannot find or open the PDB file ostrzeżenie 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	Link	Uwagi
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 Odblokowywanie pobierania 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. W starszych wersjach systemu Windows Server zobacz Odblokowywanie pobierania plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
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. W systemie Windows Server zobacz Odblokowywanie pobierania plików, aby uzyskać pomoc dotyczącą pobierania 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 plików, 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.

Uwaga

• 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 msvsmon.exe x64 zainstalowane za pomocą narzędzi zdalnych ARM64.

Konfigurowanie zdalnego debugera w systemie Windows Server

1. Na komputerze zdalnym znajdź i uruchom debuger zdalny z menu Start .

   Jeśli nie masz uprawnień administracyjnych na komputerze zdalnym, kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz polecenie 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 polecenie Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz Uruchamianie zdalnego debugera jako administrator.

2. Przy pierwszym uruchomieniu debugera zdalnego (lub przed jego skonfigurowaniem) zostanie wyświetlony kreator Konfiguracja debugowania zdalnego.

   W większości scenariuszy wybierz pozycję Dalej , dopóki nie zostanie wyświetlona strona Konfigurowanie Zapory 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 Debuger zdalny.

   

   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 pozycję Plik>Zakończ. Można go ponownie uruchomić z menu Start lub z poziomu wiersza polecenia:

<Remote debugger installation directory>\msvsmon.exe

Uwaga

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ę Dołącz debugowanie > do procesu (Ctrl + Alt + P).

   Napiwek

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

3. Ustaw wartość Typ połączenia na Remote (Windows).

   Zostanie wyświetlona opcja Cel połączenia.

   Ustaw wartość Element docelowy połączenia na< nazwę> komputera zdalnego i naciśnij Enter.

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

   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ż.

   W oknie Dostępne procesy powinny zostać wyświetlone pewne procesy.

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

   Jeśli chcesz użyć przycisku Znajdź , może być konieczne otwarcie wychodzącego portu UDP 3702 na serwerze.

5. Zaznacz pole Wyboru Pokaż procesy od wszystkich użytkowników.

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

   • Jeśli używasz modelu hostingu w procesie w usługach 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 (Nazwa użytkownika) zawiera nazwę puli aplikacji, taką jak IIS APPPOOL\DefaultAppPool. Jeśli widzisz pulę aplikacji, ale nie jest ona unikatowa, utwórz nową nazwę o nazwie Pula aplikacji dla wystąpienia aplikacji, które chcesz debugować, a następnie możesz ją łatwo znaleźć w kolumnie Nazwa użytkownika.

   

7. Wybierz Dołącz.

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

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

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

   Punkt przerwania powinien zostać trafiony w programie Visual Studio.

   Jeśli nie możesz dołączyć lub trafić do 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 Pula aplikacji dla puli aplikacji ma ustawioną wartość Brak kodu zarządzanego.
• Sprawdź, czy wersja ASP.NET używana w aplikacji jest taka sama jak wersja zainstalowana na serwerze. W przypadku 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 otworzyć, ale zostanie wyświetlone ostrzeżenie o certyfikacie, wybierz opcję zaufania 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.

Uwaga

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 Zdalne przypisania portów debugera, aby uzyskać więcej informacji).

• Port UDP 3702: (Opcjonalnie) Odnajdywanie 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 poziomu programu Visual Studio w programie Web Deploy

Otwieranie portu

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

   W obszarze Zapora Windows Defender wybierz pozycję Ustawienia zaawansowane.

2. Następnie wybierz pozycję Reguły > ruchu przychodzącego Nowy port reguły>, a następnie wybierz pozycję Dalej. (W przypadku protokołu UDP 3702 wybierz pozycję Zamiast tego reguły ruchu wychodzącego.

3. W obszarze Określone porty lokalne wprowadź numer portu, wybierz pozycję Dalej.

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

5. Wybierz co najmniej jeden typ sieci, aby włączyć port, a następnie wybierz przycisk Dalej.

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

6. Dodaj nazwę (na przykład IIS, Web Deploy lub msvsmon) dla reguły ruchu przychodzącego i wybierz pozycję 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.