一般情况在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 元素中创建该节,如下面的示例所示:

  <configuration> <system.webServer> </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

Web.config设置system.webServer的更多相关文章

  1. Web.config的system.webServer节点与system.web的区别

    Web.config 文件中的 system.webServer 节用于指定适用于 Web 应用程序的 IIS 7.0 设置.system.WebServer 是 configuration 节的子级 ...

  2. IIS7.5使用web.config设置伪静态的二种方法

    转自 网上赚钱自学网 .http://www.whosmall.com/post/121 近几天公司里开发的项目有几个运行在IIS7.5上,由于全站采用的是伪静态,因此从网上找到两两种方法来实现.这两 ...

  3. win2008主机IIS7.x 关于web.config设置301重定向

    win2008主机IIS7.x 关于web.config设置301重定向 要求:windows主机是IIS7.0或以上的版本 方法如下: 在网站的根目录下新建web.config文件并将一下代码加入到 ...

  4. IIS中虚拟目录不继承主站点web.config设置的办法(转载)

    ASP.NET提供了强大的Web.config来配置网站,一般来说一个网站只有一个根目录下的Web.config文件,有时候我们希望子目录有着不同的权限或者参数设置,则可以在相应子目录增加一个Web. ...

  5. IIS中ASP.NET虚拟目录不继承主站点web.config设置的办法(转载)

    ASP.NET提供了强大的Web.config来配置网站,一般来说一个网站只有一个根目录下的Web.config文件,有时候我们希望子目录有着不同的权限或者参数设置,则可以在相应子目录增加一个Web. ...

  6. 转 web.config设置之system.webServer 详细介绍,为网站设置默认文档

    如何:为 IIS 7.0 配置 <system.webServer> 节2008-06-14 22:26http://technet.microsoft.com/zh-cn/sysinte ...

  7. web.config设置之system.webServer 详细介绍,为网站设置默认文档

    如何:为 IIS 7.0 配置 <system.webServer> 节2008-06-14 22:26http://technet.microsoft.com/zh-cn/sysinte ...

  8. IIS7.5使用web.config设置伪静态的二种方法(转)

    近几天公司里开发的项目有几个运行在IIS7.5上,由于全站采用的是伪静态,因此从网上找到两两种方法来实现.这两种方法各有优势:第一种比较灵活,只要把文件拷到根目录下,即可直接显示所有伪静态页面(适用于 ...

  9. asp.net web.config 设置Session过期时间

    在Asp.net中,可以有四处设置Session的过期时间:(原文作者:望月狼地址:http://www.cnblogs.com/wangyuelang0526/) 一.全局网站(即服务器)级 IIS ...

随机推荐

  1. jQuery获取相同元素下标

    如题:经常搞混淆,index()获取的是下标,而eq(下标值)获取的是元素对象 var list=$(".toos");//获取class为toos的元素集合$('.toos'). ...

  2. 全面理解JavaScript中的 this

    全面理解JavaScript中的 this 上下文 VS 作用域 作用域(scope) 是在运行时代码中的某些特定部分中变量,函数和对象的可访问性.换句话 说,作用域决定了代码区块中变量和其他资源的可 ...

  3. Spark Submitting Applications浅析

    Submitting Applications提交应用程序 在spark的bin目录下spark-submit脚本被用于在集群中启动应用程序.它可以通过一个统一的接口来使用Spark支持的所有集群管理 ...

  4. Redis基本概念、基本使用与单机集群部署

    1. Redis基础 1.1 Redis概述 Redis是一个开源.先进的key-value存储,并用于构建高性能.可扩展的应用程序的完美解决方案. Redis从它的许多竞争继承了三个主要特点:    ...

  5. 分布式配置 SSH 免密登陆

    原地址忘记了,暂且记下 一.准备工作 1) 用客户端工具(ssh client或者putty)连接到linux服务器.在root用户下输入命令 vi /etc/hosts,用vi编辑hosts文件,如 ...

  6. 使用JSX的注意事项

    react中JSX是一种JavaScript + xml语法,用来创建虚拟DOM和声明组件.他可以更好的让我们读.写模板或组件. JSX语法浏览器是不识别的,需要通过babel 来进行转换成浏览器识别 ...

  7. Android允许在UI线程中使用网络访问

    StrictMode.ThreadPolicy policy=new StrictMode.ThreadPolicy.Builder().permitAll().build(); StrictMode ...

  8. GreenDao 直接执行SQL的方法

    try { DaoSession session=MyApplication.getInstances().getDaoSession(); long fromId=-1; String strSql ...

  9. jupyter notebook出现cannot import name 'create_prompt_application'问题(Died Kernel)

    应该是在安装其它python第三方库时更新了prompt-toolkit版本,降级到下面的版本即可: sudo pip install 'prompt-toolkit==1.0.15'

  10. IDEA对新建java线程池的建议

    1 代码片段 ExecutorService pool = Executors.newCachedThreadPool(); 2 建议的三种模板 A 第一种,采用Apache的common.lang3 ...