Udostępnij za pośrednictwem


Moduły usług IIS z platformą ASP.NET Core

Uwaga

Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z bieżącą wersją, zapoznaj się z wersją tego artykułu platformy .NET 8.

Ostrzeżenie

Ta wersja ASP.NET Core nie jest już obsługiwana. Aby uzyskać więcej informacji, zobacz .NET i .NET Core Support Policy (Zasady obsługi platformy .NET Core). Aby zapoznać się z bieżącą wersją, zapoznaj się z wersją tego artykułu platformy .NET 8.

Ważne

Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany, zanim zostanie wydany komercyjnie. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Aby zapoznać się z bieżącą wersją, zapoznaj się z wersją tego artykułu platformy .NET 8.

Niektóre z natywnych modułów usług IIS i wszystkich modułów zarządzanych przez usługi IIS nie mogą przetwarzać żądań dotyczących aplikacji ASP.NET Core. W wielu przypadkach ASP.NET Core oferuje alternatywę dla scenariuszy, które są obsługiwane przez moduły natywne i zarządzane przez usługi IIS.

Moduły natywne

Tabela wskazuje natywne moduły usług IIS, które działają z aplikacjami ASP.NET Core i modułem ASP.NET Core.

Moduł Funkcja z aplikacjami platformy ASP.NET Core opcja ASP.NET Core
Uwierzytelnianie anonimowe
AnonymousAuthenticationModule
Tak
Uwierzytelnianie podstawowe
BasicAuthenticationModule
Tak
Uwierzytelnianie mapowania certyfikatów klienta
CertificateMappingAuthenticationModule
Tak
CGI
CgiModule
Nie.
Weryfikacja konfiguracji
ConfigurationValidationModule
Tak
Błędy HTTP
CustomErrorModule
Nie. Oprogramowanie pośredniczące stron kodu stanu
Rejestrowanie niestandardowe
CustomLoggingModule
Tak
Dokument domyślny
DefaultDocumentModule
Nie. Domyślne oprogramowanie pośredniczące plików
Uwierzytelnianie szyfrowane
DigestAuthenticationModule
Tak
Przeglądanie katalogów
DirectoryListingModule
Nie. Oprogramowanie pośredniczące przeglądania katalogów
Kompresja dynamiczna
DynamicCompressionModule
Tak Oprogramowanie pośredniczące kompresji odpowiedzi
Śledzenie żądań, które zakończyło się niepowodzeniem
FailedRequestsTracingModule
Tak ASP.NET Core Logging
Buforowanie plików
FileCacheModule
Nie. Oprogramowanie pośredniczące buforowania odpowiedzi
Buforowanie HTTP
HttpCacheModule
Nie. Oprogramowanie pośredniczące buforowania odpowiedzi
Rejestrowanie HTTP
HttpLoggingModule
Tak ASP.NET Core Logging
Przekierowywanie HTTP
HttpRedirectionModule
Tak Oprogramowanie pośredniczące ponownego zapisywania adresów URL
Śledzenie HTTP
TracingModule
Tak
Uwierzytelnianie mapowania certyfikatu klienta usług IIS
IISCertificateMappingAuthenticationModule
Tak
Ograniczenia adresów IP i domen
IpRestrictionModule
Tak
Filtry ISAPI
IsapiFilterModule
Tak Oprogramowanie pośredniczące
ISAPI
IsapiModule
Tak Oprogramowanie pośredniczące
Obsługa protokołu
ProtocolSupportModule
Tak
Filtrowanie żądań
RequestFilteringModule
Tak Ponowne zapisywanie adresów URL oprogramowania pośredniczącego IRule
Monitor żądań
RequestMonitorModule
Tak
Ponowne zapisywanie adresów URL†
RewriteModule
Tak Oprogramowanie pośredniczące ponownego zapisywania adresów URL
Dołączanie po stronie serwera
ServerSideIncludeModule
Nie.
Kompresja statyczna
StaticCompressionModule
Nie. Oprogramowanie pośredniczące kompresji odpowiedzi
Zawartość statyczna
StaticFileModule
Nie. Oprogramowanie pośredniczące plików statycznych
Buforowanie tokenów
TokenCacheModule
Tak
Buforowanie identyfikatorów URI
UriCacheModule
Tak
Autoryzacja adresów URL
UrlAuthorizationModule
Tak ASP.NET Core Identity
WebDav
WebDAV
Nie.
Uwierzytelnianie systemu Windows
WindowsAuthenticationModule
Tak

