Rate limiting в Next.js middleware без Redis: робочий код та чесні обмеження
Де живе пам'ять middleware
Перед тим, як писати код, важливо зрозуміти, на чому він виконується. Обмежувач частоти запитів зберігає лічильники, і питання у тому, де їх зберігати, якщо Redis немає.
- Self-hosted, один процес `next start`. Middleware виконується у тому самому процесі Node.js. Модульна змінна живе, поки живий процес, і видно всім запитам. Лічильник
Mapпрацює коректно. - Кілька процесів або контейнерів за балансувальником. У кожного своя
Map. Реальний ліміт множиться на кількість процесів. - Vercel та інші serverless/edge-платформи. Запити розподіляються між багатьма ізолятами в різних регіонах, ізоляти створюються та знищуються за навантаженням. Лічильник у пам'яті бачить лише частину запитів, а після холодного старту починається з нуля.
Тому in-memory rate limit на serverless — не захист від цілеспрямованої атаки, а фільтр від грубих сплесків, які потрапляють в один ізольят: клієнт, що зациклився, простий скрипт з однієї адреси.
Реалізація: ковзне вікно в пам'яті
// lib/rate-limit.ts
type Entry = { hits: number[] };
const store = new Map<string, Entry>();
let lastSweep = Date.now();
export function rateLimit(key: string, limit: number, windowMs: number) {
const now = Date.now();
if (now - lastSweep > 60_000) { // периодическая очистка, чтобы Map не росла бесконечно
for (const [k, e] of store) {
if (e.hits.length === 0 || now - e.hits[e.hits.length - 1] > windowMs) store.delete(k);
}
lastSweep = now;
}
const entry = store.get(key) ?? { hits: [] };
entry.hits = entry.hits.filter((t) => now - t < windowMs);
if (entry.hits.length >= limit) {
store.set(key, entry);
const retryAfter = Math.ceil((windowMs - (now - entry.hits[0])) / 1000);
return { ok: false as const, retryAfter };
}
entry.hits.push(now);
store.set(key, entry);
return { ok: true as const, remaining: limit - entry.hits.length };
}Зберігання міток часу точніше фіксованого вікна (немає подвійного сплеску на межі хвилин), але витрачає пам'ять пропорційно до ліміту. Для лімітів близько десятків запитів за хвилину це несуттєво.
Middleware
// middleware.ts
import { NextResponse, type NextRequest } from "next/server";
import { rateLimit } from "@/lib/rate-limit";
const RULES: { prefix: string; limit: number; windowMs: number }[] = [
{ prefix: "/api/auth/login", limit: 10, windowMs: 60_000 },
{ prefix: "/api/contact", limit: 5, windowMs: 60_000 },
{ prefix: "/api/", limit: 120, windowMs: 60_000 },
];
function clientIp(req: NextRequest): string {
const xff = req.headers.get("x-forwarded-for");
return xff?.split(",")[0]?.trim() || req.headers.get("x-real-ip") || "unknown";
}
export function middleware(req: NextRequest) {
const rule = RULES.find((r) => req.nextUrl.pathname.startsWith(r.prefix));
if (!rule) return NextResponse.next();
const res = rateLimit(`${rule.prefix}:${clientIp(req)}`, rule.limit, rule.windowMs);
if (!res.ok) {
return NextResponse.json(
{ error: "too many requests" },
{ status: 429, headers: { "Retry-After": String(res.retryAfter) } }
);
}
return NextResponse.next();
}
export const config = { matcher: ["/api/:path*"] };У Next.js 15 у NextRequest більше немає властивості ip, тому адреса береться із заголовків. Довіряти x-forwarded-for можна тільки якщо перед додатком стоїть ваш проксі або платформа, яка перезаписує цей заголовок. На голому next start без проксі клієнт підставить туди будь-що і обійде ліміт. На Vercel для отримання адреси є хелпер ipAddress з пакета @vercel/functions.
Чим закривати те, що middleware не закриває
Брутфорс пароля. Атакуючий міняє IP через пул проксі, і ліміт за адресою марний. Захист - лічильник невдалих спроб на рівні облікового запису в основній базі:
ALTER TABLE users ADD COLUMN failed_logins int NOT NULL DEFAULT 0; ALTER TABLE users ADD COLUMN locked_until timestamptz;
// при неудачном входе
await db.query(
`UPDATE users SET failed_logins = failed_logins + 1,
locked_until = CASE WHEN failed_logins + 1 >= 5 THEN now() + interval '15 minutes' END
WHERE email = $1`, [email]);
// при успешном — сбросить failed_logins и locked_untilЦе працює на будь-якій кількості інстансів, тому що стан у базі, яка у вас вже є. Не розкривайте у відповіді, чи існує обліковий запис: повідомлення про помилку має бути однаковим.
Спам форм. Капча або перевірочний токен (Cloudflare Turnstile, hCaptcha) ефективніший за ліміт по IP, плюс приховане поле-пастка для простих ботів.
Об'ємні атаки. Це завдання рівня перед додатком: правила rate limiting у Vercel Firewall, Cloudflare WAF або nginx limit_req на self-hosted. Вони вважають запити до того, як ті дістануться вашого коду.
Як перевірити
for i in $(seq 1 15); do
curl -s -o /dev/null -w "%{http_code}\n" -X POST https://example.com/api/auth/login \
-H 'Content-Type: application/json' -d '{"email":"a@b.c","password":"x"}'
doneНа self-hosted з одним процесом після десятого запиту підуть 429. На serverless результат може бути нерівномірним — це демонстрація обмеження.
Коли не варто робити це взагалі
Якщо програма Vercel або за Cloudflare, вбудовані правила WAF дадуть глобальний ліміт без коду і без ілюзії захищеності. In-memory варіант виправданий на одному self-hosted сервері або як додатковий дешевий шар, про слабкість якого команда знає.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.