HTTP 压缩 <httpCompression>

概述

该 <httpCompression> 元素指定 Internet Information Services （IIS） 7 的 HTTP 压缩设置。 HTTP 压缩可以在可以接受压缩文件的 IIS 和客户端浏览器之间提供更快的传输时间。

IIS 7 使用的压缩类型有两种：

• 静态压缩：

  IIS 7 缓存 由目录 属性指定的路径中的压缩静态内容，这样就无需重新压缩已压缩的内容，从而提高压缩性能。 IIS 7 压缩文件后，会向后续请求提供缓存目录中文件的压缩副本。

  staticCompressionEnableCpuUsage 和 staticCompressionDisableCpuUsage 属性指定 IIS 7 何时会根据 CPU 使用率压缩静态文件。

  应对通常不更改的文件使用静态压缩，例如 HTML 文件（*.html、*.htm）、文本文件（*.txt）、Microsoft Office 文档（*.doc、*.xls、*.ppt），等等。可以通过压缩来减小这些文件的大小，从而减少客户端请求的下载时间，并减少服务器上的带宽。

  注释

  图像文件（如 *.jpg 和 *.png 文件）也是静态文件，但它们通常不会受益于 HTTP 压缩，因为这些图像文件已经压缩。

• 动态压缩：

  与静态压缩不同，每次客户端请求内容时，IIS 7 都会执行动态压缩，但压缩版本不会缓存到磁盘。 由于静态内容和动态内容之间存在主要差异，因此进行了此更改。 静态内容不会更改。 但是，动态内容通常是由应用程序创建的内容，因此经常更改，例如 Active Server Pages（ASP）或 ASP.NET 内容。 由于动态内容应经常更改，因此 IIS 7 不会缓存它。

  dynamicCompressionEnableCpuUsage 和 dynamicCompressionDisableCpuUsage 属性指定 IIS 7 何时会根据 CPU 使用率压缩动态文件。

IIS 7 支持两种不同的行业标准压缩方案：

• Deflate - 此形式的压缩记录在 请求注释 （RFC） 规范 1951 中。
• GZIP （GNU zip） - 此形式的压缩记录在 请求注释 （RFC） 规范 1952 中。

可以使用元素的<httpCompression>元素启用<schemes>这两种压缩方案中的每一个。

兼容性

安装

HTTP 压缩通常在 IIS 7 及更高版本的默认安装中可用。 但是，默认情况下仅安装静态压缩。 若要安装静态或动态压缩，请使用以下步骤。

Windows Server 2012 或 Windows Server 2012 R2

1. 在任务栏上，单击 “服务器管理器”。
2. 在 服务器管理器中，单击“ 管理 ”菜单，然后单击“ 添加角色和功能”。
3. 在 “添加角色和功能 ”向导中，单击“ 下一步”。 选择安装类型，然后单击“ 下一步”。 选择目标服务器，然后单击“ 下一步”。
4. 在 “服务器角色 ”页上，展开 “Web 服务器”（IIS），展开 “Web 服务器”，展开 “性能”，然后选择 “静态内容压缩 ”和/或 “动态内容压缩”。 单击 “下一步” 。
   .
5. 在 “选择功能 ”页上，单击“ 下一步”。
6. 在 “确认安装选择 ”页上，单击“ 安装”。
7. 在 “结果 ”页上，单击“ 关闭”。

Windows 8 或 Windows 8.1

1. 在 “开始” 屏幕上，将指针一直移动到左下角，右键单击 “开始 ”按钮，然后单击 “控制面板”。
2. 在 控制面板中，单击“ 程序和功能”，然后单击“ 打开或关闭 Windows 功能”。
3. 展开 Internet Information Services，展开 万维网服务，展开 性能功能，然后选择 “动态内容压缩 ”和/或 “静态内容压缩”。
   
4. 单击“确定”。
5. 单击 关闭。

Windows Server 2008 或 Windows Server 2008 R2

