For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/modules/rate-limiting.md (or send Accept: text/markdown).
Limitação de taxa
Um limiter para cada rota sensível a abuso.
Passo a passo para iniciantes
Pré-requisitos: Leia os dois guias para iniciantes abaixo, conclua a configuração local da Web e abra este monorepo na raiz do seu editor. As configurações da Web pertencem a apps/web/.env.local; Next.js não lê a raiz .env. /dashboard no modo falso padrão é uma demonstração sem banco de dados; /auth precisa de um banco de dados migrado.
Termos rápidos: um espaço de trabalho consiste em usuários, dados e configurações separados de uma equipe. O servidor é o back-end confiável; mantenha as chaves do provedor fora do navegador e do código do telefone. Uma migração é uma alteração de versão do banco de dados que cria ou atualiza tabelas. Um modelo de IA é o mecanismo que responde; o catálogo de modelos é a lista do servidor de IDs e preços de modelos disponíveis. Um provedor é um serviço externo, como IA, e-mail ou serviço de cobrança. Um direito é uma concessão que permite que um espaço de trabalho use um recurso. Um webhook é uma mensagem que um serviço envia para o URL de outro serviço.
1. No ambiente do servidor, escolha RATE_LIMIT_STORE=postgres para buckets de produção compartilhados e defina PUBLIC_AI_DAILY_BUDGET_MICROUNITS=0 para manter a IA pública desabilitada.
2. Configure TRUSTED_PROXY_COUNT apenas para o número exato de proxies controlados que acrescentam cabeçalhos de encaminhamento; não copie 1, a menos que isso seja verdade para o seu host.
3. Verifique se uma solicitação negada retorna um erro de repetição segura. Se os limites diferirem entre as instâncias, verifique se eles compartilham Postgres.
Para código personalizado, comece com o prompts/README.md fornecido e copie o prompt mais próximo: prompts/new-app-screen.md para uma tela de aplicativo ou prompts/new-landing-page.md para uma página pública. Para trabalho de servidor, banco de dados ou provedor, dê ao seu agente de codificação a tarefa deste guia e peça-lhe para ler AGENTS.md, .ai/PROJECT_CONTEXT.md e espelhos .ai/ correspondentes; inspecione os arquivos de origem exatos nomeados aqui; listar arquivos e verificações antes de editar; preservar a propriedade do espaço de trabalho e os segredos apenas do servidor; e mostrar a diferença. Informe o comportamento desejado, campos de entrada e saída, funções permitidas, sucessos e erros esperados e a conta de teste, provedor ou dispositivo. Use valores de amostra; nunca cole um segredo real.
Escolha a loja do limitador
RATE_LIMIT_STORE é memória ou postgres. Quando não definido, a produção seleciona Postgres e outros ambientes selecionam memória. As linhas rate_limit_bucket compartilhadas coordenam vários servidores; falhas de armazenamento atualmente falham em abrir para preservar a disponibilidade do API.
Os limites de envio de IA do espaço de trabalho/usuário e o limitador público API/MCP protegem suas superfícies separadas. Preserve as chaves de bucket existentes específicas do chamador ao adicionar rotas.
Confie apenas em saltos de proxy controlados
TRUSTED_PROXY_COUNT varia de 0 a 10 e conta proxies reversos que acrescentam x-forwarded-for. Zero não confia em ninguém e usa um bucket desconhecido compartilhado; um proxy controlado normalmente precisa de 1. Uma contagem incorreta permite que valores encaminhados não confiáveis afetem o limitador.
Limite os gastos anônimos do provedor
PUBLIC_AI_DAILY_BUDGET_MICROUNITS=0 desativa chamadas públicas de IA. Um limite UTC diário não negativo configurado reserva os gastos da plataforma antes das chamadas do provedor e é separado do orçamento de cada espaço de trabalho. Teste reservas simultâneas, redefina limites e negações antes de qualquer tentativa de provedor faturável.
RATE_LIMIT_STORE=postgres
TRUSTED_PROXY_COUNT=1
PUBLIC_AI_DAILY_BUDGET_MICROUNITS=0Instalação e configuração
rate-limit-runtime fornece limiters partilhados ligados às superfícies sensíveis a abuso — apiV1Limiter (600 pedidos/minuto) e authLimiter (300 pedidos/minuto) são os presets enviados. Os limites fazem key em identidade mais bucket de rota e respondem com um 429 repetível com Retry-After em vez de um erro genérico.
Estende o limiter existente a novos endpoints sensíveis a abuso — sign-in, OTP, checkout, submissão de tarefas, criação de chaves — em vez de inventar contadores por rota que divergem.
export const apiV1Limiter = createNamedRateLimiter("api-v1", 600, 60_000);
export const authLimiter = createNamedRateLimiter("auth", 300, 60_000);Fluxo de implementação
Escolhe a key com cuidado: por utilizador para ações autenticadas, por API key para tráfego público, por IP só como último recurso para endpoints anónimos. Bursts legítimos recebem um Retry-After; ataques batem num teto rígido.
Mantém o limiter fail-closed em rotas sensíveis a abuso — se a store estiver inalcançável, prefere rejeitar trabalho caro a deixá-lo passar sem limite.
Verificação e resolução de problemas
Exercita um limiter até devolver 429 com um Retry-After sensato, verifica que workspaces diferentes recebem buckets independentes e confirma que um burst volta ao sucesso depois da janela. Regista recusas sem o payload sensível do pedido.