† Typy dopasowania modułu isFile ponownego zapisywania adresów URL i isDirectory dopasowywania nie działają z aplikacjami ASP.NET Core ze względu na zmiany struktury katalogów.

Moduły zarządzane

Moduły zarządzane nie działają z hostowanymi aplikacjami ASP.NET Core, gdy wersja środowiska .NET CLR puli aplikacji jest ustawiona na wartość Brak kodu zarządzanego. ASP.NET Core oferuje alternatywy oprogramowania pośredniczącego w kilku przypadkach.

Moduł opcja ASP.NET Core
Anonimowedentyfikacja
DefaultAuthentication
FileAuthorization
FormsAuthentication Cookie Oprogramowanie pośredniczące uwierzytelniania
OutputCache Oprogramowanie pośredniczące buforowania odpowiedzi
Profil
RoleManager
ScriptModule-4.0
Sesja Oprogramowanie pośredniczące sesji
UrlAuthorization
UrlMappingsModule Oprogramowanie pośredniczące ponownego zapisywania adresów URL
UrlRoutingModule-4.0 ASP.NET Core Identity
WindowsAuthentication

Zmiany aplikacji Menedżera usług IIS

W przypadku konfigurowania ustawień za pomocą Menedżera usług IIS plik web.config aplikacji zostanie zmieniony. W przypadku wdrażania aplikacji i dołączania pliku web.config wszelkie zmiany wprowadzone w Menedżerze usług IIS zostaną zastąpione przez wdrożony plik web.config . Jeśli zmiany zostaną wprowadzone w pliku web.config serwera, skopiuj zaktualizowany plik web.config na serwerze do projektu lokalnego natychmiast.

Wyłączanie modułów usług IIS

Jeśli moduł usług IIS jest skonfigurowany na poziomie serwera, który musi być wyłączony dla aplikacji, dodatek do pliku web.config aplikacji może wyłączyć moduł. Pozostaw moduł i zdezaktywuj go przy użyciu ustawienia konfiguracji (jeśli jest dostępne) lub usuń moduł z aplikacji.

Dezaktywacja modułu

Wiele modułów oferuje ustawienie konfiguracji, które umożliwia ich wyłączenie bez usuwania modułu z aplikacji. Jest to najprostszy i najszybszy sposób dezaktywowania modułu. Na przykład moduł przekierowania HTTP można wyłączyć za pomocą elementu w pliku <httpRedirect> web.config:

<configuration>
  <system.webServer>
    <httpRedirect enabled="false" />
  </system.webServer>
</configuration>

Aby uzyskać więcej informacji na temat wyłączania modułów z ustawieniami konfiguracji, skorzystaj z linków w sekcji Elementy podrzędne usług IIS <system.webServer>.

Usuwanie modułu

Jeśli zdecydujesz się usunąć moduł z ustawieniem w pliku web.config, odblokuj moduł i odblokuj <modules> najpierw sekcję pliku web.config :

  1. Odblokuj moduł na poziomie serwera. Wybierz serwer IIS na pasku bocznym Połączenia menedżera usług IIS. Otwórz moduły w obszarze IIS. Wybierz moduł z listy. Na pasku bocznym Akcje po prawej stronie wybierz pozycję Odblokuj. Jeśli wpis akcji dla modułu będzie wyświetlany jako Blokada, moduł jest już odblokowany i nie jest wymagana żadna akcja. Odblokuj tyle modułów, ile planujesz później usunąć z pliku web.config .

  2. Wdróż aplikację <modules> bez sekcji w pliku web.config. Jeśli aplikacja jest wdrażana przy użyciu pliku web.config zawierającego <modules> sekcję bez odblokowania sekcji najpierw w Menedżerze usług IIS, program Configuration Manager zgłasza wyjątek podczas próby odblokowania sekcji. W związku z tym wdróż aplikację <modules> bez sekcji.

  3. Odblokuj sekcję <modules> pliku web.config. Na pasku bocznym Połączenia wybierz witrynę internetową w obszarze Witryny. W obszarze Zarządzanie otwórz Edytor konfiguracji. Użyj kontrolek nawigacji, aby wybrać sekcję system.webServer/modules . Na pasku bocznym Akcje po prawej stronie wybierz pozycję Odblokuj sekcję. Jeśli wpis akcji dla sekcji modułu zostanie wyświetlony jako Sekcja blokady, sekcja modułu jest już odblokowana i nie jest wymagana żadna akcja.

  4. Dodaj sekcję <modules> do lokalnego pliku web.config aplikacji z elementem <remove> , aby usunąć moduł z aplikacji. Dodaj wiele <remove> elementów, aby usunąć wiele modułów. Jeśli zmiany web.config zostaną wprowadzone na serwerze, natychmiast wprowadź te same zmiany w pliku web.config projektu lokalnie. Usunięcie modułu przy użyciu tego podejścia nie ma wpływu na użycie modułu z innymi aplikacjami na serwerze.

    <configuration>
     <system.webServer>
       <modules>
         <remove name="MODULE_NAME" />
       </modules>
     </system.webServer>
    </configuration>
    

