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 и ИИ-агентов под ключ.