压缩

压缩可以大幅减小响应体的大小,从而提高 Web 应用的速度。

对于生产环境中的高流量网站,强烈建议将压缩从应用服务器卸载——通常是在反向代理(例如 Nginx)中。在这种情况下,你不应使用压缩中间件。

与 Express 一起使用(默认)

使用 compression 中间件包来启用 gzip 压缩。

首先,安装所需的包:

$ npm i --save compression
$ npm i --save-dev @types/compression

安装完成后,将压缩中间件作为全局中间件应用。

import compression from 'compression';
// somewhere in your initialization file
app.use(compression());

与 Fastify 一起使用

如果使用 FastifyAdapter,你将需要使用 fastify-compress:

$ npm i --save @fastify/compress

安装完成后,将 @fastify/compress 中间件作为全局中间件应用。

warning 警告 请确保在创建应用程序时使用类型 NestFastifyApplication。否则,你将无法使用 register 来应用压缩中间件。

import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';

import compression from '@fastify/compress';

// inside bootstrap()
const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
await app.register(compression);

默认情况下,当浏览器指示支持该编码时,@fastify/compress 将使用 Brotli 压缩(在 Node >= 11.7.0 上)。虽然 Brotli 在压缩率方面非常高效,但它也可能相当慢。默认情况下,Brotli 将最大压缩质量设置为 11,但可以通过调整 BROTLI_PARAM_QUALITY 在最小 0 到最大 11 之间来减少压缩时间以换取压缩质量。这需要进行微调以优化空间/时间性能。一个质量设置为 4 的示例:

import { constants } from 'node:zlib';
// somewhere in your initialization file
await app.register(compression, { brotliOptions: { params: { [constants.BROTLI_PARAM_QUALITY]: 4 } } });

为了简化,你可能希望告诉 fastify-compress 仅使用 deflate 和 gzip 来压缩响应;你最终可能会得到更大的响应,但它们会更快地交付。

要指定编码,请向 app.register 提供第二个参数:

await app.register(compression, { encodings: ['gzip', 'deflate'] });

上述内容告诉 fastify-compress 仅使用 gzip 和 deflate 编码,如果客户端同时支持两者,则优先使用 gzip。