A redis store for the
express-rate-limit
middleware. Also supports redict &
valkey.
From the npm registry:
# Using npm
> npm install rate-limit-redis
# Using yarn or pnpm
> yarn/pnpm add rate-limit-redisFrom Github Releases:
# Using npm
> npm install https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgz
# Using yarn or pnpm
> yarn/pnpm add https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgzReplace {version} with the version of the package that you want to use, e.g.:
3.0.0.
This library is provided in ESM as well as CJS forms, and works with both Javascript and Typescript projects.
This package requires you to use Node 16 or above.
Import it in a CommonJS project (type: commonjs or no type field in
package.json) as follows:
const { RedisStore } = require('rate-limit-redis')Import it in a ESM project (type: module in package.json) as follows:
import { RedisStore } from 'rate-limit-redis'To use it with a node-redis client:
import { rateLimit } from 'express-rate-limit'
import { RedisStore } from 'rate-limit-redis'
import { createClient } from 'redis'
// Create a `node-redis` client
const client = createClient({
// ... (see https://github.com/redis/node-redis/blob/master/docs/client-configuration.md)
})
// Then connect to the Redis server
await client.connect()
// Create and use the rate limiter
const limiter = rateLimit({
// Rate limiter configuration
windowMs: 15 * 60 * 1000, // 15 minutes
max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
legacyHeaders: false, // Disable the `X-RateLimit-*` headers
// Redis store configuration
store: new RedisStore({
sendCommand: (...args: string[]) => client.sendCommand(args),
}),
})
app.use(limiter)To use it with a ioredis client:
import { rateLimit } from 'express-rate-limit'
import { RedisStore } from 'rate-limit-redis'
import RedisClient from 'ioredis'
// Create a `ioredis` client
const client = new RedisClient()
// ... (see https://github.com/luin/ioredis#connect-to-redis)
// Create and use the rate limiter
const limiter = rateLimit({
// Rate limiter configuration
windowMs: 15 * 60 * 1000, // 15 minutes
max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
legacyHeaders: false, // Disable the `X-RateLimit-*` headers
// Redis store configuration
store: new RedisStore({
sendCommand: (command: string, ...args: string[]) =>
client.send_command(command, ...args),
}),
})
app.use(limiter)The function used to send commands to Redis. The function signature is as follows:
;(...args: string[]) => Promise<number> | numberThe raw command sending function varies from library to library; some are given below:
| Library | Function |
|---|---|
node-redis |
async (...args: string[]) => client.sendCommand(args) |
ioredis |
async (command: string, ...args: string[]) => client.send_command(command, ...args) |
handy-redis |
async (...args: string[]) => client.nodeRedis.sendCommand(args) |
tedis |
async (...args: string[]) => client.command(...args) |
redis-fast-driver |
async (...args: string[]) => client.rawCallAsync(args) |
yoredis |
async (...args: string[]) => (await client.callMany([args]))[0] |
noderis |
async (...args: string[]) => client.callRedis(...args) |
The text to prepend to the key in Redict/Redis.
Defaults to rl:.
Whether to reset the expiry for a particular key whenever its hit count changes.
Defaults to false.
MIT © Wyatt Johnson, Nathan Friedly, Vedant K
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent