rate-limit-memcached
v1.0.1
Published
A memcached store for the express-rate-limit middleware.
Downloads
16,544
Readme
rate-limit-memcached
A memcached
store for the
express-rate-limit
middleware.
Installation
From the npm registry:
# Using npm
> npm install express-rate-limit
# Using yarn or pnpm
> yarn/pnpm add express-rate-limit
From Github Releases:
# Using npm
> npm install https://github.com/express-rate-limit/rate-limit-memcached/releases/download/v{version}/rate-limit-memcached.tgz
# Using yarn or pnpm
> yarn/pnpm add https://github.com/express-rate-limit/rate-limit-memcached/releases/download/v{version}/rate-limit-memcached.tgz
Replace {version}
with the version of the package that you want to your, e.g.:
1.0.0
.
Usage
This package requires you to use Node 16 or above.
An example of its usage is as follows:
import { rateLimit } from 'express-rate-limit'
import { MemcachedStore } from 'rate-limit-memcached'
const limiter = rateLimit({
windowMs: 15 * 60 * 1000, // 15 minutes.
max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes).
standardHeaders: 'draft-7', // Return rate limit info in the `RateLimit` header.
legacyHeaders: false, // Disable the `X-RateLimit-*` headers.
store: new MemcachedStore({
// prefix: 'rl:', // The prefix attached to all keys stored in the cache.
locations: ['localhost:11211'], // The server location(s), passed directly to Memcached.
}),
})
// Apply the rate limiting middleware to all requests
app.use(limiter)
Configuration
prefix
string
The text to prepend to all keys stored by this package in Memcached.
Defaults to rl:
.
client
MemcachedClient
The client used to make requests to the Memcached server. Must have the following methods:
get: (key, callback)
del: (key, callback)
set: (key, value, lifetime, callback)
add: (key, value, lifetime, callback)
incr: (key, delta, callback)
decr: (key, delta, callback)
Here,
key
is a string,value
anddelta
are numbers, andlifetime
is the time in seconds until it expires.
Defaults to an instance of memcached
,
created with the locations
and config
options (see below for details) passed
to it.
locations
A list of memcached servers to store the keys in, passed to the default Memcached client.
Note that the default client is only used if an alternative client
is not
passed to the store.
Defaults to ['localhost:11211']
.
config
object
The configuration passed to the default Memcached client.
Defaults to {}
.
Issues and Contributing
If you encounter a bug or want to see something added/changed, please go ahead and open an issue! If you need help with something, feel free to start a discussion!
If you wish to contribute to the library, thanks! First, please read the contributing guide. Then you can pick up any issue and fix/implement it!
License
MIT © Tomohisa Oda, Nathan Friedly and Vedant K