Web.config设置system.webServer

2022-09-25 12:03:05

　　一般情况在iis部署web网站都非常顺利，但是遇到复杂环境，或者被配置过又正在使用的时候，就束手无策了，

　　因为对IIS和Web.config不熟悉，不知其中要害，导致浪费一天甚至更久的时间去处理一个可能是不起眼的配置问题

　　本文主要和大家共同探讨下Web.config的system.webServer节点配置，如有错误之处，劳烦指点下

　　环境：IIS 7.0及以上

一、总览

　　system.WebServer 是 configuration 节的子级。有关更多信息，请参见 IIS 7.0: system.webServer Section Group (IIS Settings Schema)（IIS 7.0：system.webServer 节组（IIS 设置架构））。

　　下面是可以在 system.WebServer 配置组中进行的 Web 服务器设置的示例：

当请求未包含特定资源时，Web 服务器返回给客户端的默认文档（defaultDocument 元素）。
响应的压缩设置（httpCompression 元素）。
自定义标头（httpProtocol 节的 customHeaders 元素）。
模块（modules 元素）。
处理程序（handlers 元素）。

　　system.webServer 节中的某些设置只适用于 IIS 7.0 集成模式，而不适用于经典模式。

　　具体而言，如果应用程序正在经典模式下运行，则会忽略 Web.config 文件的 system.WebServer节中指定的所有托管代码模块和处理程序。

　　与 IIS 的早期版本相同，托管代码模块和处理程序必须在 system.web 节的 httpModules 和 httpHandlers 元素中定义。

　　本主题阐释需要修改 system.webServer 节的三个常见配置任务：

添加默认文件，以便在请求 URL 未包含特定的文件时，提供该默认文件。
注册托管代码模块。
添加自定义响应标头。

　　如果 Web.config 文件尚未包含 system.webServer 节，请在 configuration 元素中创建该节，如下面的示例所示：

二、配置默认文件

当请求 URL 未包含 Web 应用程序的特定文件时，IIS 7.0 将提供一个默认文件。

在 system.webServer 元素内，创建一个 defaultDocument 元素；

在 defaultDocument 元素内，创建一个 files 元素；

在 files 元素内创建一个 add 元素，并在 value 属性内指定默认文件的路径和名称；

下面的示例演示了一个 system.webServer 节，该节配置为提供 Products.aspx 文件作为默认文件。

<configuration>

  <system.webServer>

    <defaultDocument>      <files>        <add value="Products.aspx" />      </files>    </defaultDocument>

  </system.webServer>

</configuration>

三、注册托管代码模块

　　每次请求时都会调用托管代码模块，通过该模块可对请求或响应进行自定义。

　　在 system.webServer 元素内，创建一个 modules 元素；在 modules 元素内创建一个 add 元素，并在 name 和 type 属性中指定自定义模块。实际的名称和类型取决于要添加的模块；

　　下面的示例演示如何添加名为CustomModule的自定义模块，该模块将实现为类型Samples.CustomModule。

<configuration>

  <system.webServer>

    <modules>      <add name="CustomModule" type="Samples.CustomModule" />    </modules>

  </system.webServer>

</configuration>

　　向模块注册中添加 precondition 属性，并将其值设置为managedHandler。

　　此前置条件会导致仅在请求 ASP.NET 应用程序资源（例如 .aspx 文件或托管处理程序）时才调用该模块。该资源中不包括静态文件（例如 .htm 文件）。

　　其 configuration 节将类似于以下示例。

<configuration>

  <system.webServer>

    <modules>

      <add name="CustomModule" type="Samples.CustomModule"  precondition="managedHandler" />

    </modules>

    <defaultDocument>

      <files>

        <add value="Products.aspx" />

      </files>

    </defaultDocument>

  </system.webServer>

</configuration>

　关于MVC

　　对于像MVC这种比较特殊的URL，例如www.store.com/books/GetById/2

　　因为没有文件后缀名，IIS通常会无法解析,返回403或者404错误。

　　ASP.NET v4.0增加了新的特性，当运行在IIS7以上版本，并且需要IIS的一个快速修复程序KB980368，配置web.config后，将会正常处理上面这种 extensionless URL。

　 <validation validateIntegratedModeConfiguration="false"/> 这个主要作用是设置不检测 <system.web>中的配置。

　　<modules runAllManagedModulesForAllRequests="true" /> 这里当设置为true的时候，所有的请求，包含静态文件的请求和没有文件扩展名的请求，都会经过自定义的HttpModule，其实就是为了伪静态。

　　IIS经典模式下的配置

　　服务器会继续通过 Aspnet_isapi.dll 路由托管代码请求，其处理请求的方式就像应用程序在 IIS 6.0 中运行一样，aspnet_isapi.dll（IIS的native handler扩展），通过映射到System.Web.DefaultHttpHandler进行处理。

  <system.webServer>

    <validation validateIntegratedModeConfiguration="false" />

    <modules runAllManagedModulesForAllRequests="true" />

    <handlers>

      <remove name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" />

      <remove name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" />

      <remove name="ExtensionlessUrlHandler-Integrated-4.0" />

      <add name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness32" responseBufferLimit="" />

      <add name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness64" responseBufferLimit="" />

      <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />

    </handlers>

  </system.webServer>

