<system.webServer>

项目
03/11/2024

概述

该 <system.webServer> 元素为 ApplicationHost.config 文件中 Internet Information Services (IIS) 7 的许多站点级和应用程序级配置设置指定了根元素，并包含定义 Web 服务器引擎和模块所使用的设置的配置元素。

注意

与在 <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> 元素中的设置委托给 Web.config 文件，但 <system.webServer> 元素是在 ApplicationHost.config 文件中定义的。

特性

无。

子元素

元素	说明
`applicationInitialization`	可选元素。配置适用于在收到请求前主动执行的应用程序初始化的设置。
`asp`	可选元素。配置 Active Server Pages (ASP) 应用程序的设置。
`caching`	可选元素。配置输出缓存设置。
`cgi`	可选元素。配置通用网关接口 (CGI) 应用程序的默认设置。
`defaultDocument`	可选元素。配置当客户端未在请求中指定文件名时，将默认文档返回到客户端浏览器的设置。
`directoryBrowse`	可选元素。配置在 Web 服务器上是启用还是禁用目录浏览，并指定要包含在目录列表中的信息。
`fastCgi`	可选元素。包含 fastCgi 应用程序池定义的集合。
`globalModules`	可选元素。指定 Web 服务器上全局模块的配置设置。
`handlers`	可选元素。指定处理程序，以处理对站点和应用程序发出的请求。
`httpCompression`	可选元素。配置 Web 服务器的 HTTP 压缩设置。
`httpErrors`	可选元素。配置 Web 服务器的 HTTP 错误消息。
`httpLogging`	可选元素。指定 HTTP.sys 日志记录的配置设置。
`httpProtocol`	可选元素。配置要从服务器发送到客户端的自定义和重定向响应标头。
`httpRedirect`	可选元素。配置用于将客户端请求重定向到新位置的设置。
`httpTracing`	可选元素。指定用于 HTTP.sys 跟踪的配置设置。
`isapiFilters`	可选元素。指定用于 Web 服务器上 ISAPI 筛选器的配置设置。
`management`	可选元素。配置通过使用 IIS 管理器进行远程管理的 Web 服务器。
`modules`	可选元素。指定 Web 服务器上模块的配置设置。
`odbcLogging`	可选元素。配置开放式数据库连接 (ODBC) 日志记录。
`security`	可选元素。指定包含安全相关节的节组。
`serverRuntime`	可选元素。配置适用于 Web 服务器上应用程序的请求限制。
`serverSideInclude`	可选元素。指定是否禁用服务器端包括 (SSI) #exec 指令。
`staticContent`	可选元素。配置静态文件请求处理程序设置。
`tracing`	可选元素。配置请求跟踪设置。
`urlCompression`	可选元素。配置静态和动态内容的压缩。
`validation`	可选元素。配置 IIS 7，以检测设置为在 ISAPI 模式下运行的 ASP.NET 应用程序是否需要任何迁移才能在集成模式下正常运行。
`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> 元素中所发现设置的代码示例，请参阅本主题配置详细信息部分中列出的子元素。

通过

<system.webServer>

概述

兼容性

安装

操作方式

配置

特性

子元素

配置示例

代码示例

反馈

其他资源