1. 在任务栏上，单击“ 开始”，指向 管理工具，然后单击 “服务器管理器”。
2. 在“服务器管理器层次结构”窗格中，展开“角色”，然后单击“Web 服务器”（IIS）。
3. 在 Web 服务器（IIS） 窗格中，滚动到 “角色服务 ”部分，然后单击“ 添加角色服务”。
4. 在“添加角色服务向导”的“选择角色服务”页上，如果要安装动态压缩和静态内容压缩，请选择“动态内容压缩”，然后单击“下一步”。
   
5. 在“ 确认安装选择 ”页上，单击“ 安装”。
6. 在 “结果 ”页上，单击“ 关闭”。

Windows Vista 或 Windows 7

1. 在任务栏上，单击“ 开始”，然后单击“ 控制面板”。
2. 在 控制面板中，单击“ 程序和功能”，然后单击“ 打开或关闭 Windows 功能”。
3. 展开 Internet 信息服务，然后展开 万维网服务，再展开 性能功能。
4. 如果要安装动态压缩，请选择 “Http 压缩动态 ”，如果要安装 静态压缩，请选择“静态内容压缩 ”。
   
5. 单击“确定”。

操作方式

如何启用或禁用站点或应用程序的静态和动态压缩

1. 打开 Internet Information Services （IIS） 管理器：

   • 如果使用 Windows Server 2012 或 Windows Server 2012 R2：

     • 在任务栏上，依次单击 “服务器管理器”、“ 工具”和“ Internet Information Services”（IIS）管理器。

   • 如果使用 Windows 8 或 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击 “控制面板”。
     • 单击 “管理工具”，然后双击 “Internet Information Services”（IIS）管理器。

   • 如果使用 Windows Server 2008 或 Windows Server 2008 R2：

     • 在任务栏上，单击“ 开始”，指向 管理工具，然后单击“ Internet Information Services”（IIS）管理器。

   • 如果使用 Windows Vista 或 Windows 7：

     • 在任务栏上，单击“ 开始”，然后单击“ 控制面板”。
     • 双击 管理工具，然后双击 Internet Information Services （IIS） 管理器。

2. 在 “连接 ”窗格中，转到要为其启用压缩的连接、站点、应用程序或目录。

3. 在 “开始 ”窗格中，双击“ 压缩”。
   

4. 在 “压缩 ”窗格中，选中启用静态或动态压缩的复选框，或删除复选标记以禁用静态或动态压缩。
   

5. 完成上述步骤后，单击“作”窗格中的“应用”。

如何启用或禁用服务器的静态和动态压缩

1. 打开 Internet Information Services （IIS） 管理器：

   • 如果使用 Windows Server 2012 或 Windows Server 2012 R2：

     • 在任务栏上，依次单击 “服务器管理器”、“ 工具”和“ Internet Information Services”（IIS）管理器。

   • 如果使用 Windows 8 或 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击 “控制面板”。
     • 单击 “管理工具”，然后双击 “Internet Information Services”（IIS）管理器。

   • 如果使用 Windows Server 2008 或 Windows Server 2008 R2：

     • 在任务栏上，单击“ 开始”，指向 管理工具，然后单击“ Internet Information Services”（IIS）管理器。

   • 如果使用 Windows Vista 或 Windows 7：

     • 在任务栏上，单击“ 开始”，然后单击“ 控制面板”。
     • 双击 管理工具，然后双击 Internet Information Services （IIS） 管理器。

2. 在“ 连接 ”窗格中，突出显示服务器的名称。

3. 在服务器的 “主页 ”窗格中，双击“ 压缩”。
   

4. 在 “压缩 ”窗格中，选中启用静态或动态压缩的复选框，或删除复选标记以禁用静态或动态压缩。
   

5. 完成上述步骤后，单击“作”窗格中的“应用”。

如何配置 staticCompressionIgnoreHitFrequency

1. 打开 Internet Information Services （IIS） 管理器：

   • 如果使用 Windows Server 2012 R2：

     • 在任务栏上，依次单击 “服务器管理器”、“ 工具”和“ Internet Information Services”（IIS）管理器。

   • 如果使用 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击 “控制面板”。
     • 单击 “管理工具”，然后双击 “Internet Information Services”（IIS）管理器。