　　IIS集成模式下的配置

　服务器将使用 IIS 和 ASP.NET 的集成请求处理管道来处理请求，映射到System.Web.Handlers.TransferRequestHandle来处理

<modules runAllManagedModulesForAllRequests="true" />

    <handlers>

      <remove name="ExtensionlessUrlHandler-Integrated-4.0" />

      <remove name="OPTIONSVerbHandler" />

      <remove name="TRACEVerbHandler" />

      <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />

    </handlers>

　　经典模式（classic mode）和集成模式（Integrated mode）比较

　　在经典模式下，IIS会用ISAPI扩展（ISAPI extension aspnet_isapi.dll）和 ISAPI过滤器（ISAPI filter aspnet_filter.dll）来调用ASP.NET运行库来处理请求。

　　使用经典模式的话，服务器会用两种管道来处理请求一个负责源代码，另外一个负责托管代码。在这种模式下，应用程序不能充分使用IIS7.X提供的服务。

　　httpHandler 和 httpModule 在集成和经典模式下的区别

　　经典模式，在web.config的 <system.web> 的子节点<httpModules> 加入<add name="MyHttpModule" type="WebApplication.MyHttpModule, WebApplication"/>

　　集成模式，在web.config的 <system.webServer> <modules> 加入<add name="MyHttpModule" type="WebApplication.MyHttpModule, WebApplication"/>

四、配置自定义响应标头

　　利用自定义响应标头，可向浏览器发送应用程序特定的信息。例如，可以添加 Content-Language 标头来描述网页正文中使用的语言。若要执行此操作，请提供一个或多个语言和国家/地区值，例如 en-US（美国英语）或 en-GB（英国英语）。

　　在 system.webServer 元素内，创建一个 httpProtocol 元素。

　　在 httpProtocol 元素内，创建一个 customHeaders 元素。

　　在 customHeaders 元素内创建一个 add 标记，并在 name 和 value 属性中指定自定义标头。实际的名称和类型将取决于该标头在应用程序中的功能。

　　下面的示例演示如何添加名为CustomHeader且值为CustomHeader的自定义标头。

<configuration>

  <system.webServer>

    <httpProtocol>      <customHeaders>        <add name="CustomHeader" value="CustomHeader" />      <customHeaders>    </httpProtocol>

  </system.webServer>

</configuration>

五、配置静态内容

<staticContent>元素配置与Internet Information Services（IIS）7中的静态文件处理请求相关的多个设置。

<staticContent>元素包含以下三个属性，指定IIS 7是否应将文档页脚应用于静态文件：

　　enableDocFooter属性指定是否启用文档页脚。

　　defaultDocFooter属性包含：

　　　　如果isDocFooterFileName属性设置为false，则IIS 7将用于文档页脚的文本字符串

　　　　如果isDocFooterFileName属性设置为true，则文件的完整限定路径包含IIS 7将用于文档页脚的文本。

　　如上所述，isDocFooterFileName属性指定defaultDocFooter属性是否包含IIS 7将用于文档页脚的文本字符串或包含IIS 7将用于文档页脚的文本的文件的标准路径。

　　注意：默认情况下，isDocFooterFileName属性设置为false并全局锁定。要为文档页脚使用文件，您需要在全局级别将isDocFooterFileName属性设置为true，或者解锁该属性。

配置mineMap节点，增加mime类型

在app和音频视频横行的时代，增加mime类型成了iis必不可少的配置

配置mineMap节点，使得网站部署一步到位，不用每次为新服务器添加

    <staticContent>

      <remove fileExtension=".woff" />

      <remove fileExtension=".woff2" />

      <mimeMap fileExtension=".woff" mimeType="application/font-woff" />

      <mimeMap fileExtension=".woff2" mimeType="application/font-woff" />

    </staticContent>

再贴一段常用代码

<staticContent>

  <remove fileExtension=".mp4" />

  <remove fileExtension=".m4a" />

  <remove fileExtension=".m4v" />

  <remove fileExtension=".ogv" />

  <remove fileExtension=".webm" />

  <mimeMap fileExtension=".mp4" mimeType="video/mp4" />

  <mimeMap fileExtension=".m4a" mimeType="video/mp4"/>

  <mimeMap fileExtension=".m4v" mimeType="video/m4v" />

  <mimeMap fileExtension=".ogv" mimeType="video/ogg"/>

  <mimeMap fileExtension=".webm" mimeType="video/webm"/>

</staticContent>

注意：添加之前必须先remove，否则如果原来已存在，会引起异常

参考文章：

https://technet.microsoft.com/zh-cn/sysinternals/bb763179.aspx

https://www.iis.net/configreference/system.webserver/staticcontent

http://www.cnblogs.com/imust2008/p/5651752.html

码农公寓

一、总览

二、配置默认文件

三、注册托管代码模块

关于MVC

经典模式（classic mode）和集成模式（Integrated mode）比较

四、配置自定义响应标头

五、配置静态内容

配置mineMap节点，增加mime类型

相关文章

　关于MVC

　　经典模式（classic mode）和集成模式（Integrated mode）比较