Express Slow Down 使用教程

1. 项目介绍

express-slow-down 是一个基于 Node.js 的 Express 中间件，用于对重复请求进行减速处理，而不是直接阻止它们。这种机制可以用来对公共 API 或密码重置等端点进行滥用预防。它是建立在 express-rate-limit 项目之上的，可以与其配合使用，也可以单独使用。

2. 项目快速启动

首先，确保你已经安装了 Node.js 环境。

安装

通过 npm 安装 express-slow-down：

npm install express-slow-down

或者，如果你使用 yarn 或 pnpm，可以使用以下命令：

yarn add express-slow-down
# 或者
pnpm add express-slow-down

使用

在你的 Express 应用中引入并使用这个中间件：

const express = require('express');
const { slowDown } = require('express-slow-down');

const app = express();

// 创建一个减速器实例
const limiter = slowDown({
  windowMs: 15 * 60 * 1000, // 15分钟
  delayAfter: 5, // 允许5次请求后开始减速
  delayMs: (hits) => hits * 100 // 每次请求后增加100ms的延迟
});

// 应用减速中间件到所有请求
app.use(limiter);

app.get('/', (req, res) => {
  res.send('Hello, World!');
});

// 启动服务器
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

3. 应用案例和最佳实践

减速 API 请求

如果你的应用是一个仅限 API 的服务器，你可能希望对所有请求应用速度限制：

const apiLimiter = slowDown({
  windowMs: 15 * 60 * 1000, // 15分钟
  delayAfter: 1, // 只允许一次全速请求
  delayMs: (hits) => hits * hits * 1000 // 第二次请求延迟4秒，第三次9秒，以此类推
});

// 仅对 API 请求应用减速
app.use('/api', apiLimiter);

使用自定义存储

如果你需要使用自定义存储，比如 Memcached，你可以这样配置：

const { slowDown } = require('express-slow-down');
const { MemcachedStore } = require('rate-limit-memcached');

const speedLimiter = slowDown({
  windowMs: 15 * 60 * 1000, // 15分钟
  delayAfter: 1, // 只允许一次全速请求
  delayMs: (hits) => hits * hits * 1000, // 请求后增加指数延迟
  store: new MemcachedStore({
    /* ... 配置选项 ... */
  })
});

// 应用速度限制中间件到所有请求
app.use(speedLimiter);

4. 典型生态项目

在 express-slow-down 的生态中，有一些项目可以与之配合使用，以提供更丰富的功能：

• express-rate-limit: 提供请求速率限制的功能。
• rate-limit-memcached: 一个使用 Memcached 作为存储的速率限制库。
• rate-limit-redis: 使用 Redis 作为存储的速率限制库。

以上是 express-slow-down 的基本使用和最佳实践。通过这些指南，你可以有效地在你的 Express 应用中管理请求的速率，以防止滥用和保护你的服务。