2. 在“ 连接 ”窗格中，选择服务器，然后双击 “配置编辑器”。

3. 在 配置编辑器中，选择 system.webServer，然后选择 httpCompression。

4. 对于 staticCompressionIgnoreHitFrequency，请输入 True 以禁用仅当静态文件在一段时间内达到特定次数或输入 False 以启用该行为时才会压缩该行为。
   

5. In the Actions pane, click Apply.

配置

特性

只能在服务器级别配置这些属性。 将忽略站点级别或更低级别的配置。

子元素

配置示例

在 IIS 7 的 ApplicationHost.config 文件中配置了以下默认 <httpCompression> 元素。 除非使用 <clear> 元素，否则此配置部分将继承默认配置设置。

<httpCompression
      directory="%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files">
   <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll" />
   <dynamicTypes>
      <add mimeType="text/*" enabled="true" />
      <add mimeType="message/*" enabled="true" />
      <add mimeType="application/javascript" enabled="true" />
      <add mimeType="*/*" enabled="false" />
   </dynamicTypes>
   <staticTypes>
      <add mimeType="text/*" enabled="true" />
      <add mimeType="message/*" enabled="true" />
      <add mimeType="application/javascript" enabled="true" />
      <add mimeType="*/*" enabled="false" />
   </staticTypes>
</httpCompression>

示例代码

以下代码示例会将 Office 2003 文档的 MIME 类型添加到动态压缩类型列表中。

AppCmd.exe

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/msword',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/vnd.ms-powerpoint',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"dynamicTypes.[mimeType='application/vnd.ms-excel',enabled='True']" /commit:apphost

C#（编程语言）

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpCompressionSection = config.GetSection("system.webServer/httpCompression");
         ConfigurationElementCollection dynamicTypesCollection = httpCompressionSection.GetCollection("dynamicTypes");

         ConfigurationElement addElement = dynamicTypesCollection.CreateElement("add");
         addElement["mimeType"] = @"application/msword";
         addElement["enabled"] = true;
         dynamicTypesCollection.Add(addElement);

         ConfigurationElement addElement1 = dynamicTypesCollection.CreateElement("add");
         addElement1["mimeType"] = @"application/vnd.ms-powerpoint";
         addElement1["enabled"] = true;
         dynamicTypesCollection.Add(addElement1);

         ConfigurationElement addElement2 = dynamicTypesCollection.CreateElement("add");
         addElement2["mimeType"] = @"application/vnd.ms-excel";
         addElement2["enabled"] = true;
         dynamicTypesCollection.Add(addElement2);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpCompressionSection As ConfigurationSection = config.GetSection("system.webServer/httpCompression")
      Dim dynamicTypesCollection As ConfigurationElementCollection = httpCompressionSection.GetCollection("dynamicTypes")

      Dim addElement As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement("mimeType") = "application/msword"
      addElement("enabled") = True
      dynamicTypesCollection.Add(addElement)

      Dim addElement1 As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement1("mimeType") = "application/vnd.ms-powerpoint"
      addElement1("enabled") = True
      dynamicTypesCollection.Add(addElement1)

      Dim addElement2 As ConfigurationElement = dynamicTypesCollection.CreateElement("add")
      addElement2("mimeType") = "application/vnd.ms-excel"
      addElement2("enabled") = True
      dynamicTypesCollection.Add(addElement2)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST");
var dynamicTypesCollection = httpCompressionSection.ChildElements.Item("dynamicTypes").Collection;

var addElement = dynamicTypesCollection.CreateNewElement("add");
addElement.Properties.Item("mimeType").Value = "application/msword";
addElement.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement);

var addElement1 = dynamicTypesCollection.CreateNewElement("add");
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint";
addElement1.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement1);

var addElement2 = dynamicTypesCollection.CreateNewElement("add");
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel";
addElement2.Properties.Item("enabled").Value = true;
dynamicTypesCollection.AddElement(addElement2);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST")
Set dynamicTypesCollection = httpCompressionSection.ChildElements.Item("dynamicTypes").Collection

