Web.config设置system.webServer

简介:   一般情况在iis部署web网站都非常顺利,但是遇到复杂环境,或者被配置过又正在使用的时候,就束手无策了,   因为对IIS和Web.config不熟悉,不知其中要害,导致浪费一天甚至更久的时间去处理一个可能是不起眼的配置问题   本文主要和大家共同探讨下Web.config的system.webServer节点配置,如有错误之处,劳烦指点下   环境:IIS 7.0及以上 一、总览   system.WebServer 是 configuration 节的子级。

  一般情况在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="0" />
      <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="0" />
      <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

 

 

 

 

 

相关文章
|
7月前
|
前端开发
web前端开发-----CSS样式设置
web前端开发-----CSS样式设置
72 0
|
2月前
|
编解码 前端开发 JavaScript
使用 CSS 打印样式为 Web 页面设置专业的打印机效果
使用 CSS 打印样式为 Web 页面设置专业的打印机效果
66 2
|
4月前
【Azure 应用服务】Web.config中设置域名访问限制,IP地址限制访问特定的页面资源 (Rewrite)
【Azure 应用服务】Web.config中设置域名访问限制,IP地址限制访问特定的页面资源 (Rewrite)
|
4月前
|
开发框架 JavaScript .NET
Vue与ASP.NET Core Web Api设置localhost与本地ip地址皆可访问
Vue与ASP.NET Core Web Api设置localhost与本地ip地址皆可访问
50 0
文本vitepress,如何设置背景图,如何插入背景图,如何插入logo,为了放背景图片,我们要新建pubilc的文件夹,插入logo要在config.js中进行配置,注意细节,在添加背景时,注意格式
文本vitepress,如何设置背景图,如何插入背景图,如何插入logo,为了放背景图片,我们要新建pubilc的文件夹,插入logo要在config.js中进行配置,注意细节,在添加背景时,注意格式
|
7月前
|
存储 Ubuntu 关系型数据库
Ubuntu端Sidecar安装及Web界面设置
本文主要是对Sidecars的配置,以下方法经过本人的亲自测试,亲测有效,放心大胆使用。
197 0
Ubuntu端Sidecar安装及Web界面设置
|
7月前
|
JSON 开发框架 .NET
ASP.NET Core Web API设置响应输出的Json数据格式的两种方式
ASP.NET Core Web API设置响应输出的Json数据格式的两种方式
180 0
|
SQL 缓存 开发框架
THINKPHP5中的config设置实例
THINKPHP5中的config设置实例
191 0
|
Java 测试技术 Spring
spring web设置profile
spring web设置profile
|
关系型数据库 MySQL 数据安全/隐私保护
mysql_config_editor 设置密码set --login_path
mysql_config_editor可以给指定的连接和密码生成一个加密文件.mylogin.cnf
162 0