Aby dodać lub usunąć moduły dla programu IIS Express przy użyciu pliku web.config, zmodyfikuj plik applicationHost.config, aby odblokować sekcję<modules>:

  1. Otwórz plik {APPLICATION ROOT}\.vs\config\applicationhost.config.

  2. Znajdź element dla modułów usług IIS i zmień wartość <section> overrideModeDefault z Deny na Allow:

    <section name="modules"
             allowDefinition="MachineToApplication"
             overrideModeDefault="Allow" />
    
  3. Znajdź sekcję <location path="" overrideMode="Allow"><system.webServer><modules> . W przypadku wszystkich modułów, które chcesz usunąć, ustaw wartość lockItem z true na false. W poniższym przykładzie moduł CGI jest odblokowany:

    <add name="CgiModule" lockItem="false" />
    
  4. Po odblokowaniu <modules> sekcji i poszczególnych modułów możesz dodawać lub usuwać moduły usług IIS przy użyciu pliku web.config aplikacji do uruchamiania aplikacji w programie IIS Express.

Moduł usług IIS można również usunąć za pomocą Appcmd.exe. Podaj polecenie MODULE_NAME i APPLICATION_NAME w poleceniu:

Appcmd.exe delete module MODULE_NAME /app.name:APPLICATION_NAME

Na przykład usuń element DynamicCompressionModule z domyślnej witryny sieci Web:

%windir%\system32\inetsrv\appcmd.exe delete module DynamicCompressionModule /app.name:"Default Web Site"

Minimalna konfiguracja modułu

Jedynymi modułami wymaganymi do uruchomienia aplikacji ASP.NET Core są moduł uwierzytelniania anonimowego i moduł ASP.NET Core.

Moduł buforowania identyfikatora URI (UriCacheModule) umożliwia usługom IIS buforowanie konfiguracji witryny sieci Web na poziomie adresu URL. Bez tego modułu usługi IIS muszą odczytywać i analizować konfigurację każdego żądania, nawet jeśli ten sam adres URL jest wielokrotnie żądany. Analizowanie konfiguracji każdego żądania powoduje znaczną karę za wydajność. Mimo że moduł buforowania identyfikatora URI nie jest ściśle wymagany do uruchomienia hostowanej aplikacji ASP.NET Core, zalecamy włączenie modułu buforowania identyfikatora URI dla wszystkich wdrożeń ASP.NET Core.

Moduł buforowania HTTP (HttpCacheModule) implementuje pamięć podręczną danych wyjściowych usług IIS, a także logikę buforowania elementów w pamięci podręcznej HTTP.sys. Bez tego modułu zawartość nie jest już buforowana w trybie jądra, a profile pamięci podręcznej są ignorowane. Usunięcie modułu buforowania HTTP zwykle ma negatywny wpływ na wydajność i użycie zasobów. Mimo że moduł buforowania HTTP nie jest ściśle wymagany do uruchomienia hostowanej aplikacji ASP.NET Core, zalecamy włączenie modułu buforowania HTTP dla wszystkich wdrożeń ASP.NET Core.

Dodatkowe zasoby