SuperAPI AI 工具集

makers-middleware

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:在边缘(V8 运行时)拦截和处理请求,实现重定向、路径重写、鉴权守卫、A/B 测试、请求头注入、基于地理位置的路由以及直接返回 JSON 响应。

主要能力:context 提供 request、next(options?)、redirect(url, status?)、rewrite(url)、geo、clientIp。next 可继续请求并可修改请求头;redirect 默认 307;rewrite 对客户端透明;geo 含 countryName、countryCodeAlpha2、countryCodeAlpha3、regionName、cityName、latitude、longitude、asn。

使用方式:在项目根目录创建 middleware.js,导出 middleware(context) 函数。默认对所有路由生效,可用 export const config = { matcher: [...] } 限定范围,支持单路径、多路径及正则模式。

常见模式:URL 重定向(如 /old-page 转 /new-page,301)、URL 重写(透明代理)、添加请求头(如 x-request-id、x-client-ip、x-country)、鉴权守卫(校验 Authorization 头)、基于国家的路由、A/B 测试(随机重写到不同落地页)、直接返回 JSON 响应。

限制:框架项目(如 Next.js、Nuxt)不要使用本平台中间件格式,应使用框架内置中间件(例如 Next.js 的 middleware.ts 配合 NextRequest/NextResponse);以下模式仅适用于非框架或纯静态项目。其他费用、部署与配额信息暂未提供。