路由中间件
Vercel 路由中间件(middleware.ts,Edge/Node/Bun 运行时),在缓存前对请求做地理个性化、A/B、重定向、注入头、轻量鉴权。
功能与用途
Vercel 路由中间件用于在请求命中缓存之前拦截流量,执行基于地理位置的内容重写、A/B 测试分支切流、请求重定向与安全响应头注入。开发者在项目根目录编写 middleware.ts,通过匹配器筛选路径,结合 Edge 或 Node.js 运行时动态改写请求 URL 或响应头。使用该能力需要熟悉 HTTP 协议规则、Next.js 或其他现代前端框架的路由机制,并具备 Vercel 平台的部署与基础配置经验。
适用场景
- 地理位置动态重定向:读取请求中的国家或城市信息,将访客无缝重定向或重写至对应语言区域的静态页面。
- Edge Config A/B 实验分流:结合毫秒级读取的边缘配置,根据实验分组策略将不同用户请求重写到指定的页面变体。
- 全站安全请求头注入:在边缘层统一为响应注入 CSP、CORS 或自定义客户端 IP 标识,减少源站重复逻辑。
适用人群
- 开发者
- 前端
- 全栈
使用步骤
- 建项目根 middleware.ts(默认导出)。
- 按场景写逻辑(地理/A-B/重定向/注入头/轻量鉴权)。
- 选运行时(Edge/Node/Bun)。
- 部署并验证缓存前行为。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Vercel Routing Middleware guidance — request interception before cache, rewrites, redirects, personalization. Works with any framework. Supports Edge, Node.js, and Bun runtimes. Use when intercepting requests at the platform level.
使用前准备
- Vercel 项目
- Next.js/SvelteKit/Astro/Nuxt 等框架
依赖与权限
- 读取用户主动提供的内容