Upstash Redis e Edge Config: Rate Limiting e Feature Flags

Upstash Redis e Edge Config: Rate Limiting e Feature Flags

Se o seu sistema cresceu ao ponto de atrair tráfego massivo ou usuários mal-intencionados, você já deve saber que o seu banco de dados principal (PostgreSQL, MySQL) não foi feito para segurar todos os socos.

Quando um exército de bots tenta adivinhar senhas na sua tela de login milhares de vezes por segundo, cada requisição que bate no seu banco de dados custa dinheiro, consome CPU e deixa o sistema mais lento para os seus clientes reais e pagantes.

Para resolver problemas de alta frequência como esse, eu utilizo Bancos de Dados em Memória e configurações distribuídas. Neste artigo técnico, vou mostrar como utilizar duas ferramentas poderosas no ecossistema da Vercel — Upstash Redis (o sucessor do Vercel KV) e Edge Config — para blindar o seu SaaS e controlar funcionalidades em tempo real, antes mesmo da requisição chegar ao seu backend.


1. Redis Serverless (Upstash): O Redis Sem Dor de Cabeça

Tradicionalmente, para implementar cache rápido ou bloqueios temporários, era preciso configurar um servidor Redis (como o AWS ElastiCache). O problema é que manter um servidor Redis rodando 24/7 não é barato e exige manutenção.

A Vercel chegou a oferecer o Vercel KV, um Redis totalmente Serverless. Em dezembro de 2024, o produto foi descontinuado e os bancos existentes migraram para o Upstash Redis, que hoje é instalado pelo Vercel Marketplace em poucos cliques. A ideia continua a mesma: você não gerencia servidores; apenas salva e lê dados muito rápido, pagando pelo que usar. O acesso é feito por HTTP (REST), então funciona bem em ambientes serverless, inclusive no Proxy do Next.js.

Para quem tem código antigo com @vercel/kv, a migração é direta: o pacote @upstash/redis lê as mesmas variáveis de ambiente (KV_REST_API_URL e KV_REST_API_TOKEN) ou as do Upstash (UPSTASH_REDIS_REST_URL e UPSTASH_REDIS_REST_TOKEN).

Mão no Código: Implementando Rate Limiting no Proxy

Rate Limiting é a técnica de limitar quantas requisições um usuário (ou IP) pode fazer em um determinado tempo. Vou construir um Proxy (antigo Middleware) que bloqueia IPs que tentarem fazer mais de 5 requisições por minuto na API de autenticação. Em vez de reinventar o contador na mão, uso o @upstash/ratelimit, que já implementa os algoritmos de janela de forma atômica.

npm install @upstash/redis @upstash/ratelimit
Aviso

Middleware.ts depreciado: No Next.js 16, a convenção middleware.ts foi depreciada (ainda funciona, mas não é mais o caminho recomendado) e renomeada para proxy.ts, que exporta a função proxy(). O Proxy roda no runtime Node.js e não aceita a opção runtime: declarar export const runtime = 'edge' nele gera erro. Os blocos de código abaixo já refletem essa migração.

// src/proxy.ts
import { NextResponse } from 'next/server';
import type { NextFetchEvent, NextRequest } from 'next/server';
import { Ratelimit } from '@upstash/ratelimit';
import { Redis } from '@upstash/redis';

// Criado fora da função para ser reaproveitado entre requisições
const ratelimit = new Ratelimit({
  redis: Redis.fromEnv(),
  // No máximo 5 requisições por IP numa janela deslizante de 60 segundos
  limiter: Ratelimit.slidingWindow(5, '60 s'),
  prefix: 'ratelimit:auth',
});

