<system.webServer>
Общие сведения
Элемент <system.webServer>
задает корневой элемент для многих параметров конфигурации уровня сайта и приложения для служб IIS 7 в файле ApplicationHost.config и содержит элементы конфигурации, определяющие параметры, используемые подсистемой и модулями веб-сервера.
Примечание
В отличие от параметров, которые находятся в <system.applicationHost
>, параметры в элементе <system.webServer>
можно делегировать.
Совместимость
Версия | Примечания |
---|---|
IIS 10.0 | Элемент <applicationInitialization> не был изменен в IIS 10.0. |
IIS 8,5 | Элемент <system.webServer> не был изменен в IIS 8.5. |
IIS 8,0 | Элементы <applicationInitialization> и <webSocket> были добавлены в качестве дочерних элементов. |
IIS 7,5 | Элемент <system.webServer> не был изменен в IIS 7.5. |
IIS 7.0 | Элемент <system.webServer> появился в IIS 7.0. |
IIS 6,0 | Н/Д |
Настройка
Элемент <system.webServer>
включен в установку iis 7 по умолчанию.
Инструкции
Примеры, относящиеся к элементу , <system.webServer>
отсутствуют. Примеры настройки параметров, которые находятся в элементе <system.webServer>
, см. в разделе дочерних элементов, перечисленных в разделе сведений о конфигурации этого раздела.
Конфигурация
Элемент <system.webServer>
определяется в файле ApplicationHost.config, хотя параметры в <system.webServer>
элементе можно делегировать Web.config файлам.
Атрибуты
Отсутствует.
Дочерние элементы
Элемент | Описание |
---|---|
applicationInitialization |
Необязательный элемент. Настраивает параметры инициализации приложения, которая выполняется упреждающе перед получением запроса. |
asp |
Необязательный элемент. Настраивает параметры для приложений ASP. |
caching |
Необязательный элемент. Настраивает параметры кэша вывода. |
cgi |
Необязательный элемент. Настраивает параметры по умолчанию для приложений CGI. |
defaultDocument |
Необязательный элемент. Настраивает параметры возврата документа по умолчанию в браузер клиента, если клиент не указывает имя файла в запросе. |
directoryBrowse |
Необязательный элемент. Указывает, включен или отключен просмотр каталогов на веб-сервере, а также указывает сведения для включения в список каталогов. |
fastCgi |
Необязательный элемент. Содержит коллекцию определений пула приложений fastCgi. |
globalModules |
Необязательный элемент. Задает параметры конфигурации для глобальных модулей на веб-сервере. |
handlers |
Необязательный элемент. Задает обработчики для обработки запросов к сайтам и приложениям. |
httpCompression |
Необязательный элемент. Настраивает параметры сжатия HTTP для веб-сервера. |
httpErrors |
Необязательный элемент. Настраивает сообщения об ошибках HTTP для веб-сервера. |
httpLogging |
Необязательный элемент. Задает параметры конфигурации для ведения журнала HTTP.sys. |
httpProtocol |
Необязательный элемент. Настраивает пользовательские заголовки ответов и заголовки ответов перенаправления для отправки с сервера клиенту. |
httpRedirect |
Необязательный элемент. Настраивает параметры для перенаправления клиентских запросов в новое расположение. |
httpTracing |
Необязательный элемент. Задает параметры конфигурации для трассировки HTTP.sys. |
isapiFilters |
Необязательный элемент. Задает параметры конфигурации для фильтров ISAPI на веб-сервере. |
management |
Необязательный элемент. Настраивает веб-сервер для удаленного управления с помощью диспетчера IIS. |
modules |
Необязательный элемент. Задает параметры конфигурации для модулей на веб-сервере. |
odbcLogging |
Необязательный элемент. Настраивает ведение журнала ODBC. |
security |
Необязательный элемент. Указывает группу разделов, содержащую разделы, связанные с безопасностью. |
serverRuntime |
Необязательный элемент. Настраивает ограничения запросов для приложений на веб-сервере. |
serverSideInclude |
Необязательный элемент. Указывает, отключены ли директивы SSI #exec на стороне сервера. |
staticContent |
Необязательный элемент. Настраивает параметры обработчика запросов статических файлов. |
tracing |
Необязательный элемент. Настраивает параметры трассировки запросов. |
urlCompression |
Необязательный элемент. Настраивает сжатие статического и динамического содержимого. |
validation |
Необязательный элемент. Настраивает IIS 7, чтобы определить, требуется ли миграция приложения ASP.NET, настроенного для работы в режиме ISAPI, для правильной работы в режиме интеграции. |
webdav |
Необязательный элемент. Настраивает параметры публикации WebDAV. |
webSocket |
Необязательный элемент. Настраивает обмен данными по протоколу WebSocket. |
Образец конфигурации
В следующем примере конфигурации определяется простой элемент, доступный только <system.webServer>
для статического содержимого.
<system.webServer>
<asp />
<caching enabled="true" enableKernelCache="true" />
<cgi />
<defaultDocument enabled="true">
<files>
<add value="Default.htm" />
<add value="Index.htm" />
<add value="Index.html" />
</files>
</defaultDocument>
<directoryBrowse enabled="false" />
<fastCgi />
<globalModules>
<add name="UriCacheModule" image="%windir%\System32\inetsrv\cachuri.dll" />
<add name="FileCacheModule" image="%windir%\System32\inetsrv\cachfile.dll" />
<add name="TokenCacheModule" image="%windir%\System32\inetsrv\cachtokn.dll" />
<add name="HttpCacheModule" image="%windir%\System32\inetsrv\cachhttp.dll" />
<add name="StaticCompressionModule" image="%windir%\System32\inetsrv\compstat.dll" />
<add name="DefaultDocumentModule" image="%windir%\System32\inetsrv\defdoc.dll" />
<add name="DirectoryListingModule" image="%windir%\System32\inetsrv\dirlist.dll" />
<add name="ProtocolSupportModule" image="%windir%\System32\inetsrv\protsup.dll" />
<add name="StaticFileModule" image="%windir%\System32\inetsrv\static.dll" />
<add name="AnonymousAuthenticationModule" image="%windir%\System32\inetsrv\authanon.dll" />
<add name="RequestFilteringModule" image="%windir%\System32\inetsrv\modrqflt.dll" />
<add name="CustomErrorModule" image="%windir%\System32\inetsrv\custerr.dll" />
<add name="HttpLoggingModule" image="%windir%\System32\inetsrv\loghttp.dll" />
<add name="RequestMonitorModule" image="%windir%\System32\inetsrv\iisreqs.dll" />
</globalModules>
<httpCompression directory="%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files">
<scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll" />
<staticTypes>
<add mimeType="text/*" enabled="true" />
<add mimeType="message/*" enabled="true" />
<add mimeType="application/javascript" enabled="true" />
<add mimeType="*/*" enabled="false" />
</staticTypes>
</httpCompression>
<httpErrors>
<error statusCode="401" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="401.htm" />
<error statusCode="403" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="403.htm" />
<error statusCode="404" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="404.htm" />
<error statusCode="405" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="405.htm" />
<error statusCode="406" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="406.htm" />
<error statusCode="412" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="412.htm" />
<error statusCode="500" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="500.htm" />
<error statusCode="501" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="501.htm" />
<error statusCode="502" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="502.htm" />
</httpErrors>
<httpLogging dontLog="false" />
<httpProtocol />
<httpRedirect />
<httpTracing />
<isapiFilters />
<odbcLogging />
<security>
<access sslFlags="None" />
<applicationDependencies />
<authentication>
<anonymousAuthentication enabled="true" userName="IUSR" />
<basicAuthentication />
<clientCertificateMappingAuthentication />
<digestAuthentication />
<iisClientCertificateMappingAuthentication />
<windowsAuthentication />
</authentication>
<authorization />
<ipSecurity />
<isapiCgiRestriction notListedIsapisAllowed="false" notListedCgisAllowed="false">
<clear />
</isapiCgiRestriction>
<requestFiltering>
<fileExtensions allowUnlisted="true" applyToWebDAV="true" />
<verbs allowUnlisted="true" applyToWebDAV="true" />
<hiddenSegments applyToWebDAV="true">
<add segment="Web.config" />
</hiddenSegments>
</requestFiltering>
</security>
<serverRuntime />
<serverSideInclude />
<staticContent lockAttributes="isDocFooterFileName">
<mimeMap fileExtension=".png" mimeType="image/gif" />
<mimeMap fileExtension=".htm" mimeType="text/html" />
<mimeMap fileExtension=".html" mimeType="text/html" />
<mimeMap fileExtension=".jpeg" mimeType="image/jpeg" />
<mimeMap fileExtension=".png" mimeType="image/jpeg" />
<mimeMap fileExtension=".js" mimeType="application/x-javascript" />
<mimeMap fileExtension=".png" mimeType="image/png" />
<mimeMap fileExtension=".txt" mimeType="text/plain" />
</staticContent>
<tracing>
<traceFailedRequests />
<traceProviderDefinitions />
</tracing>
<urlCompression />
<validation />
<webSocket />
</system.webServer>
Пример кода
Примеры кода, относящиеся к элементу <system.webServer>
, отсутствуют. Примеры кода, которые настраивают параметры, находящиеся в элементе <system.webServer>
, см. в разделе дочерних элементов, перечисленных в разделе сведений о конфигурации этого раздела.