Set addElement = dynamicTypesCollection.CreateNewElement("add")
addElement.Properties.Item("mimeType").Value = "application/msword"
addElement.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement)

Set addElement1 = dynamicTypesCollection.CreateNewElement("add")
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint"
addElement1.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement1)

Set addElement2 = dynamicTypesCollection.CreateNewElement("add")
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel"
addElement2.Properties.Item("enabled").Value = True
dynamicTypesCollection.AddElement(addElement2)

adminManager.CommitChanges()

以下代码示例将 Office 2003 文档的 MIME 类型添加到静态压缩类型列表中。

（[> ！注意]

Office 2007 文档使用内置压缩，因此无需由 IIS 压缩。

AppCmd.exe

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/msword',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/vnd.ms-powerpoint',enabled='True']" /commit:apphost

appcmd.exe set config -section:system.webServer/httpCompression /+"staticTypes.[mimeType='application/vnd.ms-excel',enabled='True']" /commit:apphost

C#（编程语言）

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpCompressionSection = config.GetSection("system.webServer/httpCompression");
         ConfigurationElementCollection staticTypesCollection = httpCompressionSection.GetCollection("staticTypes");

         ConfigurationElement addElement = staticTypesCollection.CreateElement("add");
         addElement["mimeType"] = @"application/msword";
         addElement["enabled"] = true;
         staticTypesCollection.Add(addElement);

         ConfigurationElement addElement1 = staticTypesCollection.CreateElement("add");
         addElement1["mimeType"] = @"application/vnd.ms-powerpoint";
         addElement1["enabled"] = true;
         staticTypesCollection.Add(addElement1);

         ConfigurationElement addElement2 = staticTypesCollection.CreateElement("add");
         addElement2["mimeType"] = @"application/vnd.ms-excel";
         addElement2["enabled"] = true;
         staticTypesCollection.Add(addElement2);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpCompressionSection As ConfigurationSection = config.GetSection("system.webServer/httpCompression")
      Dim staticTypesCollection As ConfigurationElementCollection = httpCompressionSection.GetCollection("staticTypes")

      Dim addElement As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement("mimeType") = "application/msword"
      addElement("enabled") = True
      staticTypesCollection.Add(addElement)

      Dim addElement1 As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement1("mimeType") = "application/vnd.ms-powerpoint"
      addElement1("enabled") = True
      staticTypesCollection.Add(addElement1)

      Dim addElement2 As ConfigurationElement = staticTypesCollection.CreateElement("add")
      addElement2("mimeType") = "application/vnd.ms-excel"
      addElement2("enabled") = True
      staticTypesCollection.Add(addElement2)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST");
var staticTypesCollection = httpCompressionSection.ChildElements.Item("staticTypes").Collection;

var addElement = staticTypesCollection.CreateNewElement("add");
addElement.Properties.Item("mimeType").Value = "application/msword";
addElement.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement);

var addElement1 = staticTypesCollection.CreateNewElement("add");
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint";
addElement1.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement1);

var addElement2 = staticTypesCollection.CreateNewElement("add");
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel";
addElement2.Properties.Item("enabled").Value = true;
staticTypesCollection.AddElement(addElement2);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpCompressionSection = adminManager.GetAdminSection("system.webServer/httpCompression", "MACHINE/WEBROOT/APPHOST")
Set staticTypesCollection = httpCompressionSection.ChildElements.Item("staticTypes").Collection

Set addElement = staticTypesCollection.CreateNewElement("add")
addElement.Properties.Item("mimeType").Value = "application/msword"
addElement.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement)

Set addElement1 = staticTypesCollection.CreateNewElement("add")
addElement1.Properties.Item("mimeType").Value = "application/vnd.ms-powerpoint"
addElement1.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement1)

Set addElement2 = staticTypesCollection.CreateNewElement("add")
addElement2.Properties.Item("mimeType").Value = "application/vnd.ms-excel"
addElement2.Properties.Item("enabled").Value = True
staticTypesCollection.AddElement(addElement2)

adminManager.CommitChanges()