配置举例

这是一个针对心急者的示范配置：

以下允许压缩更多内容的配置更加复杂。除非你明白所有的配置细节，否则请不要使用。

过滤器实现的。下面的指令会对其所在容器中的文档启用压缩：

SetOutputFilter DEFLATE

一些流行的浏览器不能正确处理所有压缩内容，因此你可能需要将gzip-only-text/html标记设为"1"来仅仅允许压缩html文件(见下面)。如果你设置了"1"以外的任何值，都将被忽略。

如果你想将压缩限制在几种特定的MIME类型上，可以使用AddOutputFilterByType指令。下面的例子仅仅允许对html文档进行压缩：

<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
</Directory>

对于那些不能正确处理所有压缩内容的浏览器，可以使用BrowserMatch指令针对特定的浏览器设置no-gzip标记以取消压缩。为了取得更好的效果，你可以将no-gzip和gzip-only-text/html配合使用。在这种情况下，下面的设置将会覆盖上面的设置。看看从配置示例中摘录的片断：

BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html

第一条指令表示如果User-Agent字符串表示它是一个Navigator 4.x的浏览器，这种浏览器不能正确处理除text/html之外的所有类型。而4.06, 4.07, 4.08版的Navigator完全不能处理任何压缩内容，因此第二条指令对这些浏览器完全禁用压缩。

第三个BrowserMatch指令修正了上面两条对浏览器的推测，因为微软的IE也将它自己标识成"Mozilla/4"但是它实际上能够处理所有的压缩内容。因此又在User-Agent头中额外匹配了字符串"MSIE"("\b"表示"单词边界")，并且取消了前面的限制。

注意

DEFLATE过滤器总是在类似于PHP或SSI之类的资源过滤器之后插入，它永远不会触及到内部请求。

注意

通过SetEnv设置force-gzip环境变量将会忽略浏览器的"accept-encoding"，始终发送经过压缩的内容。

输出解压

mod_deflate模块还提供了一个解压gzip格式的应答体的功能。为了激活这个特性你必须使用SetOutputFilter或AddOutputFilter指令将INFLATE过滤器插入到输入过滤器链：

这个例子将会解压来自example.com的输出，这样其它过滤器就可以做进一步的处理了。

输入解压

mod_deflate模块还提供了一个解压gzip格式的请求体的功能。为了激活这个特性你必须使用SetInputFilter或AddInputFilter指令将DEFLATE过滤器插入到输入过滤器链。例如：

这样，如果包含"Content-Encoding: gzip"头的请求体将会被自动解压。极少有浏览器压缩请求体。然而有些程序的确这么做了，比如一些WebDAV客户端程序。

代理服务器

mod_deflate模块发送一个"Vary: Accept-Encoding"HTTP应答头以提醒代理服务器：只对发送了正确"Accept-Encoding"头的客户端发送缓存的应答。这样可以防止不能正确处理压缩内容的浏览器接受到经过压缩的内容。

如果你按照某些特殊的条件拒绝了某些客户端的访问(比如User-Agent头)，你必须手动配置一个额外的Vary头提醒代理服务器做额外的限制。比如，在一个典型的配置中的某处，如果额外的DEFLATE过滤器是否生效取决于User-Agent头，你应当在此处添加：

如果依照除请求头以外的其他条件决定是否使用压缩(例如：HTTP版本)，你必须设置Vary头的值为"*"来完全阻止代理服务器的缓存。