Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 33 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
## Express rate-limiter
Rate limiting middleware for Express applications built on redis
Rate limiting middleware for Express applications built on redis/mongodb

``` sh
npm install express-limiter --save
```

### Using redis
``` js
var express = require('express')
var app = express()
Expand Down Expand Up @@ -33,6 +34,37 @@ app.get('/api/action', function (req, res) {
})
```

### Using mongodb
``` js
var express = require('express')
var app = express()
var mongojs = require('mongojs')
var db = mongojs('localhost/test')
var mycollection = db.collection('mycollection')

var limiter = require('express-limiter')(app, mycollection, 'mongodb')

/**
* you may also pass it an Express 4.0 `Router`
*
* router = express.Router()
* limiter = require('express-limiter')(router, client)
*/

limiter({
path: '/api/action',
method: 'get',
lookup: ['connection.remoteAddress'],
// 150 requests per hour
total: 150,
expire: 1000 * 60 * 60
})

app.get('/api/action', function (req, res) {
res.send(200, 'ok')
})
```

### API options

``` js
Expand Down
Binary file added dump.rdb
Binary file not shown.
95 changes: 67 additions & 28 deletions index.js
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
module.exports = function (app, db) {
module.exports = function (app, db, clientType) {
if (clientType === 'mongodb') {
db.ensureIndex({ 'reset': 1 }, { 'expireAfterSeconds': 0 })
}
return function (opts) {
var middleware = function (req, res, next) {
if (opts.whitelist && opts.whitelist(req)) return next()
Expand All @@ -14,39 +17,75 @@ module.exports = function (app, db) {
var path = opts.path || req.path
var method = (opts.method || req.method).toLowerCase()
var key = 'ratelimit:' + path + ':' + method + ':' + lookups
db.get(key, function (err, limit) {
if (err && opts.ignoreErrors) return next()
var now = Date.now()
limit = limit ? JSON.parse(limit) : {
total: opts.total,
remaining: opts.total,
reset: now + opts.expire
}

if (now > limit.reset) {
limit.reset = now + opts.expire
limit.remaining = opts.total
}

// do not allow negative remaining
limit.remaining = Math.max(Number(limit.remaining) - 1, -1)
db.set(key, JSON.stringify(limit), 'PX', opts.expire, function (e) {
if (!opts.skipHeaders) {
res.set('X-RateLimit-Limit', limit.total)
res.set('X-RateLimit-Reset', Math.ceil(limit.reset / 1000)) // UTC epoch seconds
res.set('X-RateLimit-Remaining', Math.max(limit.remaining,0))
var clientToUse = clientType || 'redis';
if (clientToUse === 'redis') {
db.get(key, function (err, limit) {
if (err && opts.ignoreErrors) return next()
var now = Date.now()
limit = limit ? JSON.parse(limit) : {
total: opts.total,
remaining: opts.total,
reset: now + opts.expire
}

if (now > limit.reset) {
limit.reset = now + opts.expire
limit.remaining = opts.total
}

if (limit.remaining >= 0) return next()
// do not allow negative remaining
limit.remaining = Math.max(Number(limit.remaining) - 1, -1)
db.set(key, JSON.stringify(limit), 'PX', opts.expire, function (e) {
if (!opts.skipHeaders) {
res.set('X-RateLimit-Limit', limit.total)
res.set('X-RateLimit-Reset', Math.ceil(limit.reset / 1000)) // UTC epoch seconds
res.set('X-RateLimit-Remaining', Math.max(limit.remaining, 0))
}

if (limit.remaining >= 0) return next()

var after = (limit.reset - Date.now()) / 1000
var after = (limit.reset - Date.now()) / 1000

if (!opts.skipHeaders) res.set('Retry-After', after)
if (!opts.skipHeaders) res.set('Retry-After', after)

opts.onRateLimited(req, res, next)
})

opts.onRateLimited(req, res, next)
})
} else if (clientToUse === 'mongodb') {
db.findOne({ key: key }, function (err, limit) {
if (err && opts.ignoreErrors) return next()
var now = Date.now()
limit = limit ? limit : {
total: opts.total,
remaining: opts.total,
reset: new Date(now + opts.expire)
}

if (now > limit.reset) {
limit.reset = new Date(now + opts.expire)
limit.remaining = opts.total
}

// do not allow negative remaining
limit.remaining = Math.max(Number(limit.remaining) - 1, -1)
db.update({ key: key }, { $set: { total: limit.total, remaining: limit.remaining, reset: limit.reset } }, { upsert: true }, function(e) {
if (!opts.skipHeaders) {
res.set('X-RateLimit-Limit', limit.total)
res.set('X-RateLimit-Reset', Math.ceil(limit.reset / 1000)) // UTC epoch seconds
res.set('X-RateLimit-Remaining', Math.max(limit.remaining, 0))
}

if (limit.remaining >= 0) return next()

var after = (limit.reset - Date.now()) / 1000
if (!opts.skipHeaders) res.set('Retry-After', after)

})
opts.onRateLimited(req, res, next)
})

})
}
}
if (typeof(opts.lookup) === 'function') {
var callableLookup = opts.lookup;
Expand All @@ -59,4 +98,4 @@ module.exports = function (app, db) {
if (opts.method && opts.path) app[opts.method](opts.path, middleware)
return middleware
}
}
}
Loading