export async function proxy(request: NextRequest, event: NextFetchEvent) {
  // Pegamos o IP do cliente através dos headers injetados pela Vercel
  const clientIp =
    request.headers.get('x-real-ip') ??
    request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??
    'unknown';

  const { success, limit, remaining, reset, pending } =
    await ratelimit.limit(clientIp);

  // Garante que tarefas em segundo plano da lib terminem após a resposta
  event.waitUntil(pending);

  // Se ultrapassou o limite, bloqueia antes de chegar na rota
  if (!success) {
    console.warn(`[Rate Limit] IP bloqueado: ${clientIp}`);
    return NextResponse.json(
      { error: 'Too Many Requests. Tente em um minuto.' },
      {
        status: 429,
        headers: {
          'X-RateLimit-Limit': limit.toString(),
          'X-RateLimit-Remaining': remaining.toString(),
          'Retry-After': Math.ceil((reset - Date.now()) / 1000).toString(),
        },
      }
    );
  }

  // Fluxo normal permitido
  return NextResponse.next();
}

// Aplicamos a regra de bloqueio apenas nas rotas críticas (ex: login)
export const config = {
  matcher: '/api/auth/:path*',
};

O ponto forte desse código é que o bloqueio acontece no Proxy, antes da requisição chegar à rota de autenticação. O atacante recebe o 429 rapidamente e a requisição nunca toca no seu banco de dados principal. Você economiza recursos de infraestrutura e garante que o sistema continue rápido e escalável.


2. Vercel Edge Config: Feature Flags Globais (Instantâneas)

Para a implementação passo a passo, com o kill switch completo, veja o manual Feature Flags com Vercel Edge Config.

Imagine que você desenvolveu um módulo novo de "Exportação de Relatórios PDF" no seu SaaS, mas ele começou a travar o sistema em horário de pico. O que você faz? No passado, você precisaria abrir o código, comentar a funcionalidade, criar um novo commit, aguardar 5 minutos de deploy e rezar para o sistema não cair enquanto isso.

Hoje, eu uso Edge Config para construir Feature Flags (Bandeiras de Funcionalidade). O Edge Config é um pequeno armazenamento JSON global que é propagado para todos os servidores da Vercel no mundo inteiro quase que instantaneamente, com leituras muito rápidas, pois o dado é replicado perto de onde as suas funções rodam, sem precisar consultar o seu banco de dados.

Mão no Código: Desligando Recursos sem Deploy

Sem precisar fazer um novo deploy, você pode entrar no painel da Vercel (ou usar a API) e alterar um JSON no Edge Config. O código no Next.js lê esse valor com leituras muito rápidas.

// src/app/dashboard/reports/page.tsx
import { get } from '@vercel/edge-config';

// Forçamos a página a renderizar dinamicamente para ler a flag em tempo real
export const dynamic = 'force-dynamic';

export default async function ReportsPage() {
  // Lemos a chave do JSON global no Edge Config
  // Se retornar false, desativamos o botão na hora
  const isPdfExportEnabled = await get<boolean>(
    'feature_pdf_export_enabled'
  );

  return (
    <div className="p-8">
      <h1>Relatórios Financeiros</h1>
      
      {isPdfExportEnabled ? (
        <button className="bg-primary text-white p-4 rounded">
          Gerar Relatório em PDF
        </button>
      ) : (
        <div className="bg-red-900/50 p-4 rounded text-red-200">
          ⚠️ O recurso de Exportação de PDF está temporariamente em manutenção.
        </div>
      )}
    </div>
  );
}

Essa arquitetura permite que CEO e Product Managers liguem e desliguem features diretamente pelo painel, protejam funcionalidades exclusivas para clientes Enterprise e façam lançamentos graduais de novas telas (Canary Releases) sem depender de um engenheiro para reescrever código.


Escalando com Maturidade

Para empresas que tratam seu software com seriedade, ignorar o poder do Redis serverless e do Edge Config é como ter um carro esportivo e andar com o freio de mão puxado. Desafogar o banco de dados principal de tarefas repetitivas e ter o poder de desligar rotas críticas sem novo deploy é a diferença entre uma Black Friday lucrativa e um final de semana apagando incêndios.


Albanir Neves

Albanir Neves

Especialista em Sistemas Sob Medida

Com mais de 12 anos de experiência técnica, ajudo empresas a escalar e digitalizar processos através de sistemas sob medida, automação avançada e integrações B2B com Inteligência Artificial.