**这是本文档旧的修订版!**
next 16以上支持 !!!!
原先是中间件,2025年改为代理
CVE-2025-29927(2025 年 3 月,CVSS 9.1):攻击者伪造 x-middleware-subrequest 请求头即可完全跳过 middleware 执行,当时官方通告的原话就是“如果授权检查发生在 middleware 里,就可能被绕过”——已在 12.3.5 / 13.5.9 / 14.2.25 / 15.2.3 修复,但教训保留了下来
因此:proxy 里只做“乐观检查”(optimistic check)——为了体验和性能做的快速拦截,真正的授权必须落在路由处理函数和数据访问层再校验一次
一句话:proxy 是路由层,不是锁。锁要装在门里面(服务端)。
https://nextjs.org/docs/app/api-reference/file-conventions/proxy
一、Proxy 是什么、主要职责
它是位于路由匹配之前执行的单一函数,能对每个进来的请求做四件事:
| 职责 | 典型场景 |
| Redirect(重定向) | 未登录跳 /login、旧 URL 迁移、http→https |
| Rewrite(改写) | A/B 测试分流、按 locale 改写路径、把 /api/* 转发到内部后端地址(对外隐藏真实接口路径) |
| Header/Cookie 操作 | 注入安全头(CSP、X-Frame-Options)、读写 cookie(会话、实验分组) |
| 直接返回响应 | 健康检查、简单限流拦截,不进入后续路由 |
典型代码:
- snippet.javascript
// proxy.ts(项目根目录,或 src/ 下,与 app/ 同级) import { NextRequest, NextResponse } from "next/server"; export function proxy(req: NextRequest) { const session = req.cookies.get("session"); if (!session && req.nextUrl.pathname.startsWith("/admin")) { return NextResponse.redirect(new URL("/login", req.url)); } return NextResponse.next(); // 放行 } export const config = { matcher: ["/admin/:path*"], // 只对匹配的路径生效 };
它还能访问完整的 Node.js API(文件、原生库等),因为新 proxy 只跑 Node.js 运行时,不再支持 Edge runtime,也不允许配置 runtime 选项——设了会直接报错。如果你强依赖 Edge,暂时只能留在旧的 middleware.ts。
问题: 如果代理会被绕过,那么有必要设置代理吗,它的作用是什么呢
它的真正价值:体验和成本,不是安全
- 未登录用户秒跳登录页,省掉一次完整渲染
没有 proxy 时,未登录用户访问 /dashboard,服务端要花几十到几百毫秒渲染页面 → 返回 → 前端再判断跳转。有了 proxy,请求在网络边界就被 307 到 /login,用户几乎无感知,服务器也不用白渲染。这是纯体验收益,和安全无关——攻击者绕过它?他绕过的只是“被礼貌地请出去”这一步,真正的数据他照样拿不到(因为路由和数据库层还有锁)。
- 改写和分流,这是它独有的能力
A/B 测试:按 cookie 把 10% 流量 rewrite 到实验版本
i18n:识别 locale 后静默改写路径
内部转发:把 /api/* 改写到内网真实后端,对外隐藏真实接口地址和端口——这本身就是安全收益,但它发生在“对外暴露面”这个层面
- 统一注入响应头
CSP、X-Frame-Options、HSTS 这些安全头放在 proxy 一层搞定,不用每个路由单独写。这类“加固”本来就不指望它挡定向攻击,而是挡批量扫描、点击劫持这种广谱威胁——攻击者绕过 proxy 直连源站?那前提是源站已经暴露,属于另一层防护该管的事。 4. 减少下游系统的无效压力
把 robots 请求、过期活动页、明显异常的请求在入口处快速处理掉,后端服务少接大量无意义流量。限流在 proxy 层做(比如 x-forwarded-for 计数),挡的是普通脚本小子的批量刷接口——专业攻击者会换 IP、绕 CDN,但这类对手本来就需要数据层和业务层的防御来对付。
二、用个类比理解
把系统想成一栋楼:
proxy 是门口的前台:查一下有没有门禁卡,没卡的请去登记。它能拦住闲逛的路人、送错的外卖、走错楼的访客——处理掉 99% 的日常噪音。
真正的锁在每个房间的门上(路由、数据层)。
前台的象征意义大于安全意义,但你能因此撤掉前台吗?不能——因为前台的存在让楼里每个房间不用各自应付“这人是不是走错了”这种琐事。
三、所以结论是三句话
proxy 管“路由和体验”,不管“授权和机密”——这两件事从来不靠它。
它能被绕过,恰恰说明你的授权本来就不该只放在它里面——绕过者面对的应该是服务端和数据层,而不是长驱直入。
省下的成本是真实的:少渲染、少跳转、少日志噪音、统一治理。就算一个攻击者都拦不住,这些收益也足以让它值得存在。
真正危险的用法只有一种:把 proxy 当成唯一的鉴权点。只要服务端每个受保护操作都在重新校验身份,proxy 被绕过就只是“少了一次礼貌的拦截”,而不是“门户大开”。